Wszystko, co robi sgcHTTP, rozpisane na klienta HTTP/2, klienta gRPC oraz trzy klienty Google Cloud. Każda funkcja działa tak samo w Delphi i C++ Builder, a każda licencja zawiera pełny kod źródłowy. Podstrony komponentów nie są jeszcze opublikowane przy tej premierze, każdy wpis poniżej jest samodzielny na tej stronie.
Multipleksowane strumienie, HPACK, ALPN
RPC unarne i strumieniowe
Pub/Sub, Calendar i FCM
Delphi od 7 do 13, C++ Builder
sgcHTTP jest samowystarczalny. Jest dostarczany z dołączonym środowiskiem uruchomieniowym sgcWebSockets Core, więc nie jest dodatkiem.
HTTP/2 i gRPC potrzebują sgcCustomIndy. Obie klasy wymagają ALPN do negocjacji protokołu TLS, czego standardowa biblioteka Indy nie obsługuje, więc są zamiast tego zbudowane na sgcCustomIndy. Jest on dodawany do twojego zamówienia automatycznie. Trzy klienty Google Cloud to zwykłe HTTPS i go nie potrzebują.
Dwa komponenty na stronie palety SGC HTTP oraz trzy klasy Google Cloud dostępne wyłącznie z kodu, wszystkie zadeklarowane w module sgcHTTP.
| Komponent | Klasa | Paleta? | Opis |
|---|---|---|---|
| Klient HTTP/2 | TsgcHTTP2Client | Tak | Natywny klient HTTP/2: multipleksowane strumienie, kompresja nagłówków HPACK, negocjacja ALPN. Wymaga sgcCustomIndy. |
| Klient gRPC | TsgcGRPCClient | Tak | Klient gRPC zbudowany na kliencie HTTP/2: RPC unarne, strumieniowane po stronie serwera, po stronie klienta i dwukierunkowe. Wymaga sgcCustomIndy. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | Nie, tylko kod | API REST Google Cloud Pub/Sub: tematy, subskrypcje, migawki, publikowanie i pobieranie. Zwykłe HTTPS na Core. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | Nie, tylko kod | Google Calendar API v3: kalendarze i wydarzenia, tworzenie, aktualizacja, listowanie, usuwanie. Zwykłe HTTPS na Core. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | Nie, tylko kod | Firebase Cloud Messaging HTTP v1 API: wyślij ładunek powiadomienia push jednym wywołaniem. Zwykłe HTTPS na Core. |
TsgcHTTP2Client mówi w HTTP/2 (RFC 9113) przez jedno połączenie TLS, negocjowane przez ALPN, dlatego jest zbudowany na sgcCustomIndy.
| Możliwość | API | Uwagi |
|---|---|---|
| Połączenie | Host, Port, Active | Jedno połączenie TLS przenosi każdy multipleksowany strumień żądań. |
| Nawiązanie połączenia | Connect, ConnectAsync | Otwiera połączenie i opcjonalnie wysyła żądanie w tym samym wywołaniu. |
| Odczyt | Get, GetAsync | Wywołanie synchroniczne albo fire-and-forget z odpowiedzią dostarczaną przez zdarzenie. |
| Zapis | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | Treści żądań to strumienie, więc przesyłane dane nie muszą mieścić się w pamięci. |
| Delete i Options | Delete, DeleteAsync, Options, OptionsAsync | Reszta zestawu czasowników HTTP, ten sam schemat synchroniczny/asynchroniczny. |
| Odpowiedzi | OnHTTP2Response | Dostarcza obiekty żądania i odpowiedzi razem, w tym Response.DataString i status. |
| Treści fragmentowane (chunked) | OnHTTP2ResponseFragment | Uruchamia się przy nadejściu każdego fragmentu odpowiedzi typu chunked, przed finalnym OnHTTP2Response. |
| Server push | OnHTTP2PushPromise | Ujawnia zasoby wypychane przez serwer HTTP/2 (server push) w miarę ich nadejścia. |
| Cykl życia połączenia | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | Sygnały połączenia, rozłączenia i resetu strumienia zdefiniowane przez HTTP/2. |
| Ustawienia | HTTP2Options, Settings | Wartości lokalnej ramki SETTINGS protokołu HTTP/2 wysyłane do peera. |
| Niezawodność | WatchDog, HeartBeat, Throttle | Automatyczne ponowne łączenie, keep-alive i ograniczanie liczby żądań, wspólne z resztą stosu sgc HTTP. |
| Uwierzytelnianie i TLS | Authentication, TLSOptions, OnHTTP2Authorization | Standardowe schematy uwierzytelniania i konfiguracja TLS, a także hak do niestandardowych nagłówków autoryzacji. |
| Zależność | sgcCustomIndy | ALPN negocjuje protokół h2 podczas uzgadniania TLS; standardowa biblioteka Indy nie potrafi tego zrobić. |
TsgcGRPCClient przenosi ładunki Protocol Buffers przez multipleksowane strumienie klienta HTTP/2, dzięki czemu obejmuje wszystkie cztery kształty wywołań gRPC.
| Możliwość | API | Uwagi |
|---|---|---|
| Transport | Client | Instancja TsgcHTTP2Client; klient gRPC jeździ na niej, zamiast otwierać własne połączenie. |
| RPC unarne | Call, CallAsync, CallString | Jedno żądanie, jedna odpowiedź. Call blokuje i zwraca TsgcGRPCResponse; CallAsync dostarcza ją przez OnGRPCResponse. |
| Strumieniowanie po stronie serwera | ServerStreamingCall | Jedno żądanie, strumień odpowiedzi dostarczanych przez OnGRPCStreamMessage aż do OnGRPCStreamEnd. |
| Strumieniowanie po stronie klienta | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | Strumień żądań, jedna ostateczna odpowiedź po zamknięciu strumienia. |
| Strumieniowanie dwukierunkowe | OpenBidiStream, SendBidiMessage, CloseBidiStream | Obie strony strumieniują niezależnie w ramach tego samego wywołania. |
| Anulowanie | CancelCall | Anuluje trwające wywołanie po identyfikatorze jego strumienia. |
| Odpowiedzi | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse niesie StatusCode, Data/DataString, Headers i Trailers. |
| Błędy | OnGRPCError, OnGRPCException | Błędy kodu statusu gRPC i wyjątki na poziomie transportu, dostarczane osobno. |
| Metadane | DefaultMetadata, OnGRPCBeforeRequest | Nagłówki metadanych gRPC, domyślne i dla poszczególnych wywołań. |
| Odporność | RetryPolicy, Interceptors, ServiceConfig | Zachowanie ponawiania, przekrojowy łańcuch przechwytywaczy (interceptorów) i konfiguracja usługi, bez dotykania poszczególnych miejsc wywołań. |
| Obserwowalność | MetricsCollector | Zbiera metryki wywołań dla klienta. |
| Zależność | sgcCustomIndy | Odziedziczona po kliencie HTTP/2, na którym jest zbudowany; ALPN jest wymagany w ten sam sposób. |
Trzy klasy dostępne wyłącznie z kodu, uwierzytelniane kontem usługi Google i osiągane przez zwykłe HTTPS. Żadna z nich nie potrzebuje sgcCustomIndy.
| Możliwość | API | Uwagi |
|---|---|---|
| Uwierzytelnianie | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | JWT konta usługi: identyfikator projektu, adres e-mail klienta i klucz prywatny. Wspólny kształt dla wszystkich trzech klientów. |
| Pub/Sub: publikowanie i pobieranie | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Wysyłaj wiadomości do tematu, pobieraj i potwierdzaj z subskrypcji. |
| Pub/Sub: tematy | CreateTopic, DeleteTopic, GetTopic, ListTopics | Zarządzaj tematami bezpośrednio z kodu. |
| Pub/Sub: subskrypcje | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Pełny cykl życia subskrypcji, w tym zmiany terminu potwierdzenia i konfiguracji push. |
| Pub/Sub: migawki | CreateSnapshot, DeleteSnapshot, ListSnapshots | Zrób migawkę stanu potwierdzeń subskrypcji do późniejszego odtworzenia. |
| Calendar: kalendarze | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Opakowuje listę kalendarzy Google Calendar API v3. |
| Calendar: wydarzenia | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Twórz, zmieniaj i usuwaj wydarzenia w danym kalendarzu. |
| Calendar: synchronizacja | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Haki synchronizacji przyrostowej dla kalendarzy i wydarzeń zmienionych od ostatniej synchronizacji. |
| FCM: push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. Jedno wywołanie wysyła ładunek Firebase Cloud Messaging v1 do projektu. |
| TLS i logowanie | TLSOptions, LogFile | Wspólne dla wszystkich trzech klientów Google Cloud. |
Oficjalne standardy na łączu i te same źródła we wszystkich obsługiwanych kompilatorach.
| Obszar | Szczegóły |
|---|---|
| HTTP/2 | RFC 9113, z kompresją nagłówków HPACK i negocjacją protokołu ALPN. |
| gRPC | Ładunki Protocol Buffers przesyłane strumieniami HTTP/2, zgodnie z protokołem transmisji gRPC. |
| Google Cloud | API REST Pub/Sub, Google Calendar API v3 oraz Firebase Cloud Messaging HTTP v1 API, wszystkie uwierzytelniane kontem usługi Google. |
| Platformy | Windows Win32, Windows Win64, Linux64, macOS, iOS i Android dla wszystkich pięciu klas. |
| Zależność | Klient HTTP/2 i klient gRPC potrzebują sgcCustomIndy dla ALPN. Klienty Google Cloud potrzebują tylko dołączonego środowiska uruchomieniowego Core. |
| Kompilatory | Delphi i C++ Builder od 7 do 13. |
| Edycje | HTTP/2 jest dostarczany także wewnątrz sgcWebSockets od edycji Professional wzwyż, gRPC od edycji Enterprise wzwyż, a klienty Google Cloud od edycji Standard wzwyż. |
| Licencjonowanie | Produkt samodzielny. Środowisko uruchomieniowe sgcWebSockets Core jest dołączone, a pełny kod źródłowy jest w zestawie. |