sgcHTTP'nin yaptığı her şey; HTTP/2 istemcisi, gRPC istemcisi ve üç Google Cloud istemcisi üzerinden eşlenmiş. Her yetenek Delphi ve C++ Builder'da aynı şekilde çalışır ve her lisans tam kaynak koduyla gelir. Bu lansman için bileşen alt sayfaları henüz yayımlanmadı, aşağıdaki her giriş bu sayfada kendi kendine yeterlidir.
Çoğullanmış akışlar, HPACK, ALPN
Unary & akış tabanlı RPC
Pub/Sub, Calendar & FCM
Delphi 7'den 13'e, C++ Builder
sgcHTTP kendi kendine yeterlidir. sgcWebSockets Core çalışma zamanı pakete dahil olarak gelir, bu yüzden bir eklenti değildir.
HTTP/2 ve gRPC, sgcCustomIndy gerektirir. Her iki sınıf da TLS protokol müzakeresi için ALPN gerektirir; standart Indy kitaplığı bunu desteklemez, bu yüzden bunun yerine sgcCustomIndy üzerine kuruludur. Siparişinize otomatik olarak eklenir. Üç Google Cloud istemcisi düz HTTPS'tir ve buna ihtiyaç duymaz.
SGC HTTP palet sayfasında iki bileşen ve üç kod-yalnızca Google Cloud sınıfı, hepsi sgcHTTP biriminde tanımlanmıştır.
| Bileşen | Sınıf | Palette mi? | Açıklama |
|---|---|---|---|
| HTTP/2 İstemcisi | TsgcHTTP2Client | Evet | Yerel HTTP/2 istemcisi: çoğullanmış akışlar, HPACK başlık sıkıştırması, ALPN müzakeresi. sgcCustomIndy'ye ihtiyaç duyar. |
| gRPC İstemcisi | TsgcGRPCClient | Evet | HTTP/2 istemcisi üzerine kurulu gRPC istemcisi: unary, sunucu akışlı, istemci akışlı ve çift yönlü akışlı RPC. sgcCustomIndy'ye ihtiyaç duyar. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | Hayır, kod-yalnızca | Google Cloud Pub/Sub REST API'si: konular, abonelikler, anlık görüntüler, yayınlama ve çekme. Core üzerinde düz HTTPS. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | Hayır, kod-yalnızca | Google Calendar API v3: takvimler ve etkinlikler, oluşturma, güncelleme, listeleme, silme. Core üzerinde düz HTTPS. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | Hayır, kod-yalnızca | Firebase Cloud Messaging HTTP v1 API'si: tek bir çağrıyla bir push bildirim yükü gönderin. Core üzerinde düz HTTPS. |
TsgcHTTP2Client, ALPN ile müzakere edilen tek bir TLS bağlantısı üzerinden HTTP/2 (RFC 9113) konuşur; bu yüzden sgcCustomIndy üzerine kuruludur.
| Yetenek | API | Notlar |
|---|---|---|
| Bağlantı | Host, Port, Active | Tek bir TLS bağlantısı, her çoğullanmış istek akışını taşır. |
| Bağlan | Connect, ConnectAsync | Bağlantıyı açar ve aynı çağrıda isteğe bağlı bir istek gönderir. |
| Oku | Get, GetAsync | Eşzamanlı çağrı ya da yanıtın bir olayla teslim edildiği gönder-ve-unut. |
| Yaz | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | İstek gövdeleri akışlardır, bu yüzden yüklemelerin belleğe sığması gerekmez. |
| Delete & Options | Delete, DeleteAsync, Options, OptionsAsync | HTTP fiil kümesinin geri kalanı, aynı eşzamanlı/async eşleşmesiyle. |
| Yanıtlar | OnHTTP2Response | İstek ve yanıt nesnelerini birlikte teslim eder; Response.DataString ve durum dahil. |
| Parçalı gövdeler | OnHTTP2ResponseFragment | Parçalı bir yanıtın her parçası geldiğinde, nihai OnHTTP2Response'tan önce tetiklenir. |
| Sunucu push | OnHTTP2PushPromise | HTTP/2 sunucu tarafından push edilen kaynakları geldikçe açığa çıkarır. |
| Bağlantı yaşam döngüsü | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | HTTP/2'nin tanımladığı bağlan, bağlantıyı kes ve akış sıfırlama sinyalleri. |
| Ayarlar | HTTP2Options, Settings | Karşı tarafa gönderilen yerel HTTP/2 SETTINGS çerçevesi değerleri. |
| Güvenilirlik | WatchDog, HeartBeat, Throttle | Otomatik yeniden bağlanma, keep-alive ve istek kısıtlama; sgc HTTP yığınının geri kalanıyla paylaşılır. |
| Kimlik doğrulama & TLS | Authentication, TLSOptions, OnHTTP2Authorization | Standart kimlik doğrulama şemaları ve TLS yapılandırması, artı özel yetkilendirme başlıkları için bir kanca. |
| Bağımlılık | sgcCustomIndy | ALPN, TLS el sıkışması sırasında h2 protokolünü müzakere eder; standart Indy kitaplığı bunu yapamaz. |
TsgcGRPCClient, Protocol Buffers yüklerini HTTP/2 istemcisinin çoğullanmış akışları üzerinden taşır; bu yüzden dört gRPC çağrı biçiminin tümünü kapsar.
| Yetenek | API | Notlar |
|---|---|---|
| Taşıma | Client | Bir TsgcHTTP2Client örneği; gRPC istemcisi kendi bağlantısını açmak yerine bunun üzerinde ilerler. |
| Unary RPC | Call, CallAsync, CallString | Bir istek, bir yanıt. Call bloklar ve bir TsgcGRPCResponse döndürür; CallAsync bunu OnGRPCResponse üzerinden teslim eder. |
| Sunucu akışı | ServerStreamingCall | Bir istek, OnGRPCStreamMessage üzerinden OnGRPCStreamEnd'e kadar teslim edilen bir yanıt akışı. |
| İstemci akışı | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | Bir istek akışı, akış kapandığında tek bir nihai yanıt. |
| Çift yönlü akış | OpenBidiStream, SendBidiMessage, CloseBidiStream | Her iki taraf da aynı çağrı üzerinden bağımsız olarak akış yapar. |
| İptal | CancelCall | Devam eden bir çağrıyı akış kimliğine göre iptal eder. |
| Yanıtlar | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse, StatusCode, Data/DataString, Headers ve Trailers taşır. |
| Hatalar | OnGRPCError, OnGRPCException | gRPC durum kodu hataları ve taşıma düzeyi istisnaları, ayrı olarak teslim edilir. |
| Meta veri | DefaultMetadata, OnGRPCBeforeRequest | Çağrı başına ve varsayılan gRPC meta veri başlıkları. |
| Dayanıklılık | RetryPolicy, Interceptors, ServiceConfig | Tekil çağrı noktalarına dokunmadan yeniden deneme davranışı, çapraz kesen bir interceptor zinciri ve hizmet yapılandırması. |
| Gözlemlenebilirlik | MetricsCollector | İstemci için çağrı metriklerini toplar. |
| Bağımlılık | sgcCustomIndy | Üzerine kurulu olduğu HTTP/2 istemcisinden devralınır; ALPN aynı şekilde gereklidir. |
Bir Google servis hesabıyla kimlik doğrulayan ve düz HTTPS üzerinden ulaşılan üç kod-yalnızca sınıf. Hiçbiri sgcCustomIndy'ye ihtiyaç duymaz.
| Yetenek | API | Notlar |
|---|---|---|
| Kimlik doğrulama | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | Servis hesabı JWT'si: proje kimliği, istemci e-postası ve özel anahtar. Üç istemcide de paylaşılan şekil. |
| Pub/Sub: yayınlama & çekme | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Bir konuya mesaj gönderin, bir abonelikten çekin ve onaylayın. |
| Pub/Sub: konular | CreateTopic, DeleteTopic, GetTopic, ListTopics | Konuları doğrudan koddan yönetin. |
| Pub/Sub: abonelikler | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Onay süresi ve push yapılandırması değişiklikleri dahil, tam abonelik yaşam döngüsü. |
| Pub/Sub: anlık görüntüler | CreateSnapshot, DeleteSnapshot, ListSnapshots | Sonradan yeniden oynatmak üzere bir aboneliğin onay durumunun anlık görüntüsünü alın. |
| Calendar: takvimler | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Google Calendar API v3 takvim listesini sarmalar. |
| Calendar: etkinlikler | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Belirli bir takvimde etkinlik oluşturun, değiştirin ve kaldırın. |
| Calendar: senkronizasyon | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Son senkronizasyondan bu yana değişen takvimler ve etkinlikler için artımlı senkronizasyon kancaları. |
| FCM: push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. Tek bir çağrı, bir projeye Firebase Cloud Messaging v1 yükü gönderir. |
| TLS ve günlükleme | TLSOptions, LogFile | Üç Google Cloud istemcisinin tümünde paylaşılır. |
Hat üzerinde kamuya açık standartlar ve desteklenen her derleyicide aynı kaynak kodu.
| Alan | Ayrıntı |
|---|---|
| HTTP/2 | RFC 9113, HPACK başlık sıkıştırması ve ALPN protokol müzakeresiyle. |
| gRPC | gRPC tel protokolünü izleyerek, HTTP/2 akışları üzerinden Protocol Buffers yükleri. |
| Google Cloud | Pub/Sub REST API'si, Google Calendar API v3 ve Firebase Cloud Messaging HTTP v1 API'si, hepsi bir Google servis hesabıyla kimlik doğrulanır. |
| Platformlar | Beş sınıfın tümü için Windows Win32, Windows Win64, Linux64, macOS, iOS ve Android. |
| Bağımlılık | HTTP/2 ve gRPC istemcileri, ALPN için sgcCustomIndy'ye ihtiyaç duyar. Google Cloud istemcileri yalnızca pakete dahil Core çalışma zamanına ihtiyaç duyar. |
| Derleyiciler | Delphi ve C++ Builder 7'den 13'e. |
| Sürümler | HTTP/2 ayrıca sgcWebSockets içinde Professional sürümünden itibaren, gRPC Enterprise'dan itibaren ve Google Cloud istemcileri Standard'dan itibaren gelir. |
| Lisanslama | Bağımsız. sgcWebSockets Core çalışma zamanı pakete dahildir ve tam kaynak kodu içerilir. |