Alles wat sgcHTTP doet, uitgesplitst over de HTTP/2-client, de gRPC-client en de drie Google Cloud-clients. Elke mogelijkheid werkt hetzelfde in Delphi en C++ Builder, en elke licentie bevat de volledige broncode. Voor deze launch zijn er nog geen aparte componentpagina's gepubliceerd, elk onderdeel hieronder staat op zichzelf op deze pagina.
Gemultiplexte streams, HPACK, ALPN
Unary & streaming RPC
Pub/Sub, Calendar & FCM
Delphi 7 tot 13, C++ Builder
sgcHTTP is zelfstandig. Het wordt geleverd met de sgcWebSockets Core runtime inbegrepen, dus het is geen add-on.
HTTP/2 en gRPC hebben sgcCustomIndy nodig. Beide klassen vereisen ALPN voor TLS-protocolonderhandeling, wat de standaard Indy-bibliotheek niet ondersteunt, dus ze zijn in plaats daarvan gebouwd op sgcCustomIndy. Dit wordt automatisch aan je bestelling toegevoegd. De drie Google Cloud-clients zijn gewone HTTPS en hebben het niet nodig.
Twee componenten op de paletpagina SGC HTTP, en drie code-only Google Cloud-klassen, allemaal gedeclareerd in de sgcHTTP-unit.
| Component | Klasse | Palet? | Beschrijving |
|---|---|---|---|
| HTTP/2-client | TsgcHTTP2Client | Ja | Native HTTP/2-client: gemultiplexte streams, HPACK-headercompressie, ALPN-onderhandeling. Heeft sgcCustomIndy nodig. |
| gRPC-client | TsgcGRPCClient | Ja | gRPC-client gebouwd op de HTTP/2-client: unary, server-streaming, client-streaming en bidirectionele RPC. Heeft sgcCustomIndy nodig. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | Nee, code-only | Google Cloud Pub/Sub REST API: topics, abonnementen, snapshots, publish en pull. Gewone HTTPS op Core. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | Nee, code-only | Google Calendar API v3: agenda's en events, aanmaken, bijwerken, weergeven, verwijderen. Gewone HTTPS op Core. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | Nee, code-only | Firebase Cloud Messaging HTTP v1 API: verstuur een pushmeldingspayload met één aanroep. Gewone HTTPS op Core. |
TsgcHTTP2Client spreekt HTTP/2 (RFC 9113) over één TLS-verbinding, onderhandeld met ALPN, en dat is waarom het op sgcCustomIndy is gebouwd.
| Mogelijkheid | API | Opmerkingen |
|---|---|---|
| Verbinding | Host, Port, Active | Eén TLS-verbinding draagt elke gemultiplexte requeststream. |
| Verbinden | Connect, ConnectAsync | Opent de verbinding en geeft optioneel meteen een request mee in dezelfde aanroep. |
| Lezen | Get, GetAsync | Synchrone aanroep of fire-and-forget met de response afgeleverd via event. |
| Schrijven | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | Requestbodies zijn streams, dus uploads hoeven niet in het geheugen te passen. |
| Delete & Options | Delete, DeleteAsync, Options, OptionsAsync | De rest van de HTTP-werkwoordenset, dezelfde synchrone/async-koppeling. |
| Responses | OnHTTP2Response | Levert het request- en response-object samen af, inclusief Response.DataString en status. |
| Chunked bodies | OnHTTP2ResponseFragment | Vuurt bij elk fragment van een chunked response, vóór de uiteindelijke OnHTTP2Response. |
| Server push | OnHTTP2PushPromise | Toont door de server gepushte resources zodra ze binnenkomen. |
| Levenscyclus van de verbinding | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | De connect-, disconnect- en stream-reset-signalen die HTTP/2 definieert. |
| Instellingen | HTTP2Options, Settings | De lokale HTTP/2 SETTINGS-framewaarden die naar de peer worden verstuurd. |
| Betrouwbaarheid | WatchDog, HeartBeat, Throttle | Automatisch herverbinden, keep-alive en requestthrottling, gedeeld met de rest van de sgc HTTP-stack. |
| Auth & TLS | Authentication, TLSOptions, OnHTTP2Authorization | Standaard authenticatieschema's en TLS-configuratie, plus een hook voor aangepaste autorisatieheaders. |
| Afhankelijkheid | sgcCustomIndy | ALPN onderhandelt tijdens de TLS-handshake over het h2-protocol; de standaard Indy-bibliotheek kan dit niet. |
TsgcGRPCClient draagt Protocol Buffers-payloads over de gemultiplexte streams van de HTTP/2-client, dus het dekt alle vier de gRPC-aanroepvormen.
| Mogelijkheid | API | Opmerkingen |
|---|---|---|
| Transport | Client | Een TsgcHTTP2Client-instantie; de gRPC-client rijdt erop mee in plaats van een eigen verbinding te openen. |
| Unary RPC | Call, CallAsync, CallString | Eén request, één response. Call blokkeert en geeft een TsgcGRPCResponse terug; CallAsync levert deze via OnGRPCResponse. |
| Server-streaming | ServerStreamingCall | Eén request, een stroom van responses afgeleverd via OnGRPCStreamMessage tot OnGRPCStreamEnd. |
| Client-streaming | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | Een stroom van requests, één laatste response wanneer de stream sluit. |
| Bidirectionele streaming | OpenBidiStream, SendBidiMessage, CloseBidiStream | Beide kanten streamen onafhankelijk over dezelfde aanroep. |
| Annuleren | CancelCall | Annuleert een lopende aanroep via zijn stream-id. |
| Responses | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse draagt StatusCode, Data/DataString, Headers en Trailers. |
| Fouten | OnGRPCError, OnGRPCException | gRPC-statuscodefouten en transportfouten op laag niveau, apart afgeleverd. |
| Metadata | DefaultMetadata, OnGRPCBeforeRequest | Standaard- en per-aanroep gRPC-metadataheaders. |
| Veerkracht | RetryPolicy, Interceptors, ServiceConfig | Retrygedrag, een cross-cutting interceptorketen, en serviceconfiguratie, zonder individuele aanroeppunten aan te raken. |
| Observability | MetricsCollector | Verzamelt aanroepstatistieken voor de client. |
| Afhankelijkheid | sgcCustomIndy | Overgeërfd van de HTTP/2-client waarop het is gebouwd; ALPN is op dezelfde manier vereist. |
Drie code-only klassen, geauthenticeerd met een Google-serviceaccount en bereikt via gewone HTTPS. Geen enkele heeft sgcCustomIndy nodig.
| Mogelijkheid | API | Opmerkingen |
|---|---|---|
| Authenticatie | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | Service-account-JWT: project-id, client-e-mail en private key. Gedeelde vorm bij alle drie de clients. |
| Pub/Sub: publiceren & ophalen | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Verstuur berichten naar een topic, haal op en bevestig vanuit een abonnement. |
| Pub/Sub: topics | CreateTopic, DeleteTopic, GetTopic, ListTopics | Beheer topics rechtstreeks vanuit code. |
| Pub/Sub: abonnementen | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Volledige levenscyclus van abonnementen, inclusief ack-deadline- en push-configwijzigingen. |
| Pub/Sub: snapshots | CreateSnapshot, DeleteSnapshot, ListSnapshots | Leg de bevestigingsstatus van een abonnement vast voor latere replay. |
| Calendar: agenda's | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Pakt de agendalijst van de Google Calendar API v3 in. |
| Calendar: events | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Maak, wijzig en verwijder events op een gegeven agenda. |
| Calendar: synchronisatie | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Incrementele synchronisatiehooks voor agenda's en events die sinds de laatste synchronisatie zijn gewijzigd. |
| FCM: push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. Met één aanroep verstuur je een Firebase Cloud Messaging v1-payload naar een project. |
| TLS en logging | TLSOptions, LogFile | Gedeeld door alle drie de Google Cloud-clients. |
Publieke standaarden op de lijn, en dezelfde broncode voor elke ondersteunde compiler.
| Gebied | Detail |
|---|---|
| HTTP/2 | RFC 9113, met HPACK-headercompressie en ALPN-protocolonderhandeling. |
| gRPC | Protocol Buffers-payloads over HTTP/2-streams, volgens het gRPC-wireprotocol. |
| Google Cloud | De Pub/Sub REST API, de Google Calendar API v3, en de Firebase Cloud Messaging HTTP v1 API, allemaal geauthenticeerd met een Google-serviceaccount. |
| Platforms | Windows Win32, Windows Win64, Linux64, macOS, iOS en Android voor alle vijf klassen. |
| Afhankelijkheid | De HTTP/2- en gRPC-clients hebben sgcCustomIndy nodig voor ALPN. De Google Cloud-clients hebben alleen de meegeleverde Core runtime nodig. |
| Compilers | Delphi en C++ Builder 7 tot en met 13. |
| Edities | HTTP/2 zit ook in sgcWebSockets vanaf Professional, gRPC vanaf Enterprise, en de Google Cloud-clients vanaf Standard. |
| Licenties | Standalone. De sgcWebSockets Core runtime is meegeleverd en de volledige broncode is inbegrepen. |