Tutto quello che fa sgcHTTP, mappato sul server HTTP, il 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.
Endpoint, file statici, sessioni, TLS
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. Il server HTTP, TsgcHTTPServer, fa parte di quel runtime.
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. È sempre incluso nel tuo ordine, e il prezzo di sgcHTTP mostrato lo copre già. I tre client Google Cloud sono HTTPS puro e non lo richiedono.
Tre componenti sulla pagina della palette SGC HTTP e tre classi Google Cloud solo-codice. Il server HTTP è dichiarato nell'unità sgcHTTP_Server del runtime Core incluso, tutto il resto nell'unità sgcHTTP.
| Componente | Classe | Palette? | Descrizione |
|---|---|---|---|
| Server HTTP | TsgcHTTPServer | Sì | Server HTTP: eventi di richiesta, file statici da una document root, compressione, keep-alive, sessioni, upload, TLS e autenticazione. Incluso nel runtime Core. |
| 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. |
TsgcHTTPServer pubblica endpoint HTTP e file statici dalla tua applicazione. È lo stesso motore del server WebSocket di sgcWebSockets senza la parte WebSocket, e viene fornito con il runtime Core incluso.
| Funzionalità | API | Note |
|---|---|---|
| Ascolto | Port, Bindings, Active | Imposta la porta, oppure associa indirizzi specifici, poi attiva il server. |
| Richieste | OnCommandGet, OnCommandOther | Ogni richiesta arriva al tuo codice con i suoi oggetti request e response. OnCommandOther copre verbi come PUT e DELETE. |
| File statici | DocumentRoot | Restituisce i file statici dalla cartella a cui lo punti. |
| Compressione | HTTPCompression | Opzioni di compressione delle risposte. |
| Connessioni | KeepAlive, MaxConnections | Mantieni aperte le connessioni tra una richiesta e l'altra, e limita quante ne possono essere aperte contemporaneamente. |
| Sessioni | SessionState, AutoStartSession, SessionTimeOut, OnSessionStart, OnSessionEnd | Sessioni lato server con un timeout, più gli eventi di inizio e fine. |
| Limiti delle richieste | MaxRequestBodySize | Limita la dimensione del body di una richiesta. |
| Upload | HTTPUploadFiles | Salva i file caricati in una directory a tua scelta. |
| TLS | SSL, SSLOptions | Servi HTTPS con il tuo certificato. |
| Autenticazione | Authentication, OnAuthentication | Convalida le credenziali nel tuo codice prima che una richiesta venga servita. |
| Thread | ThreadPool, ThreadPoolOptions | Riutilizza i thread di lavoro da un pool invece di crearne uno per connessione. |
| Runtime | sgcWebSockets Core | Dichiarato nell'unità sgcHTTP_Server del runtime Core incluso, sulla pagina della palette SGC HTTP. |
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 |
|---|---|
| Server HTTP | Richieste e risposte HTTP, file statici, sessioni e HTTPS tramite TsgcHTTPServer. |
| 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 e gRPC sono inclusi anche in sgcWebSockets a partire dalla Enterprise, e i client Google Cloud a partire dalla Standard. Il server HTTP fa parte del runtime Core, quindi lo include anche ogni edizione di sgcWebSockets. |
| Licenze | Autonomo. Il runtime sgcWebSockets Core è incluso e il codice sorgente completo fa parte della fornitura. |