Tout ce que fait sgcHTTP, réparti sur le serveur HTTP, 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.
Points d'accès, fichiers statiques, sessions, TLS
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. Le serveur HTTP, TsgcHTTPServer, fait partie de ce runtime.
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 toujours inclus dans ta commande, et le prix sgcHTTP affiché le couvre déjà. Les trois clients Google Cloud sont en HTTPS pur et n'en ont pas besoin.
Trois composants sur la page de palette SGC HTTP et trois classes pur code Google Cloud. Le serveur HTTP est déclaré dans l'unité sgcHTTP_Server du runtime Core inclus, tout le reste dans l'unité sgcHTTP.
| Composant | Classe | Palette ? | Description |
|---|---|---|---|
| Serveur HTTP | TsgcHTTPServer | Oui | Serveur HTTP : événements de requête, fichiers statiques depuis une racine de documents, compression, keep-alive, sessions, uploads, TLS et authentification. Livré avec le runtime Core. |
| 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. |
TsgcHTTPServer publie des points d'accès HTTP et des fichiers statiques depuis ta propre application. C'est le même moteur que le serveur WebSocket de sgcWebSockets, sans la partie WebSocket, et il est livré avec le runtime Core inclus.
| Capacité | API | Notes |
|---|---|---|
| Écoute | Port, Bindings, Active | Règle le port, ou lie des adresses précises, puis active le serveur. |
| Requêtes | OnCommandGet, OnCommandOther | Chaque requête arrive dans ton code avec ses objets de requête et de réponse. OnCommandOther couvre les verbes comme PUT et DELETE. |
| Fichiers statiques | DocumentRoot | Renvoie les fichiers statiques du dossier vers lequel tu le pointes. |
| Compression | HTTPCompression | Options de compression des réponses. |
| Connexions | KeepAlive, MaxConnections | Garde les connexions ouvertes entre les requêtes, et plafonne le nombre de connexions ouvertes en même temps. |
| Sessions | SessionState, AutoStartSession, SessionTimeOut, OnSessionStart, OnSessionEnd | Sessions côté serveur avec un délai d'expiration, plus des événements de début et de fin. |
| Limites de requête | MaxRequestBodySize | Plafonne la taille d'un corps de requête. |
| Uploads | HTTPUploadFiles | Enregistre les fichiers uploadés dans un répertoire de ton choix. |
| TLS | SSL, SSLOptions | Sers du HTTPS avec ton propre certificat. |
| Authentification | Authentication, OnAuthentication | Valide les identifiants dans ton propre code avant qu'une requête soit servie. |
| Threads | ThreadPool, ThreadPoolOptions | Réutilise les threads de travail d'un pool au lieu d'en créer un par connexion. |
| Runtime | sgcWebSockets Core | Déclaré dans l'unité sgcHTTP_Server du runtime Core inclus, sur la page de palette SGC HTTP. |
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 |
|---|---|
| Serveur HTTP | Requêtes et réponses HTTP, fichiers statiques, sessions et HTTPS avec TsgcHTTPServer. |
| 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 et gRPC sont aussi livrés dans sgcWebSockets à partir d'Enterprise, et les clients Google Cloud à partir de Standard. Le serveur HTTP fait partie du runtime Core, toutes les éditions de sgcWebSockets l'incluent donc aussi. |
| Licence | Autonome. Le runtime sgcWebSockets Core est inclus et le code source complet est fourni. |