Todo lo que hace sgcHTTP, repartido entre el cliente HTTP/2, el cliente gRPC y los tres clientes de Google Cloud. Cada capacidad funciona igual en Delphi y en C++ Builder, y todas las licencias incluyen el código fuente completo. Las subpáginas de componentes aún no están publicadas para este lanzamiento, cada entrada de abajo es autocontenida en esta página.
Streams multiplexados, HPACK, ALPN
RPC unario y en streaming
Pub/Sub, Calendar y FCM
Delphi 7 a 13, C++ Builder
sgcHTTP es autocontenido. Se entrega con el runtime sgcWebSockets Core incluido, así que no es un complemento.
HTTP/2 y gRPC necesitan sgcCustomIndy. Ambas clases requieren ALPN para la negociación del protocolo TLS, algo que la librería Indy estándar no admite, así que están construidas en su lugar sobre sgcCustomIndy. Se añade a tu pedido automáticamente. Los tres clientes de Google Cloud son HTTPS puro y no lo necesitan.
Dos componentes en la página de paleta SGC HTTP, y tres clases de Google Cloud solo de código, todas declaradas en la unidad sgcHTTP.
| Componente | Clase | ¿Paleta? | Descripción |
|---|---|---|---|
| Cliente HTTP/2 | TsgcHTTP2Client | Sí | Cliente HTTP/2 nativo: streams multiplexados, compresión de cabeceras HPACK, negociación ALPN. Necesita sgcCustomIndy. |
| Cliente gRPC | TsgcGRPCClient | Sí | Cliente gRPC construido sobre el cliente HTTP/2: RPC unario, de streaming de servidor, de streaming de cliente y bidireccional. Necesita sgcCustomIndy. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | No, solo código | API REST de Google Cloud Pub/Sub: topics, suscripciones, snapshots, publicación y extracción. HTTPS puro sobre Core. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | No, solo código | Google Calendar API v3: calendarios y eventos, crear, actualizar, listar, eliminar. HTTPS puro sobre Core. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | No, solo código | API HTTP v1 de Firebase Cloud Messaging: envía un payload de notificación push con una sola llamada. HTTPS puro sobre Core. |
TsgcHTTP2Client habla HTTP/2 (RFC 9113) sobre una sola conexión TLS, negociada con ALPN, la razón por la que está construido sobre sgcCustomIndy.
| Capacidad | API | Notas |
|---|---|---|
| Conexión | Host, Port, Active | Una sola conexión TLS transporta todos los streams de petición multiplexados. |
| Conectar | Connect, ConnectAsync | Abre la conexión y emite una petición opcional en la misma llamada. |
| Lectura | Get, GetAsync | Llamada síncrona o disparar y olvidar, con la respuesta entregada por evento. |
| Escritura | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | Los cuerpos de petición son streams, así que las subidas no tienen que caber en memoria. |
| Delete y Options | Delete, DeleteAsync, Options, OptionsAsync | El resto del conjunto de verbos HTTP, con el mismo emparejamiento síncrono/asíncrono. |
| Respuestas | OnHTTP2Response | Entrega juntos los objetos de petición y respuesta, incluidos Response.DataString y el estado. |
| Cuerpos fragmentados | OnHTTP2ResponseFragment | Se dispara según llega cada fragmento de una respuesta fragmentada, antes del OnHTTP2Response final. |
| Server push | OnHTTP2PushPromise | Expone los recursos enviados por server push de HTTP/2 según llegan. |
| Ciclo de vida de la conexión | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | Las señales de conexión, desconexión y reinicio de stream que define HTTP/2. |
| Settings | HTTP2Options, Settings | Los valores del frame SETTINGS local de HTTP/2 enviados al peer. |
| Fiabilidad | WatchDog, HeartBeat, Throttle | Reconexión automática, keep-alive y limitación de peticiones, compartidos con el resto de la pila HTTP de sgc. |
| Autenticación y TLS | Authentication, TLSOptions, OnHTTP2Authorization | Esquemas de autenticación estándar y configuración TLS, además de un gancho para cabeceras de autorización personalizadas. |
| Dependencia | sgcCustomIndy | ALPN negocia el protocolo h2 durante el handshake TLS; la librería Indy estándar no puede hacerlo. |
TsgcGRPCClient transporta payloads de Protocol Buffers sobre los streams multiplexados del cliente HTTP/2, así que cubre las cuatro formas de llamada de gRPC.
| Capacidad | API | Notas |
|---|---|---|
| Transporte | Client | Una instancia de TsgcHTTP2Client; el cliente gRPC viaja sobre ella en lugar de abrir su propia conexión. |
| RPC unario | Call, CallAsync, CallString | Una petición, una respuesta. Call bloquea y devuelve un TsgcGRPCResponse; CallAsync la entrega a través de OnGRPCResponse. |
| Streaming de servidor | ServerStreamingCall | Una petición, un stream de respuestas entregadas a través de OnGRPCStreamMessage hasta OnGRPCStreamEnd. |
| Streaming de cliente | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | Un stream de peticiones, una respuesta final cuando el stream se cierra. |
| Streaming bidireccional | OpenBidiStream, SendBidiMessage, CloseBidiStream | Ambos lados hacen streaming de forma independiente sobre la misma llamada. |
| Cancelación | CancelCall | Cancela una llamada en curso mediante su id de stream. |
| Respuestas | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse transporta StatusCode, Data/DataString, Headers y Trailers. |
| Errores | OnGRPCError, OnGRPCException | Errores de código de estado de gRPC y excepciones a nivel de transporte, entregados por separado. |
| Metadatos | DefaultMetadata, OnGRPCBeforeRequest | Cabeceras de metadatos de gRPC por llamada y por defecto. |
| Resiliencia | RetryPolicy, Interceptors, ServiceConfig | Comportamiento de reintento, una cadena de interceptores transversal y configuración del servicio, sin tocar los puntos de llamada individuales. |
| Observabilidad | MetricsCollector | Recopila métricas de llamadas del cliente. |
| Dependencia | sgcCustomIndy | Heredada del cliente HTTP/2 sobre el que está construido; ALPN se requiere de la misma forma. |
Tres clases solo de código, autenticadas con una cuenta de servicio de Google y accedidas sobre HTTPS puro. Ninguna necesita sgcCustomIndy.
| Capacidad | API | Notas |
|---|---|---|
| Autenticación | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | JWT de cuenta de servicio: project id, client email y private key. La misma forma en los tres clientes. |
| Pub/Sub: publicación y extracción | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Envía mensajes a un topic, extrae y confirma desde una suscripción. |
| Pub/Sub: topics | CreateTopic, DeleteTopic, GetTopic, ListTopics | Gestiona topics directamente desde código. |
| Pub/Sub: suscripciones | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Ciclo de vida completo de la suscripción, incluidos los cambios de ack-deadline y push-config. |
| Pub/Sub: snapshots | CreateSnapshot, DeleteSnapshot, ListSnapshots | Toma una instantánea del estado de confirmación de una suscripción para reproducirla más tarde. |
| Calendar: calendarios | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Envuelve la lista de calendarios de la Google Calendar API v3. |
| Calendar: eventos | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Crea, cambia y elimina eventos en un calendario dado. |
| Calendar: sincronización | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Ganchos de sincronización incremental para los calendarios y eventos que cambiaron desde la última sincronización. |
| FCM: push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. Una llamada envía un payload de Firebase Cloud Messaging v1 a un proyecto. |
| TLS y registro | TLSOptions, LogFile | Compartidos por los tres clientes de Google Cloud. |
Estándares públicos en el cable, y el mismo código fuente en todos los compiladores compatibles.
| Área | Detalle |
|---|---|
| HTTP/2 | RFC 9113, con compresión de cabeceras HPACK y negociación de protocolo ALPN. |
| gRPC | Payloads de Protocol Buffers sobre streams HTTP/2, siguiendo el protocolo de red de gRPC. |
| Google Cloud | La API REST de Pub/Sub, la Google Calendar API v3 y la API HTTP v1 de Firebase Cloud Messaging, todas autenticadas con una cuenta de servicio de Google. |
| Plataformas | Windows Win32, Windows Win64, Linux64, macOS, iOS y Android para las cinco clases. |
| Dependencia | Los clientes HTTP/2 y gRPC necesitan sgcCustomIndy para ALPN. Los clientes de Google Cloud solo necesitan el runtime Core incluido. |
| Compiladores | Delphi y C++ Builder 7 a 13. |
| Ediciones | HTTP/2 también se entrega dentro de sgcWebSockets desde Professional en adelante, gRPC desde Enterprise en adelante, y los clientes de Google Cloud desde Standard en adelante. |
| Licencias | Independiente. El runtime sgcWebSockets Core viene incluido y se entrega el código fuente completo. |