sgcHTTP'nin yaptığı her şey; HTTP sunucusu, FastCGI / SCGI ağ geçidi, 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.
Uç noktalar, statik dosyalar, oturumlar, TLS
PHP ve Python sunucunuzun arkasında
Ç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 sunucusu, TsgcHTTPServer, bu çalışma zamanının bir parçasıdır.
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 her zaman dahildir ve gösterilen sgcHTTP fiyatı bunu zaten kapsar. Üç Google Cloud istemcisi düz HTTPS'tir ve buna ihtiyaç duymaz. RAD Studio ile birlikte gelen standart Indy ile çalışan FastCGI / SCGI ağ geçidi de duymaz.
SGC HTTP palet sayfasında dört bileşen ve üç kod-yalnızca Google Cloud sınıfı. HTTP sunucusu, pakete dahil Core çalışma zamanının sgcHTTP_Server biriminde, FastCGI / SCGI ağ geçidi sgcHTTP_Gateway biriminde, diğer her şey sgcHTTP biriminde tanımlanmıştır.
| Bileşen | Sınıf | Palette mi? | Açıklama |
|---|---|---|---|
| HTTP Sunucusu | TsgcHTTPServer | Evet | HTTP sunucusu: istek olayları, belge kök dizininden statik dosyalar, sıkıştırma, keep-alive, oturumlar, yüklemeler, TLS ve kimlik doğrulama. Core çalışma zamanıyla birlikte gelir. |
| FastCGI / SCGI Ağ Geçidi | TsgcHTTPGateway | Evet | HTTP sunucusunun aldığı istekleri TCP üzerinden PHP-FPM veya bir Python SCGI sunucusu gibi FastCGI ve SCGI uygulama sunucularına iletir. sgcHTTP_Gateway birimi. Standart Indy, sgcCustomIndy gerekmez. |
| 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. |
TsgcHTTPServer, HTTP uç noktalarını ve statik dosyaları kendi uygulamanızdan yayımlar. sgcWebSockets WebSocket sunucusuyla aynı motordur, yalnızca WebSocket kısmı yoktur ve pakete dahil Core çalışma zamanıyla birlikte gelir.
| Yetenek | API | Notlar |
|---|---|---|
| Dinleme | Port, Bindings, Active | Portu ayarlayın ya da belirli adreslere bağlanın, ardından sunucuyu etkinleştirin. |
| İstekler | OnCommandGet, OnCommandOther | Her istek, istek ve yanıt nesneleriyle birlikte kodunuza ulaşır. OnCommandOther, PUT ve DELETE gibi fiilleri kapsar. |
| Statik dosyalar | DocumentRoot | Gösterdiğiniz klasördeki statik dosyaları döndürür. |
| Sıkıştırma | HTTPCompression | Yanıt sıkıştırma seçenekleri. |
| Bağlantılar | KeepAlive, MaxConnections | Bağlantıları istekler arasında açık tutun ve aynı anda kaç tanesinin açık olacağını sınırlayın. |
| Oturumlar | SessionState, AutoStartSession, SessionTimeOut, OnSessionStart, OnSessionEnd | Zaman aşımlı sunucu tarafı oturumlar, ayrıca başlangıç ve bitiş olayları. |
| İstek sınırları | MaxRequestBodySize | İstek gövdesinin boyutunu sınırlar. |
| Yüklemeler | HTTPUploadFiles | Yüklenen dosyaları seçtiğiniz bir dizine kaydeder. |
| TLS | SSL, SSLOptions | Kendi sertifikanızla HTTPS sunun. |
| Kimlik doğrulama | Authentication, OnAuthentication | Bir istek sunulmadan önce kimlik bilgilerini kendi kodunuzda doğrulayın. |
| İş parçacıkları | ThreadPool, ThreadPoolOptions | Her bağlantı için yeni bir iş parçacığı oluşturmak yerine havuzdaki çalışan iş parçacıklarını yeniden kullanın. |
| Çalışma zamanı | sgcWebSockets Core | Pakete dahil Core çalışma zamanının sgcHTTP_Server biriminde, SGC HTTP palet sayfasında tanımlanmıştır. |
TsgcHTTPGateway, TsgcHTTPServer veya TsgcWebSocketHTTPServer tarafından alınan istekleri TCP üzerinden FastCGI ve SCGI uygulama sunucularına iletir. Apache mod_proxy_fcgi ve mod_proxy_scgi ya da nginx fastcgi_pass ve scgi_pass işini yapar, böylece PHP ve Python uygulamaları, önünde Apache veya nginx olmadan Delphi sunucunuzdan sunulur.
| Yetenek | API | Notlar |
|---|---|---|
| Arka uçlar | FastCGI, SCGI | PHP-FPM veya php-cgi -b üzerinden PHP ve bir SCGI ya da FastCGI sunucusunun, örneğin flup'un, sunduğu Python uygulamaları. |
| İstekler | Process | Sunucunun OnCommandGet ve OnCommandOther olaylarından çağırın. Bir işleyici eşleşip yanıt doldurulduğunda true, isteğe kendi kodunuz yanıt verdiğinde false döndürür. |
| İşleyiciler | Handlers.Add | Handlers.Add('*.php', 'fcgi://127.0.0.1:9000') veya Handlers.Add('/app/', 'scgi://127.0.0.1:4000'). Bir işleyici uzantıya (*.php), öneke (/app/) veya tam yola göre eşleşir. |
| İşleyici ayarları | Path, URL, Protocol, Host, Port, DocumentRoot, Enabled | Her işleyiciyi arka ucuna tek bir URL ile ya da protokol, ana makine ve port ile yönlendirin ve arka ucun belge kök dizinini ayarlayın. |
| CGI ortamı | SCRIPT_NAME, PATH_INFO, SCRIPT_FILENAME, QUERY_STRING, REMOTE_ADDR, HTTPS | RFC 3875'e göre oluşturulur ve her istek başlığı bir HTTP_* değişkeni olarak iletilir. |
| Ek değişkenler | Environment, OnBeforeRequest | Değişkenleri işleyici başına Environment ile ya da istek başına OnBeforeRequest içinde ekleyin. |
| Yanıtlar | CGI yanıtı | Status başlığını, Location yönlendirmelerini, yanıt başlıklarını ve gövdeyi ayrıştırır. Birden çok Set-Cookie başlığının hepsi korunur. |
| Ağ geçidi hataları | OnError | 502 Bad Gateway, FastCGI arka ucu aşırı yüklendiğinde 503 Service Unavailable ve 504 Gateway Timeout, her biri OnError içinde bildirilir. |
| Arka uç hataları | OnStdErr | FastCGI arka ucunun gönderdiği stderr çıktısını iletir. |
| Bağlantılar | ConnectTimeout, ReadTimeout, KeepAlive, MaxIdleConnections | İşleyici başına zaman aşımları ve FastCGI için isteğe bağlı bir keep-alive bağlantı havuzu (FCGI_KEEP_CONN), varsayılan olarak kapalıdır. SCGI her istek için bir bağlantı açar. |
| FastCGI rolü | Responder | FastCGI Responder rolü. İstekler bir bağlantı üzerinde çoğullanmaz. |
| Güvenlik | Yerleşik | Bir Proxy istek başlığı asla HTTP_PROXY olarak iletilmez (httpoxy), .. içeren yollar 403 ile reddedilir ve adında alt çizgi bulunan başlıklar yok sayılır. |
| Sınırlamalar | TCP, arabelleğe alınmış | Yalnızca TCP arka uçları desteklenir, Unix etki alanı soketleri henüz desteklenmez. Arka uç süreci zaten çalışıyor olmalıdır, ağ geçidi onu başlatmaz. Yanıtlar arabelleğe alınır, bu yüzden server-sent events gibi akış desteklenmez. |
| Bağımlılık | Standart Indy | RAD Studio ile birlikte gelen Indy kitaplığıyla çalışır, sgcCustomIndy gerekmez. Windows ve Linux. |
| Birim ve demo | sgcHTTP_Gateway | SGC HTTP palet sayfasında. Demo Demos.HTTP_Protocol8.FastCGI_SCGI_Gateway içindedir. |
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 sunucusu | TsgcHTTPServer aracılığıyla HTTP istekleri ve yanıtları, statik dosyalar, oturumlar ve HTTPS. |
| FastCGI / SCGI | FastCGI Responder rolü ve TCP üzerinden SCGI, CGI ortamı RFC 3875'e göre oluşturularak, TsgcHTTPGateway aracılığıyla. |
| 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ş istemci sınıfının tümü için Windows Win32, Windows Win64, Linux64, macOS, iOS ve Android. FastCGI / SCGI ağ geçidi Windows ve Linux'ta çalışır. |
| 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. FastCGI / SCGI ağ geçidi RAD Studio ile birlikte gelen standart Indy ile çalışır ve sgcCustomIndy'ye ihtiyaç duymaz. |
| Derleyiciler | Delphi ve C++ Builder 7'den 13'e. |
| Sürümler | HTTP/2, gRPC ve FastCGI / SCGI ağ geçidi ayrıca sgcWebSockets içinde Enterprise sürümünden itibaren ve Google Cloud istemcileri Standard'dan itibaren gelir. HTTP sunucusu Core çalışma zamanının parçasıdır, bu yüzden her sgcWebSockets sürümü onu da içerir. |
| Lisanslama | Bağımsız. sgcWebSockets Core çalışma zamanı pakete dahildir ve tam kaynak kodu içerilir. |