Tudo o que o sgcHTTP faz, mapeado no servidor HTTP, no cliente HTTP/2, no cliente gRPC e nos três clientes Google Cloud. Todo recurso funciona igual no Delphi e no C++ Builder, e toda licença entrega o código-fonte completo. As subpáginas de componente ainda não foram publicadas para este lançamento, cada item abaixo é autocontido nesta página.
Endpoints, arquivos estáticos, sessões, TLS
Streams multiplexados, HPACK, ALPN
RPC unário & em streaming
Pub/Sub, Calendar & FCM
Delphi 7 a 13, C++ Builder
O sgcHTTP é autossuficiente. Ele já vem com o runtime sgcWebSockets Core embutido, então não é um complemento. O servidor HTTP, TsgcHTTPServer, faz parte desse runtime.
HTTP/2 e gRPC precisam do sgcCustomIndy. As duas classes exigem ALPN para a negociação de protocolo TLS, o que a biblioteca Indy padrão não suporta, então são construídas sobre o sgcCustomIndy em vez disso. Ele sempre está incluído no seu pedido, e o preço do sgcHTTP exibido já o cobre. Os três clientes Google Cloud são HTTPS puro e não precisam dele.
Três componentes na página de paleta SGC HTTP e três classes apenas de código do Google Cloud. O servidor HTTP é declarado na unit sgcHTTP_Server do runtime Core incluído, e todo o resto na unit sgcHTTP.
| Componente | Classe | Na paleta? | Descrição |
|---|---|---|---|
| Servidor HTTP | TsgcHTTPServer | Sim | Servidor HTTP: eventos de requisição, arquivos estáticos a partir de uma pasta raiz de documentos, compressão, keep-alive, sessões, uploads, TLS e autenticação. Vem com o runtime Core. |
| Cliente HTTP/2 | TsgcHTTP2Client | Sim | Cliente HTTP/2 nativo: streams multiplexados, compressão de cabeçalhos HPACK, negociação ALPN. Precisa do sgcCustomIndy. |
| Cliente gRPC | TsgcGRPCClient | Sim | Cliente gRPC construído sobre o cliente HTTP/2: RPC unário, server-streaming, client-streaming e bidirecional. Precisa do sgcCustomIndy. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | Não, apenas código | API REST do Google Cloud Pub/Sub: tópicos, assinaturas, snapshots, publicação e leitura. HTTPS puro sobre o Core. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | Não, apenas código | Google Calendar API v3: calendários e eventos, criar, atualizar, listar, excluir. HTTPS puro sobre o Core. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | Não, apenas código | API HTTP v1 do Firebase Cloud Messaging: envie um payload de notificação push com uma única chamada. HTTPS puro sobre o Core. |
TsgcHTTPServer publica endpoints HTTP e arquivos estáticos a partir da sua própria aplicação. É o mesmo motor do servidor WebSocket do sgcWebSockets, sem a parte de WebSocket, e vem com o runtime Core incluído.
| Recurso | API | Observações |
|---|---|---|
| Escuta | Port, Bindings, Active | Defina a porta, ou vincule a endereços específicos, e depois ative o servidor. |
| Requisições | OnCommandGet, OnCommandOther | Toda requisição chega ao seu código com os objetos de requisição e de resposta. OnCommandOther cobre verbos como PUT e DELETE. |
| Arquivos estáticos | DocumentRoot | Devolve arquivos estáticos da pasta para a qual você o apontar. |
| Compressão | HTTPCompression | Opções de compressão das respostas. |
| Conexões | KeepAlive, MaxConnections | Mantém as conexões abertas entre requisições e limita quantas ficam abertas ao mesmo tempo. |
| Sessões | SessionState, AutoStartSession, SessionTimeOut, OnSessionStart, OnSessionEnd | Sessões no servidor com tempo limite, além de eventos de início e fim. |
| Limites de requisição | MaxRequestBodySize | Limita o tamanho do corpo de uma requisição. |
| Uploads | HTTPUploadFiles | Salva os arquivos enviados em um diretório que você escolher. |
| TLS | SSL, SSLOptions | Atenda HTTPS com o seu próprio certificado. |
| Autenticação | Authentication, OnAuthentication | Valide as credenciais no seu próprio código antes de atender uma requisição. |
| Threads | ThreadPool, ThreadPoolOptions | Reutiliza threads de trabalho de um pool em vez de criar uma por conexão. |
| Runtime | sgcWebSockets Core | Declarado na unit sgcHTTP_Server do runtime Core incluído, na página de paleta SGC HTTP. |
TsgcHTTP2Client fala HTTP/2 (RFC 9113) sobre uma única conexão TLS, negociada com ALPN, razão pela qual é construído sobre o sgcCustomIndy.
| Recurso | API | Observações |
|---|---|---|
| Conexão | Host, Port, Active | Uma conexão TLS carrega todo stream de requisição multiplexado. |
| Connect | Connect, ConnectAsync | Abre a conexão e emite uma requisição opcional na mesma chamada. |
| Leitura | Get, GetAsync | Chamada síncrona ou dispare-e-esqueça com a resposta entregue por evento. |
| Escrita | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | Os corpos de requisição são streams, então uploads não precisam caber na memória. |
| Delete & Options | Delete, DeleteAsync, Options, OptionsAsync | O restante do conjunto de verbos HTTP, com o mesmo pareamento síncrono/assíncrono. |
| Respostas | OnHTTP2Response | Entrega os objetos de requisição e resposta juntos, incluindo Response.DataString e o status. |
| Corpos em chunks | OnHTTP2ResponseFragment | Dispara a cada fragmento de uma resposta em chunks que chega, antes do OnHTTP2Response final. |
| Server push | OnHTTP2PushPromise | Expõe recursos enviados por server push do HTTP/2 conforme chegam. |
| Ciclo de vida da conexão | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | Os sinais de conexão, desconexão e reset de stream definidos pelo HTTP/2. |
| Settings | HTTP2Options, Settings | Os valores do frame local HTTP/2 SETTINGS enviados ao peer. |
| Confiabilidade | WatchDog, HeartBeat, Throttle | Reconexão automática, keep-alive e limitação de requisições, compartilhados com o restante da pilha HTTP do sgc. |
| Auth & TLS | Authentication, TLSOptions, OnHTTP2Authorization | Esquemas de autenticação padrão e configuração de TLS, mais um gancho para cabeçalhos de autorização personalizados. |
| Dependência | sgcCustomIndy | O ALPN negocia o protocolo h2 durante o handshake TLS; a biblioteca Indy padrão não consegue fazer isso. |
TsgcGRPCClient carrega payloads Protocol Buffers sobre os streams multiplexados do cliente HTTP/2, então cobre as quatro formas de chamada do gRPC.
| Recurso | API | Observações |
|---|---|---|
| Transporte | Client | Uma instância de TsgcHTTP2Client; o cliente gRPC roda sobre ela em vez de abrir a sua própria conexão. |
| RPC unário | Call, CallAsync, CallString | Uma requisição, uma resposta. Call bloqueia e retorna um TsgcGRPCResponse; CallAsync a entrega através de OnGRPCResponse. |
| Server streaming | ServerStreamingCall | Uma requisição, um stream de respostas entregue através de OnGRPCStreamMessage até OnGRPCStreamEnd. |
| Client streaming | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | Um stream de requisições, uma resposta final quando o stream é fechado. |
| Streaming bidirecional | OpenBidiStream, SendBidiMessage, CloseBidiStream | Os dois lados fazem streaming de forma independente sobre a mesma chamada. |
| Cancelamento | CancelCall | Cancela uma chamada em andamento pelo seu id de stream. |
| Respostas | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse carrega StatusCode, Data/DataString, Headers e Trailers. |
| Erros | OnGRPCError, OnGRPCException | Erros de status-code do gRPC e exceções em nível de transporte, entregues separadamente. |
| Metadados | DefaultMetadata, OnGRPCBeforeRequest | Cabeçalhos de metadados do gRPC por chamada e padrão. |
| Resiliência | RetryPolicy, Interceptors, ServiceConfig | Comportamento de retry, uma cadeia de interceptors transversal, e configuração de serviço, sem tocar nos pontos de chamada individuais. |
| Observabilidade | MetricsCollector | Coleta métricas de chamadas do cliente. |
| Dependência | sgcCustomIndy | Herdada do cliente HTTP/2 sobre o qual é construído; o ALPN é exigido da mesma forma. |
Três classes apenas de código, autenticadas com uma conta de serviço Google e alcançadas sobre HTTPS puro. Nenhuma delas precisa do sgcCustomIndy.
| Recurso | API | Observações |
|---|---|---|
| Autenticação | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | JWT de conta de serviço: id de projeto, e-mail de cliente e chave privada. Forma compartilhada pelos três clientes. |
| Pub/Sub: publicar & ler | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Envie mensagens para um tópico, leia e confirme de uma assinatura. |
| Pub/Sub: tópicos | CreateTopic, DeleteTopic, GetTopic, ListTopics | Gerencie tópicos diretamente pelo código. |
| Pub/Sub: assinaturas | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Ciclo de vida completo de assinaturas, incluindo alterações de prazo de confirmação e configuração de push. |
| Pub/Sub: snapshots | CreateSnapshot, DeleteSnapshot, ListSnapshots | Tire um snapshot do estado de confirmação de uma assinatura para reprodução posterior. |
| Calendar: calendários | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Encapsula a lista de calendários da Google Calendar API v3. |
| Calendar: eventos | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Crie, altere e remova eventos em um determinado calendário. |
| Calendar: sincronização | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Ganchos de sincronização incremental para calendários e eventos alterados desde a última sincronização. |
| FCM: push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. Uma chamada envia um payload v1 do Firebase Cloud Messaging para um projeto. |
| TLS e log | TLSOptions, LogFile | Compartilhado pelos três clientes Google Cloud. |
Especificações públicas no wire, e o mesmo código-fonte em todo compilador compatível.
| Área | Detalhe |
|---|---|
| Servidor HTTP | Requisições e respostas HTTP, arquivos estáticos, sessões e HTTPS por meio do TsgcHTTPServer. |
| HTTP/2 | RFC 9113, com compressão de cabeçalhos HPACK e negociação de protocolo ALPN. |
| gRPC | Payloads Protocol Buffers sobre streams HTTP/2, seguindo o protocolo de wire do gRPC. |
| Google Cloud | A API REST do Pub/Sub, a Google Calendar API v3, e a API HTTP v1 do Firebase Cloud Messaging, todas autenticadas com uma conta de serviço Google. |
| Plataformas | Windows Win32, Windows Win64, Linux64, macOS, iOS e Android para as cinco classes. |
| Dependência | Os clientes HTTP/2 e gRPC precisam do sgcCustomIndy para o ALPN. Os clientes Google Cloud precisam apenas do runtime Core embutido. |
| Compiladores | Delphi e C++ Builder 7 até 13. |
| Edições | O HTTP/2 e o gRPC também vêm dentro do sgcWebSockets a partir da Enterprise, e os clientes Google Cloud a partir da Standard. O servidor HTTP faz parte do runtime Core, então toda edição do sgcWebSockets também o inclui. |
| Licenciamento | Autônomo. O runtime sgcWebSockets Core vem embutido e o código-fonte completo está incluído. |