Tout ce que fait sgcHTTP, réparti sur le client HTTP/2, le client gRPC et les trois clients Google Cloud. Chaque capacité fonctionne de la même façon en Delphi et en C++ Builder, et chaque licence est livrée avec le code source complet. Les sous-pages par composant ne sont pas encore publiées pour ce lancement, chaque entrée ci-dessous est autonome sur cette page.
Flux multiplexés, HPACK, ALPN
RPC unaires et en streaming
Pub/Sub, Calendar et FCM
Delphi 7 à 13, C++ Builder
sgcHTTP est autonome. Il est livré avec le runtime sgcWebSockets Core inclus, ce n'est donc pas un complément.
HTTP/2 et gRPC ont besoin de sgcCustomIndy. Les deux classes exigent ALPN pour la négociation du protocole TLS, que la bibliothèque Indy standard ne prend pas en charge, elles sont donc bâties sur sgcCustomIndy à la place. Il est ajouté à ta commande automatiquement. Les trois clients Google Cloud sont en HTTPS pur et n'en ont pas besoin.
Deux composants sur la page de palette SGC HTTP, et trois classes pur code Google Cloud, tous déclarés dans l'unité sgcHTTP.
| Composant | Classe | Palette ? | Description |
|---|---|---|---|
| Client HTTP/2 | TsgcHTTP2Client | Oui | Client HTTP/2 natif : flux multiplexés, compression d'en-têtes HPACK, négociation ALPN. Nécessite sgcCustomIndy. |
| Client gRPC | TsgcGRPCClient | Oui | Client gRPC bâti sur le client HTTP/2 : RPC unaires, en streaming serveur, en streaming client et bidirectionnels. Nécessite sgcCustomIndy. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | Non, pur code | API REST Google Cloud Pub/Sub : sujets, abonnements, instantanés, publication et récupération. HTTPS pur sur le Core. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | Non, pur code | API Google Calendar v3 : agendas et événements, création, modification, liste, suppression. HTTPS pur sur le Core. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | Non, pur code | API HTTP v1 Firebase Cloud Messaging : envoie une charge utile de notification push en un seul appel. HTTPS pur sur le Core. |
TsgcHTTP2Client parle HTTP/2 (RFC 9113) sur une seule connexion TLS, négociée avec ALPN, c'est pourquoi il est bâti sur sgcCustomIndy.
| Capacité | API | Notes |
|---|---|---|
| Connexion | Host, Port, Active | Une seule connexion TLS porte chaque flux de requête multiplexé. |
| Connexion initiale | Connect, ConnectAsync | Ouvre la connexion et émet une requête optionnelle dans le même appel. |
| Lecture | Get, GetAsync | Appel synchrone ou tir-et-oublie avec la réponse délivrée par événement. |
| Écriture | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | Les corps de requête sont des flux, les envois n'ont donc pas à tenir en mémoire. |
| Delete et Options | Delete, DeleteAsync, Options, OptionsAsync | Le reste du jeu de verbes HTTP, avec la même paire synchrone/async. |
| Réponses | OnHTTP2Response | Délivre ensemble les objets requête et réponse, y compris Response.DataString et le statut. |
| Corps fragmentés | OnHTTP2ResponseFragment | Se déclenche à l'arrivée de chaque fragment d'une réponse fragmentée, avant l'OnHTTP2Response final. |
| Push serveur | OnHTTP2PushPromise | Expose les ressources poussées par le serveur HTTP/2 à leur arrivée. |
| Cycle de vie de la connexion | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | Les signaux de connexion, déconnexion et réinitialisation de flux définis par HTTP/2. |
| Réglages | HTTP2Options, Settings | Les valeurs de la trame SETTINGS HTTP/2 locale envoyées au pair. |
| Fiabilité | WatchDog, HeartBeat, Throttle | Reconnexion automatique, maintien de connexion et limitation de débit, partagés avec le reste de la pile HTTP sgc. |
| Authentification et TLS | Authentication, TLSOptions, OnHTTP2Authorization | Schémas d'authentification standards et configuration TLS, plus un point d'accroche pour des en-têtes d'autorisation personnalisés. |
| Dépendance | sgcCustomIndy | ALPN négocie le protocole h2 pendant la poignée de main TLS ; la bibliothèque Indy standard ne peut pas le faire. |
TsgcGRPCClient transporte des charges utiles Protocol Buffers sur les flux multiplexés du client HTTP/2, il couvre donc les quatre formes d'appel gRPC.
| Capacité | API | Notes |
|---|---|---|
| Transport | Client | Une instance TsgcHTTP2Client ; le client gRPC repose dessus plutôt que d'ouvrir sa propre connexion. |
| RPC unaire | Call, CallAsync, CallString | Une requête, une réponse. Call bloque et renvoie un TsgcGRPCResponse ; CallAsync la délivre via OnGRPCResponse. |
| Streaming serveur | ServerStreamingCall | Une requête, un flux de réponses délivrées via OnGRPCStreamMessage jusqu'à OnGRPCStreamEnd. |
| Streaming client | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | Un flux de requêtes, une réponse finale à la fermeture du flux. |
| Streaming bidirectionnel | OpenBidiStream, SendBidiMessage, CloseBidiStream | Les deux côtés diffusent indépendamment sur le même appel. |
| Annulation | CancelCall | Annule un appel en cours par son identifiant de flux. |
| Réponses | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse porte StatusCode, Data/DataString, Headers et Trailers. |
| Erreurs | OnGRPCError, OnGRPCException | Erreurs de code de statut gRPC et exceptions de niveau transport, délivrées séparément. |
| Métadonnées | DefaultMetadata, OnGRPCBeforeRequest | En-têtes de métadonnées gRPC par appel et par défaut. |
| Résilience | RetryPolicy, Interceptors, ServiceConfig | Comportement de réessai, chaîne d'intercepteurs transversale et configuration de service, sans toucher aux points d'appel individuels. |
| Observabilité | MetricsCollector | Collecte les métriques d'appel du client. |
| Dépendance | sgcCustomIndy | Héritée du client HTTP/2 sur lequel il est bâti ; ALPN est requis de la même façon. |
Trois classes pur code, authentifiées avec un compte de service Google et atteintes en HTTPS pur. Aucune n'a besoin de sgcCustomIndy.
| Capacité | API | Notes |
|---|---|---|
| Authentification | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | JWT de compte de service : id de projet, e-mail client et clé privée. Forme partagée par les trois clients. |
| Pub/Sub : publier et récupérer | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Envoie des messages vers un sujet, récupère et accuse réception depuis un abonnement. |
| Pub/Sub : sujets | CreateTopic, DeleteTopic, GetTopic, ListTopics | Gère les sujets directement depuis le code. |
| Pub/Sub : abonnements | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Cycle de vie complet de l'abonnement, y compris les changements de délai d'accusé de réception et de configuration push. |
| Pub/Sub : instantanés | CreateSnapshot, DeleteSnapshot, ListSnapshots | Capture l'état d'accusé de réception d'un abonnement pour une relecture ultérieure. |
| Calendar : agendas | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Encapsule la liste d'agendas de l'API Google Calendar v3. |
| Calendar : événements | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Crée, modifie et supprime des événements sur un agenda donné. |
| Calendar : synchronisation | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Points d'accroche de synchronisation incrémentale pour les agendas et événements modifiés depuis la dernière synchronisation. |
| FCM : push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. Un seul appel envoie une charge utile Firebase Cloud Messaging v1 à un projet. |
| TLS et journalisation | TLSOptions, LogFile | Partagés par les trois clients Google Cloud. |
Des standards publics sur le fil, et le même source sur chaque compilateur pris en charge.
| Domaine | Détail |
|---|---|
| HTTP/2 | RFC 9113, avec compression d'en-têtes HPACK et négociation de protocole ALPN. |
| gRPC | Charges utiles Protocol Buffers sur des flux HTTP/2, selon le protocole de câble gRPC. |
| Google Cloud | L'API REST Pub/Sub, l'API Google Calendar v3, et l'API HTTP v1 Firebase Cloud Messaging, toutes authentifiées avec un compte de service Google. |
| Plateformes | Windows Win32, Windows Win64, Linux64, macOS, iOS et Android pour les cinq classes. |
| Dépendance | Les clients HTTP/2 et gRPC ont besoin de sgcCustomIndy pour ALPN. Les clients Google Cloud n'ont besoin que du runtime Core inclus. |
| Compilateurs | Delphi et C++ Builder 7 à 13. |
| Éditions | HTTP/2 est aussi livré dans sgcWebSockets à partir de Professional, gRPC à partir d'Enterprise, et les clients Google Cloud à partir de Standard. |
| Licence | Autonome. Le runtime sgcWebSockets Core est inclus et le code source complet est fourni. |