Todo lo que hace sgcHTTP, repartido entre el servidor HTTP, 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.
Endpoints, archivos estáticos, sesiones, TLS
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. El servidor HTTP, TsgcHTTPServer, forma parte de ese runtime.
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. Siempre se incluye en tu pedido, y el precio de sgcHTTP que se muestra ya lo cubre. Los tres clientes de Google Cloud son HTTPS puro y no lo necesitan.
Tres componentes en la página de paleta SGC HTTP y tres clases de Google Cloud solo de código. El servidor HTTP está declarado en la unidad sgcHTTP_Server del runtime Core incluido, todo lo demás en la unidad sgcHTTP.
| Componente | Clase | ¿Paleta? | Descripción |
|---|---|---|---|
| Servidor HTTP | TsgcHTTPServer | Sí | Servidor HTTP: eventos de petición, archivos estáticos desde una raíz de documentos, compresión, keep-alive, sesiones, subidas de archivos, TLS y autenticación. Se incluye con el runtime Core. |
| 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. |
TsgcHTTPServer publica endpoints HTTP y archivos estáticos desde tu propia aplicación. Es el mismo motor que el servidor WebSocket de sgcWebSockets sin la parte WebSocket, y se incluye con el runtime Core.
| Capacidad | API | Notas |
|---|---|---|
| Escucha | Port, Bindings, Active | Define el puerto, o enlaza a direcciones concretas, y luego activa el servidor. |
| Peticiones | OnCommandGet, OnCommandOther | Cada petición llega a tu código con sus objetos de petición y respuesta. OnCommandOther cubre verbos como PUT y DELETE. |
| Archivos estáticos | DocumentRoot | Devuelve archivos estáticos desde la carpeta a la que lo apuntes. |
| Compresión | HTTPCompression | Opciones de compresión de las respuestas. |
| Conexiones | KeepAlive, MaxConnections | Mantiene las conexiones abiertas entre peticiones y limita cuántas hay abiertas a la vez. |
| Sesiones | SessionState, AutoStartSession, SessionTimeOut, OnSessionStart, OnSessionEnd | Sesiones en el servidor con tiempo de espera, más eventos de inicio y fin. |
| Límites de petición | MaxRequestBodySize | Limita el tamaño del cuerpo de una petición. |
| Subidas | HTTPUploadFiles | Guarda los archivos subidos en un directorio que tú eliges. |
| TLS | SSL, SSLOptions | Sirve HTTPS con tu propio certificado. |
| Autenticación | Authentication, OnAuthentication | Valida las credenciales en tu propio código antes de atender una petición. |
| Hilos | ThreadPool, ThreadPoolOptions | Reutiliza hilos de trabajo de un pool en lugar de crear uno por conexión. |
| Runtime | sgcWebSockets Core | Declarado en la unidad sgcHTTP_Server del runtime Core incluido, en la página de paleta SGC HTTP. |
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 |
|---|---|
| Servidor HTTP | Peticiones y respuestas HTTP, archivos estáticos, sesiones y HTTPS mediante TsgcHTTPServer. |
| 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 y gRPC también se entregan dentro de sgcWebSockets desde Enterprise en adelante, y los clientes de Google Cloud desde Standard en adelante. El servidor HTTP forma parte del runtime Core, así que todas las ediciones de sgcWebSockets lo incluyen también. |
| Licencias | Independiente. El runtime sgcWebSockets Core viene incluido y se entrega el código fuente completo. |