Alles, was sgcHTTP kann, aufgeschlüsselt nach dem HTTP-Server, 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.
Endpunkte, statische Dateien, Sitzungen, TLS
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. Der HTTP-Server, TsgcHTTPServer, ist Teil dieser Runtime.
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 ist immer in deiner Bestellung enthalten, und der angezeigte sgcHTTP-Preis deckt es bereits ab. Die drei Google-Cloud-Clients sind reines HTTPS und brauchen es nicht.
Drei Komponenten auf der Palettenseite SGC HTTP und drei reine Code-Klassen für Google Cloud. Der HTTP-Server ist in der Unit sgcHTTP_Server der mitgelieferten Core Runtime deklariert, alles andere in der Unit sgcHTTP.
| Komponente | Klasse | Auf der Palette? | Beschreibung |
|---|---|---|---|
| HTTP-Server | TsgcHTTPServer | Ja | HTTP-Server: Anfrage-Ereignisse, statische Dateien aus einem Document Root, Kompression, Keep-Alive, Sitzungen, Uploads, TLS und Authentifizierung. Wird mit der Core Runtime ausgeliefert. |
| 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. |
TsgcHTTPServer veröffentlicht HTTP-Endpunkte und statische Dateien aus deiner eigenen Anwendung. Es ist dieselbe Engine wie der sgcWebSockets-WebSocket-Server, nur ohne den WebSocket-Teil, und er wird mit der mitgelieferten Core Runtime ausgeliefert.
| Fähigkeit | API | Hinweise |
|---|---|---|
| Lauschen | Port, Bindings, Active | Setze den Port oder binde an bestimmte Adressen, und aktiviere dann den Server. |
| Anfragen | OnCommandGet, OnCommandOther | Jede Anfrage erreicht deinen Code mit ihren Request- und Response-Objekten. OnCommandOther deckt Verben wie PUT und DELETE ab. |
| Statische Dateien | DocumentRoot | Liefert statische Dateien aus dem Ordner aus, auf den du es richtest. |
| Kompression | HTTPCompression | Optionen für die Antwortkompression. |
| Verbindungen | KeepAlive, MaxConnections | Hält Verbindungen zwischen Anfragen offen und begrenzt, wie viele gleichzeitig offen sind. |
| Sitzungen | SessionState, AutoStartSession, SessionTimeOut, OnSessionStart, OnSessionEnd | Serverseitige Sitzungen mit Timeout, plus Start- und Ende-Ereignisse. |
| Anfragelimits | MaxRequestBodySize | Begrenzt die Größe eines Request-Bodys. |
| Uploads | HTTPUploadFiles | Speichert hochgeladene Dateien in einem Verzeichnis deiner Wahl. |
| TLS | SSL, SSLOptions | Liefere HTTPS mit deinem eigenen Zertifikat aus. |
| Authentifizierung | Authentication, OnAuthentication | Prüfe Zugangsdaten in deinem eigenen Code, bevor eine Anfrage bedient wird. |
| Threads | ThreadPool, ThreadPoolOptions | Verwendet Worker-Threads aus einem Pool wieder, statt pro Verbindung einen zu erzeugen. |
| Runtime | sgcWebSockets Core | Deklariert in der Unit sgcHTTP_Server der mitgelieferten Core Runtime, auf der Palettenseite SGC HTTP. |
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-Server | HTTP-Anfragen und -Antworten, statische Dateien, Sitzungen und HTTPS über TsgcHTTPServer. |
| 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 und gRPC sind außerdem ab der Enterprise-Edition in sgcWebSockets enthalten, und die Google-Cloud-Clients ab Standard. Der HTTP-Server ist Teil der Core Runtime, daher enthält ihn auch jede sgcWebSockets-Edition. |
| Lizenzierung | Eigenständig. Die sgcWebSockets Core Runtime ist mitgeliefert und der vollständige Quellcode ist enthalten. |