sgcHTTP: HTTP-server, HTTP/2-, gRPC- en Google Cloud-componenten voor Delphi & C++ Builder

TsgcHTTPServer verandert je Delphi- of C++ Builder-applicatie in een HTTP-server. Stel Port in, verwerk OnCommandGet, zet Active op true, en elk request bereikt je code met zijn request- en response-objecten, terwijl OnCommandOther methoden zoals PUT en DELETE afdekt. Wijs DocumentRoot naar een map en de server levert er statische bestanden uit. HTTPCompression comprimeert responses, KeepAlive hergebruikt verbindingen, SessionState met OnSessionStart en OnSessionEnd houdt sessies bij, MaxRequestBodySize begrenst de grootte van request-bodies en HTTPUploadFiles slaat geüploade bestanden op schijf op. Voor productie schakelen SSL en SSLOptions TLS in, beveiligen Authentication en OnAuthentication je endpoints, en bepalen ThreadPool en MaxConnections hoe hij schaalt. Het is dezelfde engine als de sgcWebSockets WebSocket-server zonder het WebSocket-gedeelte, en hij wordt geleverd met de meegeleverde Core runtime.

TsgcHTTPGateway stuurt requests die TsgcHTTPServer of TsgcWebSocketHTTPServer ontvangt door naar FastCGI- en SCGI-applicatieservers via TCP: PHP via PHP-FPM of php-cgi -b, en Python-applicaties die door een SCGI- of FastCGI-server zoals flup worden aangeboden. Ze doet het werk van Apache mod_proxy_fcgi en mod_proxy_scgi of nginx fastcgi_pass en scgi_pass, dus er staat geen Apache of nginx voor je Delphi-server. Registreer handlers met Handlers.Add('*.php', 'fcgi://127.0.0.1:9000') of Handlers.Add('/app/', 'scgi://127.0.0.1:4000'), gekoppeld op extensie, prefix of exact pad, en roep daarna Process aan vanuit OnCommandGet en OnCommandOther. Ze geeft true terug wanneer een handler overeenkomt en het antwoord is gevuld, en false wanneer je eigen code het request beantwoordt. De gateway bouwt de CGI-omgeving volgens RFC 3875, parseert het CGI-antwoord met status, redirects en elke Set-Cookie-header, en antwoordt met 502, 503 of 504 wanneer een backend faalt, gemeld via OnError. Ze werkt met de standaard Indy die met RAD Studio wordt geleverd, op Windows en Linux.

TsgcHTTP2Client spreekt HTTP/2 (RFC 9113): meerdere requests delen één TCP-verbinding als onafhankelijke streams, zodat één trage response de andere niet blokkeert. Headers worden gecomprimeerd met HPACK, en het h2-protocol wordt tijdens de TLS-handshake onderhandeld via ALPN, de reden waarom het component op sgcCustomIndy is gebouwd in plaats van op de standaard Indy-bibliotheek. Elk werkwoord is gedekt, Connect, Get, Post, Put, Patch, Delete en Options, elk met een synchrone aanroep en een Async-tegenhanger. Events tonen de levenscyclus van de verbinding: OnHTTP2Connect, OnHTTP2Response, OnHTTP2ResponseFragment voor chunked bodies, OnHTTP2PushPromise voor server push, OnHTTP2GoAway en OnHTTP2Disconnect. HTTP2Options configureert het lokale settings-frame, en TLSOptions en Authentication komen over uit de rest van de sgc HTTP-stack.

TsgcGRPCClient is gebouwd op de HTTP/2-client, dus het erft de gemultiplexte verbinding en voegt daar het gRPC-wireformaat aan toe: Protocol Buffers-berichten met lengtevoorvoegsel over HTTP/2-streams. Call en CallAsync dekken unary RPC's, ServerStreamingCall behandelt een stroom van responses op één request, en OpenClientStream/SendStreamMessage/CloseClientStream plus OpenBidiStream/SendBidiMessage/CloseBidiStream dekken client-streaming en bidirectionele streaming RPC's. OnGRPCResponse, OnGRPCStreamMessage en OnGRPCStreamEnd leveren het verkeer af, en RetryPolicy, Interceptors en ServiceConfig voegen retrygedrag, cross-cutting logica en serviceconfiguratie toe zonder de aanroeppunten aan te raken. Net als de HTTP/2-client waarop het is gebouwd, heeft het sgcCustomIndy nodig voor ALPN.

Drie andere klassen bereiken Google Cloud-diensten via gewone HTTPS, geauthenticeerd met een Google-serviceaccount, en geen enkele heeft sgcCustomIndy nodig. TsgcHTTPGoogleCloud_PubSub_Client publiceert en haalt berichten op en beheert topics, abonnementen en snapshots: Publish, Pull, Acknowledge, CreateTopic, CreateSubscription en de rest van het Pub/Sub REST-oppervlak. TsgcHTTPGoogleCloud_Calendar_Client pakt de Google Calendar API v3 in: NewCalendar, NewEvent, LoadEvents en LoadCalendars, met OnGetCalendar- en OnGetCalendarEvent-events voor synchronisatie. TsgcHTTPGoogleCloud_FCM_Client verstuurt met één aanroep, SendMessage, een pushmeldingspayload naar een Firebase-project. Alle drie zijn code-only klassen: maak er een aan, stel GoogleCloudOptions in, roep de methoden aan.