sgcHTTP: HTTP-Server, HTTP/2-, gRPC- & Google-Cloud-Komponenten für Delphi & C++ Builder

TsgcHTTPServer macht aus deiner Delphi- oder C++-Builder-Anwendung einen HTTP-Server. Setze Port, behandle OnCommandGet, setze Active auf true, und jede Anfrage erreicht deinen Code mit ihren Request- und Response-Objekten, während OnCommandOther Verben wie PUT und DELETE abdeckt. Richte DocumentRoot auf einen Ordner, und der Server liefert statische Dateien daraus aus. HTTPCompression komprimiert Antworten, KeepAlive verwendet Verbindungen wieder, SessionState mit OnSessionStart und OnSessionEnd verfolgt Sitzungen, MaxRequestBodySize begrenzt Request-Bodys und HTTPUploadFiles speichert hochgeladene Dateien auf der Festplatte. Für den Produktivbetrieb aktivieren SSL und SSLOptions TLS, Authentication und OnAuthentication schützen deine Endpunkte, und ThreadPool und MaxConnections steuern, wie er skaliert. Es ist dieselbe Engine wie der sgcWebSockets-WebSocket-Server, nur ohne den WebSocket-Teil, und er wird mit der mitgelieferten Core Runtime ausgeliefert.

TsgcHTTPGateway leitet Anfragen, die TsgcHTTPServer oder TsgcWebSocketHTTPServer empfängt, über TCP an FastCGI- und SCGI-Anwendungsserver weiter: PHP über PHP-FPM oder php-cgi -b, und Python-Anwendungen, die von einem SCGI- oder FastCGI-Server bedient werden, zum Beispiel flup. Es übernimmt die Aufgabe von Apache mod_proxy_fcgi und mod_proxy_scgi oder von nginx fastcgi_pass und scgi_pass, sodass kein Apache oder nginx vor deinem Delphi-Server nötig ist. Registriere Handler mit Handlers.Add('*.php', 'fcgi://127.0.0.1:9000') oder Handlers.Add('/app/', 'scgi://127.0.0.1:4000'), zugeordnet nach Erweiterung, Präfix oder exaktem Pfad, und rufe dann Process aus OnCommandGet und OnCommandOther auf. Es liefert true, wenn ein Handler gepasst hat und die Antwort gefüllt ist, und false, wenn dein eigener Code die Anfrage beantwortet. Das Gateway baut die CGI-Umgebung nach RFC 3875 auf, parst die CGI-Antwort mit Status, Weiterleitungen und jedem Set-Cookie-Header und antwortet mit 502, 503 oder 504, wenn ein Backend ausfällt, gemeldet über OnError. Es arbeitet mit der Standard-Indy-Bibliothek, die mit RAD Studio ausgeliefert wird, unter Windows und Linux.

TsgcHTTP2Client spricht HTTP/2 (RFC 9113): Mehrere Anfragen teilen sich eine einzige TCP-Verbindung als unabhängige Streams, eine langsame Antwort blockiert also nicht die anderen dahinter. Header werden mit HPACK komprimiert, und das h2-Protokoll wird während des TLS-Handshakes per ALPN ausgehandelt, weshalb die Komponente auf sgcCustomIndy statt auf der Standard-Indy-Bibliothek aufbaut. Jedes Verb ist abgedeckt, Connect, Get, Post, Put, Patch, Delete und Options, jedes mit einem synchronen Aufruf und einem Async-Gegenstück. Ereignisse machen den Verbindungs-Lebenszyklus sichtbar: OnHTTP2Connect, OnHTTP2Response, OnHTTP2ResponseFragment für chunked Bodies, OnHTTP2PushPromise für Server Push, OnHTTP2GoAway und OnHTTP2Disconnect. HTTP2Options konfiguriert den lokalen Settings-Frame, und TLSOptions sowie Authentication übernehmen aus dem übrigen sgc-HTTP-Stack.

TsgcGRPCClient baut auf dem HTTP/2-Client auf, erbt also die gemultiplexte Verbindung und ergänzt darüber das gRPC-Wire-Format: längenpräfixierte Protocol-Buffers-Nachrichten über HTTP/2-Streams. Call und CallAsync decken Unary-RPCs ab, ServerStreamingCall behandelt einen Antwort-Stream zu einer Anfrage, und OpenClientStream/SendStreamMessage/CloseClientStream plus OpenBidiStream/SendBidiMessage/CloseBidiStream decken Client-Streaming- und bidirektionale Streaming-RPCs ab. OnGRPCResponse, OnGRPCStreamMessage und OnGRPCStreamEnd liefern den Datenverkehr, und RetryPolicy, Interceptors und ServiceConfig ergänzen Retry-Verhalten, übergreifende Logik und Service-Konfiguration, ohne die Aufrufstellen anzufassen. Wie der HTTP/2-Client, auf dem er aufbaut, braucht er sgcCustomIndy für ALPN.

Drei weitere Klassen erreichen Google-Cloud-Dienste über reines HTTPS, authentifiziert mit einem Google-Service-Konto, und keine davon braucht sgcCustomIndy. TsgcHTTPGoogleCloud_PubSub_Client veröffentlicht und holt Nachrichten ab und verwaltet Topics, Subscriptions und Snapshots: Publish, Pull, Acknowledge, CreateTopic, CreateSubscription und der Rest der Pub/Sub-REST-Oberfläche. TsgcHTTPGoogleCloud_Calendar_Client umhüllt die Google Calendar API v3: NewCalendar, NewEvent, LoadEvents und LoadCalendars, mit den Ereignissen OnGetCalendar und OnGetCalendarEvent für die Synchronisierung. TsgcHTTPGoogleCloud_FCM_Client sendet mit einem Aufruf, SendMessage, eine Push-Benachrichtigungs-Payload an ein Firebase-Projekt. Alle drei sind reine Code-Klassen: eine erzeugen, GoogleCloudOptions setzen, die Methoden aufrufen.