Everything sgcHTTP does, mapped across the HTTP/2 client, the gRPC client and the three Google Cloud clients. Every capability works the same in Delphi and C++ Builder, and every license ships full source code. Component subpages are not published yet for this launch, each entry below is self-contained on this page.
Multiplexed streams, HPACK, ALPN
Unary & streaming RPC
Pub/Sub, Calendar & FCM
Delphi 7 to 13, C++ Builder
sgcHTTP is self-contained. It ships with the sgcWebSockets Core runtime bundled in, so it is not an add-on.
HTTP/2 and gRPC need sgcCustomIndy. Both classes require ALPN for TLS protocol negotiation, which the standard Indy library does not support, so they are built on sgcCustomIndy instead. It is added to your order automatically. The three Google Cloud clients are plain HTTPS and do not need it.
Two components on the SGC HTTP palette page, and three code-only Google Cloud classes, all declared in the sgcHTTP unit.
| Component | Class | Palette? | Description |
|---|---|---|---|
| HTTP/2 Client | TsgcHTTP2Client | Yes | Native HTTP/2 client: multiplexed streams, HPACK header compression, ALPN negotiation. Needs sgcCustomIndy. |
| gRPC Client | TsgcGRPCClient | Yes | gRPC client built on the HTTP/2 client: unary, server-streaming, client-streaming and bidirectional RPC. Needs sgcCustomIndy. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | No, code-only | Google Cloud Pub/Sub REST API: topics, subscriptions, snapshots, publish and pull. Plain HTTPS on Core. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | No, code-only | Google Calendar API v3: calendars and events, create, update, list, delete. Plain HTTPS on Core. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | No, code-only | Firebase Cloud Messaging HTTP v1 API: send a push notification payload with one call. Plain HTTPS on Core. |
TsgcHTTP2Client speaks HTTP/2 (RFC 9113) over a single TLS connection, negotiated with ALPN, which is why it is built on sgcCustomIndy.
| Capability | API | Notes |
|---|---|---|
| Connection | Host, Port, Active | One TLS connection carries every multiplexed request stream. |
| Connect | Connect, ConnectAsync | Opens the connection and issues an optional request in the same call. |
| Read | Get, GetAsync | Synchronous call or fire-and-forget with the response delivered by event. |
| Write | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | Request bodies are streams, so uploads do not have to fit in memory. |
| Delete & Options | Delete, DeleteAsync, Options, OptionsAsync | The rest of the HTTP verb set, same synchronous/async pairing. |
| Responses | OnHTTP2Response | Delivers the request and response objects together, including Response.DataString and status. |
| Chunked bodies | OnHTTP2ResponseFragment | Fires as each fragment of a chunked response arrives, ahead of the final OnHTTP2Response. |
| Server push | OnHTTP2PushPromise | Surfaces HTTP/2 server-pushed resources as they arrive. |
| Connection lifecycle | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | The connect, disconnect and stream-reset signals HTTP/2 defines. |
| Settings | HTTP2Options, Settings | The local HTTP/2 SETTINGS frame values sent to the peer. |
| Reliability | WatchDog, HeartBeat, Throttle | Auto-reconnect, keep-alive and request throttling, shared with the rest of the sgc HTTP stack. |
| Auth & TLS | Authentication, TLSOptions, OnHTTP2Authorization | Standard authentication schemes and TLS configuration, plus a hook for custom authorization headers. |
| Dependency | sgcCustomIndy | ALPN negotiates the h2 protocol during the TLS handshake; the standard Indy library cannot do this. |
TsgcGRPCClient carries Protocol Buffers payloads over the HTTP/2 client's multiplexed streams, so it covers all four gRPC call shapes.
| Capability | API | Notes |
|---|---|---|
| Transport | Client | A TsgcHTTP2Client instance; the gRPC client rides on it rather than opening its own connection. |
| Unary RPC | Call, CallAsync, CallString | One request, one response. Call blocks and returns a TsgcGRPCResponse; CallAsync delivers it through OnGRPCResponse. |
| Server streaming | ServerStreamingCall | One request, a stream of responses delivered through OnGRPCStreamMessage until OnGRPCStreamEnd. |
| Client streaming | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | A stream of requests, one final response when the stream closes. |
| Bidirectional streaming | OpenBidiStream, SendBidiMessage, CloseBidiStream | Both sides stream independently over the same call. |
| Cancellation | CancelCall | Cancels a call in progress by its stream id. |
| Responses | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse carries StatusCode, Data/DataString, Headers and Trailers. |
| Errors | OnGRPCError, OnGRPCException | gRPC status-code errors and transport-level exceptions, delivered separately. |
| Metadata | DefaultMetadata, OnGRPCBeforeRequest | Per-call and default gRPC metadata headers. |
| Resilience | RetryPolicy, Interceptors, ServiceConfig | Retry behavior, a cross-cutting interceptor chain, and service configuration, without touching individual call sites. |
| Observability | MetricsCollector | Collects call metrics for the client. |
| Dependency | sgcCustomIndy | Inherited from the HTTP/2 client it is built on; ALPN is required the same way. |
Three code-only classes, authenticated with a Google service account and reached over plain HTTPS. None of them need sgcCustomIndy.
| Capability | API | Notes |
|---|---|---|
| Authentication | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | Service-account JWT: project id, client email and private key. Shared shape across all three clients. |
| Pub/Sub: publish & pull | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Send messages to a topic, pull and acknowledge from a subscription. |
| Pub/Sub: topics | CreateTopic, DeleteTopic, GetTopic, ListTopics | Manage topics directly from code. |
| Pub/Sub: subscriptions | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Full subscription lifecycle, including ack-deadline and push-config changes. |
| Pub/Sub: snapshots | CreateSnapshot, DeleteSnapshot, ListSnapshots | Snapshot a subscription's acknowledgment state for later replay. |
| Calendar: calendars | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Wraps the Google Calendar API v3 calendar list. |
| Calendar: events | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Create, change and remove events on a given calendar. |
| Calendar: sync | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Incremental synchronization hooks for calendars and events that changed since the last sync. |
| FCM: push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. One call sends a Firebase Cloud Messaging v1 payload to a project. |
| TLS and logging | TLSOptions, LogFile | Shared across all three Google Cloud clients. |
Public standards on the wire, and the same source across every supported compiler.
| Area | Detail |
|---|---|
| HTTP/2 | RFC 9113, with HPACK header compression and ALPN protocol negotiation. |
| gRPC | Protocol Buffers payloads over HTTP/2 streams, following the gRPC wire protocol. |
| Google Cloud | The Pub/Sub REST API, the Google Calendar API v3, and the Firebase Cloud Messaging HTTP v1 API, all authenticated with a Google service account. |
| Platforms | Windows Win32, Windows Win64, Linux64, macOS, iOS and Android for all five classes. |
| Dependency | The HTTP/2 and gRPC clients need sgcCustomIndy for ALPN. The Google Cloud clients need only the bundled Core runtime. |
| Compilers | Delphi and C++ Builder 7 through 13. |
| Editions | HTTP/2 also ships inside sgcWebSockets from Professional up, gRPC from Enterprise up, and the Google Cloud clients from Standard up. |
| Licensing | Standalone. The sgcWebSockets Core runtime is bundled in and full source code is included. |