sgcHTTP: componentes de servidor HTTP, HTTP/2, gRPC e Google Cloud para Delphi e C++ Builder

O TsgcHTTPServer transforma a sua aplicação Delphi ou C++ Builder em um servidor HTTP. Defina Port, trate OnCommandGet, defina Active como true, e cada requisição chega ao seu código com os seus objetos de requisição e resposta, enquanto o OnCommandOther cobre verbos como PUT e DELETE. Aponte DocumentRoot para uma pasta e o servidor devolve arquivos estáticos a partir dela. O HTTPCompression comprime as respostas, o KeepAlive reaproveita conexões, o SessionState com OnSessionStart e OnSessionEnd acompanha as sessões, o MaxRequestBodySize limita o tamanho dos corpos das requisições e o HTTPUploadFiles grava em disco os arquivos enviados. Para produção, SSL e SSLOptions ativam o TLS, Authentication e OnAuthentication protegem os seus endpoints, e ThreadPool e MaxConnections controlam como ele escala. É o mesmo motor do servidor WebSocket do sgcWebSockets, sem a parte WebSocket, e vem com o runtime Core embutido.

O TsgcHTTPGateway encaminha as requisições recebidas pelo TsgcHTTPServer ou pelo TsgcWebSocketHTTPServer para servidores de aplicação FastCGI e SCGI via TCP: PHP por meio do PHP-FPM ou do php-cgi -b, e aplicações Python servidas por um servidor SCGI ou FastCGI como o flup. Ele faz o trabalho do mod_proxy_fcgi e do mod_proxy_scgi do Apache ou do fastcgi_pass e do scgi_pass do nginx, então não há Apache nem nginx na frente do seu servidor Delphi. Registre handlers com Handlers.Add('*.php', 'fcgi://127.0.0.1:9000') ou Handlers.Add('/app/', 'scgi://127.0.0.1:4000'), correspondidos por extensão, prefixo ou caminho exato, e depois chame Process a partir de OnCommandGet e OnCommandOther. Ele retorna true quando um handler correspondeu e a resposta está preenchida, e false quando o seu próprio código responde à requisição. O gateway monta o ambiente CGI da RFC 3875, interpreta a resposta CGI com o status, os redirecionamentos e todos os cabeçalhos Set-Cookie, e responde 502, 503 ou 504 quando um backend falha, informado por meio de OnError. Funciona com o Indy padrão que acompanha o RAD Studio, no Windows e no Linux.

O TsgcHTTP2Client fala HTTP/2 (RFC 9113): múltiplas requisições compartilham uma única conexão TCP como streams independentes, então uma resposta lenta não bloqueia as outras atrás dela. Os cabeçalhos são comprimidos com HPACK, e o protocolo h2 é negociado durante o handshake TLS via ALPN, a razão pela qual o componente é construído sobre o sgcCustomIndy em vez da biblioteca Indy padrão. Todo verbo é coberto, Connect, Get, Post, Put, Patch, Delete e Options, cada um com uma chamada síncrona e uma gêmea Async. Eventos expõem o ciclo de vida da conexão: OnHTTP2Connect, OnHTTP2Response, OnHTTP2ResponseFragment para corpos em chunks, OnHTTP2PushPromise para server push, OnHTTP2GoAway e OnHTTP2Disconnect. HTTP2Options configura o frame de settings local, e TLSOptions e Authentication vêm do restante da pilha HTTP do sgc.

O TsgcGRPCClient é construído sobre o cliente HTTP/2, então herda a conexão multiplexada e adiciona o formato de wire do gRPC por cima: mensagens Protocol Buffers com prefixo de tamanho sobre streams HTTP/2. Call e CallAsync cobrem RPCs unários, ServerStreamingCall lida com um stream de respostas para uma requisição, e OpenClientStream/SendStreamMessage/CloseClientStream mais OpenBidiStream/SendBidiMessage/CloseBidiStream cobrem RPCs de client-streaming e bidirectional-streaming. OnGRPCResponse, OnGRPCStreamMessage e OnGRPCStreamEnd entregam o tráfego, e RetryPolicy, Interceptors e ServiceConfig adicionam comportamento de retry, lógica transversal e configuração de serviço sem tocar nos pontos de chamada. Assim como o cliente HTTP/2 sobre o qual é construído, ele precisa do sgcCustomIndy para o ALPN.

Mais três classes alcançam serviços Google Cloud sobre HTTPS puro, autenticadas com uma conta de serviço Google, e nenhuma delas precisa do sgcCustomIndy. O TsgcHTTPGoogleCloud_PubSub_Client publica e lê mensagens e gerencia tópicos, assinaturas e snapshots: Publish, Pull, Acknowledge, CreateTopic, CreateSubscription e o resto da superfície REST do Pub/Sub. O TsgcHTTPGoogleCloud_Calendar_Client encapsula a Google Calendar API v3: NewCalendar, NewEvent, LoadEvents e LoadCalendars, com os eventos OnGetCalendar e OnGetCalendarEvent para sincronização. O TsgcHTTPGoogleCloud_FCM_Client envia um payload de notificação push para um projeto Firebase com uma única chamada, SendMessage. As três são classes apenas de código: crie uma, defina GoogleCloudOptions, chame os métodos.