sgcHTTP: Delphi ve C++ Builder için HTTP Sunucusu, HTTP/2, gRPC ve Google Cloud Bileşenleri

TsgcHTTPServer, Delphi veya C++ Builder uygulamanızı bir HTTP sunucusuna dönüştürür. Port'u ayarlayın, OnCommandGet'i işleyin, Active'i true yapın; her istek, istek ve yanıt nesneleriyle birlikte kodunuza ulaşır, OnCommandOther ise PUT ve DELETE gibi fiilleri kapsar. DocumentRoot'u bir klasöre yönlendirin, sunucu statik dosyaları oradan döndürür. HTTPCompression yanıtları sıkıştırır, KeepAlive bağlantıları yeniden kullanır, OnSessionStart ve OnSessionEnd ile birlikte SessionState oturumları izler, MaxRequestBodySize istek gövdelerini sınırlar ve HTTPUploadFiles yüklenen dosyaları diske kaydeder. Üretim için SSL ve SSLOptions TLS'i etkinleştirir, Authentication ve OnAuthentication uç noktalarınızı korur, ThreadPool ve MaxConnections ise ölçeklenmesini denetler. sgcWebSockets WebSocket sunucusuyla aynı motordur, yalnızca WebSocket kısmı yoktur ve pakete dahil Core çalışma zamanıyla birlikte gelir.

TsgcHTTPGateway, TsgcHTTPServer veya TsgcWebSocketHTTPServer tarafından alınan istekleri TCP üzerinden FastCGI ve SCGI uygulama sunucularına iletir: PHP-FPM veya php-cgi -b üzerinden PHP ve flup gibi bir SCGI ya da FastCGI sunucusunun sunduğu Python uygulamaları. Apache mod_proxy_fcgi ve mod_proxy_scgi ya da nginx fastcgi_pass ve scgi_pass işini yapar, bu yüzden Delphi sunucunuzun önünde Apache veya nginx bulunmaz. İşleyicileri Handlers.Add('*.php', 'fcgi://127.0.0.1:9000') veya Handlers.Add('/app/', 'scgi://127.0.0.1:4000') ile kaydedin; uzantıya, öneke ya da tam yola göre eşleşirler. Ardından OnCommandGet ve OnCommandOther içinden Process ç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. Ağ geçidi RFC 3875 CGI ortamını oluşturur, CGI yanıtını durumu, yönlendirmeleri ve her Set-Cookie başlığıyla birlikte ayrıştırır ve bir arka uç başarısız olduğunda OnError üzerinden bildirilen 502, 503 veya 504 ile yanıt verir. RAD Studio ile birlikte gelen standart Indy ile Windows ve Linux'ta çalışır.

TsgcHTTP2Client, HTTP/2 (RFC 9113) konuşur: birden çok istek, tek bir TCP bağlantısını bağımsız akışlar olarak paylaşır, bu yüzden yavaş bir yanıt arkasındaki diğerlerini engellemez. Başlıklar HPACK ile sıkıştırılır ve h2 protokolü, TLS el sıkışması sırasında ALPN ile müzakere edilir; bileşenin standart Indy kitaplığı yerine sgcCustomIndy üzerine kurulu olmasının nedeni de budur. Her fiil kapsanır: Connect, Get, Post, Put, Patch, Delete ve Options, her biri bir eşzamanlı çağrı ve bir Async ikizi ile. Olaylar bağlantı yaşam döngüsünü açığa çıkarır: OnHTTP2Connect, OnHTTP2Response, parçalı gövdeler için OnHTTP2ResponseFragment, sunucu push için OnHTTP2PushPromise, OnHTTP2GoAway ve OnHTTP2Disconnect. HTTP2Options, yerel ayarlar çerçevesini yapılandırır; TLSOptions ve Authentication ise sgc HTTP yığınının geri kalanından devam eder.

TsgcGRPCClient, HTTP/2 istemcisi üzerine kuruludur; bu yüzden çoğullanmış bağlantıyı devralır ve üzerine gRPC tel formatını ekler: HTTP/2 akışları üzerinden uzunluk önekli Protocol Buffers mesajları. Call ve CallAsync unary RPC'leri kapsar, ServerStreamingCall tek bir isteğe bir yanıt akışını yönetir; OpenClientStream/SendStreamMessage/CloseClientStream artı OpenBidiStream/SendBidiMessage/CloseBidiStream ise istemci akışlı ve çift yönlü akışlı RPC'leri kapsar. OnGRPCResponse, OnGRPCStreamMessage ve OnGRPCStreamEnd trafiği teslim eder; RetryPolicy, Interceptors ve ServiceConfig ise çağrı noktalarına dokunmadan yeniden deneme davranışı, çapraz kesen mantık ve hizmet yapılandırması ekler. Üzerine kurulu olduğu HTTP/2 istemcisi gibi, ALPN için sgcCustomIndy'ye ihtiyaç duyar.

Üç sınıf daha, bir Google servis hesabıyla kimlik doğrulayarak Google Cloud hizmetlerine düz HTTPS üzerinden ulaşır ve hiçbiri sgcCustomIndy'ye ihtiyaç duymaz. TsgcHTTPGoogleCloud_PubSub_Client, mesajları yayınlar ve çeker; konuları, abonelikleri ve anlık görüntüleri yönetir: Publish, Pull, Acknowledge, CreateTopic, CreateSubscription ve Pub/Sub REST yüzeyinin geri kalanı. TsgcHTTPGoogleCloud_Calendar_Client, Google Calendar API v3'ü sarmalar: NewCalendar, NewEvent, LoadEvents ve LoadCalendars; senkronizasyon için OnGetCalendar ve OnGetCalendarEvent olaylarıyla. TsgcHTTPGoogleCloud_FCM_Client, tek bir çağrıyla, SendMessage, bir Firebase projesine push bildirim yükü gönderir. Üçü de kod-yalnızca sınıflardır: birini oluşturun, GoogleCloudOptions'ı ayarlayın, metotları çağırın.