Tutto quello che fa sgcHTTP, mappato sul client HTTP/2, il client gRPC e i tre client Google Cloud. Ogni funzionalità si comporta allo stesso modo in Delphi e in C++ Builder, e ogni licenza include il codice sorgente completo. Le sottopagine dei componenti non sono ancora pubblicate per questo lancio, ogni voce qui sotto è autonoma su questa pagina.
Stream multiplati, HPACK, ALPN
RPC unarie e in streaming
Pub/Sub, Calendar e FCM
Da Delphi 7 a 13, C++ Builder
sgcHTTP è autosufficiente. Viene distribuito con il runtime sgcWebSockets Core incluso, quindi non è un componente aggiuntivo.
HTTP/2 e gRPC richiedono sgcCustomIndy. Entrambe le classi richiedono ALPN per la negoziazione del protocollo TLS, che la libreria Indy standard non supporta, quindi sono costruite invece su sgcCustomIndy. Viene aggiunto al tuo ordine automaticamente. I tre client Google Cloud sono HTTPS puro e non lo richiedono.
Due componenti sulla pagina della palette SGC HTTP, e tre classi Google Cloud solo-codice, tutte dichiarate nell'unità sgcHTTP.
| Componente | Classe | Palette? | Descrizione |
|---|---|---|---|
| Client HTTP/2 | TsgcHTTP2Client | Sì | Client HTTP/2 nativo: stream multiplati, compressione degli header HPACK, negoziazione ALPN. Richiede sgcCustomIndy. |
| Client gRPC | TsgcGRPCClient | Sì | Client gRPC costruito sul client HTTP/2: RPC unarie, server-streaming, client-streaming e bidirezionali. Richiede sgcCustomIndy. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | No, solo-codice | API REST di Google Cloud Pub/Sub: topic, subscription, snapshot, publish e pull. HTTPS puro sul Core. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | No, solo-codice | Google Calendar API v3: calendari ed eventi, creazione, aggiornamento, elenco, eliminazione. HTTPS puro sul Core. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | No, solo-codice | API HTTP v1 di Firebase Cloud Messaging: invia un payload di notifica push con una sola chiamata. HTTPS puro sul Core. |
TsgcHTTP2Client parla HTTP/2 (RFC 9113) su un'unica connessione TLS, negoziata con ALPN, il motivo per cui è costruito su sgcCustomIndy.
| Funzionalità | API | Note |
|---|---|---|
| Connessione | Host, Port, Active | Un'unica connessione TLS porta ogni stream di richiesta multiplato. |
| Connetti | Connect, ConnectAsync | Apre la connessione ed emette una richiesta opzionale nella stessa chiamata. |
| Leggi | Get, GetAsync | Chiamata sincrona oppure fire-and-forget con la risposta consegnata via evento. |
| Scrivi | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | I corpi delle richieste sono stream, così gli upload non devono stare in memoria. |
| Delete e Options | Delete, DeleteAsync, Options, OptionsAsync | Il resto del set di verbi HTTP, stesso abbinamento sincrono/asincrono. |
| Risposte | OnHTTP2Response | Consegna insieme l'oggetto richiesta e l'oggetto risposta, incluso Response.DataString e lo stato. |
| Corpi a blocchi | OnHTTP2ResponseFragment | Scatta a ogni frammento di una risposta a blocchi che arriva, prima dell'OnHTTP2Response finale. |
| Server push | OnHTTP2PushPromise | Mostra le risorse inviate dal server con push HTTP/2 man mano che arrivano. |
| Ciclo di vita della connessione | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | I segnali di connessione, disconnessione e reset dello stream definiti da HTTP/2. |
| Impostazioni | HTTP2Options, Settings | I valori del frame SETTINGS HTTP/2 locale inviati al peer. |
| Affidabilità | WatchDog, HeartBeat, Throttle | Riconnessione automatica, keep-alive e limitazione delle richieste, condivisi con il resto dello stack sgc HTTP. |
| Auth e TLS | Authentication, TLSOptions, OnHTTP2Authorization | Schemi di autenticazione standard e configurazione TLS, più un hook per header di autorizzazione personalizzati. |
| Dipendenza | sgcCustomIndy | ALPN negozia il protocollo h2 durante l'handshake TLS; la libreria Indy standard non può farlo. |
TsgcGRPCClient porta i payload Protocol Buffers sugli stream multiplati del client HTTP/2, quindi copre tutte e quattro le forme di chiamata gRPC.
| Funzionalità | API | Note |
|---|---|---|
| Trasporto | Client | Un'istanza di TsgcHTTP2Client; il client gRPC vi si appoggia invece di aprire una propria connessione. |
| RPC unaria | Call, CallAsync, CallString | Una richiesta, una risposta. Call blocca e restituisce un TsgcGRPCResponse; CallAsync la consegna tramite OnGRPCResponse. |
| Server streaming | ServerStreamingCall | Una richiesta, uno stream di risposte consegnate tramite OnGRPCStreamMessage fino a OnGRPCStreamEnd. |
| Client streaming | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | Uno stream di richieste, una risposta finale quando lo stream si chiude. |
| Streaming bidirezionale | OpenBidiStream, SendBidiMessage, CloseBidiStream | Entrambi i lati fanno streaming in modo indipendente sulla stessa chiamata. |
| Annullamento | CancelCall | Annulla una chiamata in corso tramite il suo id di stream. |
| Risposte | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse porta StatusCode, Data/DataString, Headers e Trailers. |
| Errori | OnGRPCError, OnGRPCException | Errori con codice di stato gRPC ed eccezioni a livello di trasporto, consegnati separatamente. |
| Metadati | DefaultMetadata, OnGRPCBeforeRequest | Header di metadati gRPC per singola chiamata e predefiniti. |
| Resilienza | RetryPolicy, Interceptors, ServiceConfig | Comportamento di retry, una catena di interceptor trasversale, e configurazione del servizio, senza toccare i singoli punti di chiamata. |
| Osservabilità | MetricsCollector | Raccoglie le metriche delle chiamate per il client. |
| Dipendenza | sgcCustomIndy | Ereditata dal client HTTP/2 su cui è costruito; ALPN è richiesto allo stesso modo. |
Tre classi solo-codice, autenticate con un service account Google e raggiunte su HTTPS puro. Nessuna di loro richiede sgcCustomIndy.
| Funzionalità | API | Note |
|---|---|---|
| Autenticazione | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | JWT del service account: project id, email client e chiave privata. Forma condivisa tra tutti e tre i client. |
| Pub/Sub: publish e pull | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Invia messaggi a un topic, preleva e conferma da una subscription. |
| Pub/Sub: topic | CreateTopic, DeleteTopic, GetTopic, ListTopics | Gestisci i topic direttamente da codice. |
| Pub/Sub: subscription | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Ciclo di vita completo delle subscription, incluse le modifiche all'ack-deadline e alla push-config. |
| Pub/Sub: snapshot | CreateSnapshot, DeleteSnapshot, ListSnapshots | Cattura lo stato di conferma di una subscription per un replay successivo. |
| Calendar: calendari | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Avvolge l'elenco calendari della Google Calendar API v3. |
| Calendar: eventi | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Crea, modifica ed elimina eventi su un dato calendario. |
| Calendar: sincronizzazione | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Hook di sincronizzazione incrementale per calendari ed eventi cambiati dall'ultima sincronizzazione. |
| FCM: push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. Una sola chiamata invia un payload Firebase Cloud Messaging v1 a un progetto. |
| TLS e log | TLSOptions, LogFile | Condivisi da tutti e tre i client Google Cloud. |
Standard pubblici sul filo, e lo stesso sorgente su ogni compilatore supportato.
| Ambito | Dettaglio |
|---|---|
| HTTP/2 | RFC 9113, con compressione degli header HPACK e negoziazione del protocollo ALPN. |
| gRPC | Payload Protocol Buffers su stream HTTP/2, seguendo il protocollo sul filo di gRPC. |
| Google Cloud | L'API REST di Pub/Sub, la Google Calendar API v3, e l'API HTTP v1 di Firebase Cloud Messaging, tutte autenticate con un service account Google. |
| Piattaforme | Windows Win32, Windows Win64, Linux64, macOS, iOS e Android per tutte e cinque le classi. |
| Dipendenza | I client HTTP/2 e gRPC richiedono sgcCustomIndy per ALPN. I client Google Cloud richiedono solo il runtime Core incluso. |
| Compilatori | Delphi e C++ Builder dalla versione 7 alla 13. |
| Edizioni | HTTP/2 è incluso anche in sgcWebSockets a partire dalla Professional, gRPC a partire dalla Enterprise, e i client Google Cloud a partire dalla Standard. |
| Licenze | Autonomo. Il runtime sgcWebSockets Core è incluso e il codice sorgente completo fa parte della fornitura. |