Alles, was sgcHTTP kann, aufgeschlüsselt nach dem HTTP/2-Client, dem gRPC-Client und den drei Google-Cloud-Clients. Jede Fähigkeit arbeitet in Delphi und C++ Builder identisch, und jede Lizenz enthält den vollständigen Quellcode. Für diesen Launch sind noch keine Komponenten-Unterseiten veröffentlicht, jeder Eintrag unten ist auf dieser Seite in sich abgeschlossen.
Gemultiplexte Streams, HPACK, ALPN
Unary- & Streaming-RPC
Pub/Sub, Calendar & FCM
Delphi 7 bis 13, C++ Builder
sgcHTTP ist in sich geschlossen. Es bringt die sgcWebSockets Core Runtime mit, es ist also kein Add-on.
HTTP/2 und gRPC brauchen sgcCustomIndy. Beide Klassen brauchen ALPN für die TLS-Protokollaushandlung, was die Standard-Indy-Bibliothek nicht unterstützt, sie bauen also stattdessen auf sgcCustomIndy auf. Es wird deiner Bestellung automatisch hinzugefügt. Die drei Google-Cloud-Clients sind reines HTTPS und brauchen es nicht.
Zwei Komponenten auf der Palettenseite SGC HTTP, und drei reine Code-Klassen für Google Cloud, alle in der Unit sgcHTTP deklariert.
| Komponente | Klasse | Auf der Palette? | Beschreibung |
|---|---|---|---|
| HTTP/2 Client | TsgcHTTP2Client | Ja | Nativer HTTP/2-Client: gemultiplexte Streams, HPACK-Header-Kompression, ALPN-Aushandlung. Braucht sgcCustomIndy. |
| gRPC Client | TsgcGRPCClient | Ja | gRPC-Client, aufgebaut auf dem HTTP/2-Client: Unary-, Server-Streaming-, Client-Streaming- und bidirektionale RPC. Braucht sgcCustomIndy. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | Nein, reine Code-Klasse | Google Cloud Pub/Sub REST API: Topics, Subscriptions, Snapshots, Publish und Pull. Reines HTTPS auf Core. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | Nein, reine Code-Klasse | Google Calendar API v3: Kalender und Ereignisse, erstellen, aktualisieren, auflisten, löschen. Reines HTTPS auf Core. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | Nein, reine Code-Klasse | Firebase Cloud Messaging HTTP v1 API: eine Push-Benachrichtigungs-Payload mit einem Aufruf senden. Reines HTTPS auf Core. |
TsgcHTTP2Client spricht HTTP/2 (RFC 9113) über eine einzige TLS-Verbindung, ausgehandelt per ALPN, weshalb es auf sgcCustomIndy aufbaut.
| Fähigkeit | API | Hinweise |
|---|---|---|
| Verbindung | Host, Port, Active | Eine TLS-Verbindung trägt jeden gemultiplexten Anfrage-Stream. |
| Verbinden | Connect, ConnectAsync | Öffnet die Verbindung und stellt im selben Aufruf optional eine Anfrage. |
| Lesen | Get, GetAsync | Synchroner Aufruf oder Fire-and-Forget mit der Antwort per Ereignis. |
| Schreiben | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | Anfrage-Bodys sind Streams, Uploads müssen also nicht in den Speicher passen. |
| Delete & Options | Delete, DeleteAsync, Options, OptionsAsync | Der Rest der HTTP-Verb-Menge, dieselbe synchrone/asynchrone Paarung. |
| Antworten | OnHTTP2Response | Liefert das Anfrage- und das Antwortobjekt zusammen, einschließlich Response.DataString und Status. |
| Chunked Bodies | OnHTTP2ResponseFragment | Feuert bei jedem Fragment einer chunked Antwort, noch vor dem abschließenden OnHTTP2Response. |
| Server Push | OnHTTP2PushPromise | Macht per HTTP/2 vom Server gepushte Ressourcen sichtbar, sobald sie eintreffen. |
| Verbindungs-Lebenszyklus | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | Die Connect-, Disconnect- und Stream-Reset-Signale, die HTTP/2 definiert. |
| Settings | HTTP2Options, Settings | Die lokalen HTTP/2-SETTINGS-Frame-Werte, die an die Gegenstelle gesendet werden. |
| Zuverlässigkeit | WatchDog, HeartBeat, Throttle | Auto-Reconnect, Keep-Alive und Anfrage-Drosselung, geteilt mit dem übrigen sgc-HTTP-Stack. |
| Auth & TLS | Authentication, TLSOptions, OnHTTP2Authorization | Gängige Authentifizierungsschemata und TLS-Konfiguration, dazu ein Hook für benutzerdefinierte Authorization-Header. |
| Abhängigkeit | sgcCustomIndy | ALPN handelt das h2-Protokoll während des TLS-Handshakes aus; die Standard-Indy-Bibliothek kann das nicht. |
TsgcGRPCClient trägt Protocol-Buffers-Payloads über die gemultiplexten Streams des HTTP/2-Clients, es deckt also alle vier gRPC-Aufrufformen ab.
| Fähigkeit | API | Hinweise |
|---|---|---|
| Transport | Client | Eine TsgcHTTP2Client-Instanz; der gRPC-Client reitet darauf, statt eine eigene Verbindung zu öffnen. |
| Unary-RPC | Call, CallAsync, CallString | Eine Anfrage, eine Antwort. Call blockiert und liefert eine TsgcGRPCResponse; CallAsync liefert sie über OnGRPCResponse. |
| Server-Streaming | ServerStreamingCall | Eine Anfrage, ein Antwort-Stream, geliefert über OnGRPCStreamMessage bis OnGRPCStreamEnd. |
| Client-Streaming | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | Ein Anfrage-Stream, eine finale Antwort, wenn der Stream schließt. |
| Bidirektionales Streaming | OpenBidiStream, SendBidiMessage, CloseBidiStream | Beide Seiten streamen unabhängig über denselben Aufruf. |
| Abbruch | CancelCall | Bricht einen laufenden Aufruf über seine Stream-ID ab. |
| Antworten | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse trägt StatusCode, Data/DataString, Headers und Trailers. |
| Fehler | OnGRPCError, OnGRPCException | gRPC-Statuscode-Fehler und Transport-Ebene-Exceptions, getrennt geliefert. |
| Metadaten | DefaultMetadata, OnGRPCBeforeRequest | Aufruf- und Standard-gRPC-Metadaten-Header. |
| Resilienz | RetryPolicy, Interceptors, ServiceConfig | Retry-Verhalten, eine übergreifende Interceptor-Kette und Service-Konfiguration, ohne einzelne Aufrufstellen anzufassen. |
| Observability | MetricsCollector | Sammelt Aufruf-Metriken für den Client. |
| Abhängigkeit | sgcCustomIndy | Vom HTTP/2-Client geerbt, auf dem er aufbaut; ALPN wird auf dieselbe Weise benötigt. |
Drei reine Code-Klassen, authentifiziert mit einem Google-Service-Konto und über reines HTTPS erreicht. Keine davon braucht sgcCustomIndy.
| Fähigkeit | API | Hinweise |
|---|---|---|
| Authentifizierung | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | Service-Konto-JWT: Projekt-ID, Client-E-Mail und privater Schlüssel. Dieselbe Form über alle drei Clients hinweg. |
| Pub/Sub: Publish & Pull | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Sende Nachrichten an ein Topic, hole ab und bestätige von einer Subscription. |
| Pub/Sub: Topics | CreateTopic, DeleteTopic, GetTopic, ListTopics | Verwalte Topics direkt aus dem Code. |
| Pub/Sub: Subscriptions | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Vollständiger Subscription-Lebenszyklus, einschließlich Ack-Deadline- und Push-Config-Änderungen. |
| Pub/Sub: Snapshots | CreateSnapshot, DeleteSnapshot, ListSnapshots | Erstelle einen Snapshot des Bestätigungsstatus einer Subscription für spätere Wiederholung. |
| Calendar: Kalender | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Umhüllt die Kalenderliste der Google Calendar API v3. |
| Calendar: Ereignisse | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Erstelle, ändere und entferne Ereignisse in einem gegebenen Kalender. |
| Calendar: Synchronisierung | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Inkrementelle Synchronisierungs-Hooks für Kalender und Ereignisse, die sich seit der letzten Synchronisierung geändert haben. |
| FCM: Push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. Ein Aufruf sendet eine Firebase-Cloud-Messaging-v1-Payload an ein Projekt. |
| TLS und Logging | TLSOptions, LogFile | Geteilt über alle drei Google-Cloud-Clients. |
Öffentliche Standards auf der Leitung, und derselbe Quellcode über jeden unterstützten Compiler hinweg.
| Bereich | Detail |
|---|---|
| HTTP/2 | RFC 9113, mit HPACK-Header-Kompression und ALPN-Protokollaushandlung. |
| gRPC | Protocol-Buffers-Payloads über HTTP/2-Streams, gemäß dem gRPC-Wire-Protokoll. |
| Google Cloud | Die Pub/Sub-REST-API, die Google Calendar API v3 und die Firebase Cloud Messaging HTTP v1 API, alle authentifiziert mit einem Google-Service-Konto. |
| Plattformen | Windows Win32, Windows Win64, Linux64, macOS, iOS und Android für alle fünf Klassen. |
| Abhängigkeit | Der HTTP/2- und der gRPC-Client brauchen sgcCustomIndy für ALPN. Die Google-Cloud-Clients brauchen nur die mitgelieferte Core Runtime. |
| Compiler | Delphi und C++ Builder 7 bis 13. |
| Editionen | HTTP/2 ist außerdem ab der Professional-Edition in sgcWebSockets enthalten, gRPC ab Enterprise, und die Google-Cloud-Clients ab Standard. |
| Lizenzierung | Eigenständig. Die sgcWebSockets Core Runtime ist mitgeliefert und der vollständige Quellcode ist enthalten. |