Wszystko, co robi sgcHTTP, rozpisane na serwer HTTP, bramę FastCGI / SCGI, klienta HTTP/2, klienta gRPC oraz trzy klienty Google Cloud. Każda funkcja działa tak samo w Delphi i C++ Builder, a każda licencja zawiera pełny kod źródłowy. Podstrony komponentów nie są jeszcze opublikowane przy tej premierze, każdy wpis poniżej jest samodzielny na tej stronie.
Punkty końcowe, pliki statyczne, sesje, TLS
PHP i Python za Twoim serwerem
Multipleksowane strumienie, HPACK, ALPN
RPC unarne i strumieniowe
Pub/Sub, Calendar i FCM
Delphi od 7 do 13, C++ Builder
sgcHTTP jest samowystarczalny. Jest dostarczany z dołączonym środowiskiem uruchomieniowym sgcWebSockets Core, więc nie jest dodatkiem. Serwer HTTP, TsgcHTTPServer, jest częścią tego środowiska.
HTTP/2 i gRPC potrzebują sgcCustomIndy. Obie klasy wymagają ALPN do negocjacji protokołu TLS, czego standardowa biblioteka Indy nie obsługuje, więc są zamiast tego zbudowane na sgcCustomIndy. Jest zawsze wliczony w twoje zamówienie, a wyświetlana cena sgcHTTP już go obejmuje. Trzy klienty Google Cloud to zwykłe HTTPS i go nie potrzebują. Nie potrzebuje go także brama FastCGI / SCGI, która działa ze standardowym Indy dostarczanym z RAD Studio.
Cztery komponenty na stronie palety SGC HTTP oraz trzy klasy Google Cloud dostępne wyłącznie z kodu. Serwer HTTP jest zadeklarowany w module sgcHTTP_Server dołączonego środowiska Core, brama FastCGI / SCGI w module sgcHTTP_Gateway, wszystko pozostałe w module sgcHTTP.
| Komponent | Klasa | Paleta? | Opis |
|---|---|---|---|
| Serwer HTTP | TsgcHTTPServer | Tak | Serwer HTTP: zdarzenia żądań, pliki statyczne z katalogu głównego dokumentów, kompresja, keep-alive, sesje, przesyłanie plików, TLS i uwierzytelnianie. Dostarczany ze środowiskiem Core. |
| Brama FastCGI / SCGI | TsgcHTTPGateway | Tak | Przekazuje żądania odebrane przez serwer HTTP do serwerów aplikacji FastCGI i SCGI przez TCP, takich jak PHP-FPM lub serwer Python SCGI. Moduł sgcHTTP_Gateway. Standardowe Indy, sgcCustomIndy nie jest potrzebny. |
| Klient HTTP/2 | TsgcHTTP2Client | Tak | Natywny klient HTTP/2: multipleksowane strumienie, kompresja nagłówków HPACK, negocjacja ALPN. Wymaga sgcCustomIndy. |
| Klient gRPC | TsgcGRPCClient | Tak | Klient gRPC zbudowany na kliencie HTTP/2: RPC unarne, strumieniowane po stronie serwera, po stronie klienta i dwukierunkowe. Wymaga sgcCustomIndy. |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | Nie, tylko kod | API REST Google Cloud Pub/Sub: tematy, subskrypcje, migawki, publikowanie i pobieranie. Zwykłe HTTPS na Core. |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | Nie, tylko kod | Google Calendar API v3: kalendarze i wydarzenia, tworzenie, aktualizacja, listowanie, usuwanie. Zwykłe HTTPS na Core. |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | Nie, tylko kod | Firebase Cloud Messaging HTTP v1 API: wyślij ładunek powiadomienia push jednym wywołaniem. Zwykłe HTTPS na Core. |
TsgcHTTPServer publikuje punkty końcowe HTTP i pliki statyczne z twojej własnej aplikacji. To ten sam silnik co serwer WebSocket sgcWebSockets, bez części WebSocket, i jest dostarczany z dołączonym środowiskiem uruchomieniowym Core.
| Funkcja | API | Uwagi |
|---|---|---|
| Nasłuchiwanie | Port, Bindings, Active | Ustaw port albo powiąż serwer z wybranymi adresami, a następnie aktywuj serwer. |
| Żądania | OnCommandGet, OnCommandOther | Każde żądanie trafia do twojego kodu wraz z obiektami żądania i odpowiedzi. OnCommandOther obsługuje metody takie jak PUT i DELETE. |
| Pliki statyczne | DocumentRoot | Zwraca pliki statyczne z folderu, na który go wskażesz. |
| Kompresja | HTTPCompression | Opcje kompresji odpowiedzi. |
| Połączenia | KeepAlive, MaxConnections | Utrzymuj połączenia otwarte między żądaniami i ogranicz, ile ich może być otwartych jednocześnie. |
| Sesje | SessionState, AutoStartSession, SessionTimeOut, OnSessionStart, OnSessionEnd | Sesje po stronie serwera z limitem czasu oraz zdarzeniami rozpoczęcia i zakończenia. |
| Limity żądań | MaxRequestBodySize | Ogranicza rozmiar treści żądania. |
| Przesyłanie plików | HTTPUploadFiles | Zapisuje przesłane pliki w wybranym przez ciebie katalogu. |
| TLS | SSL, SSLOptions | Obsługuj HTTPS z własnym certyfikatem. |
| Uwierzytelnianie | Authentication, OnAuthentication | Weryfikuj dane logowania we własnym kodzie, zanim żądanie zostanie obsłużone. |
| Wątki | ThreadPool, ThreadPoolOptions | Wykorzystuj ponownie wątki robocze z puli zamiast tworzyć jeden na połączenie. |
| Środowisko | sgcWebSockets Core | Zadeklarowany w module sgcHTTP_Server dołączonego środowiska Core, na stronie palety SGC HTTP. |
TsgcHTTPGateway przekazuje żądania odebrane przez TsgcHTTPServer lub TsgcWebSocketHTTPServer do serwerów aplikacji FastCGI i SCGI przez TCP. Pełni zadanie Apache mod_proxy_fcgi i mod_proxy_scgi albo nginx fastcgi_pass i scgi_pass, więc aplikacje PHP i Python są serwowane z Twojego serwera Delphi, bez Apache ani nginx z przodu.
| Możliwość | API | Uwagi |
|---|---|---|
| Backendy | FastCGI, SCGI | PHP przez PHP-FPM lub php-cgi -b oraz aplikacje Python obsługiwane przez serwer SCGI lub FastCGI, na przykład flup. |
| Żądania | Process | Wywołuj go ze zdarzeń serwera OnCommandGet i OnCommandOther. Zwraca true, gdy pasował handler i odpowiedź jest wypełniona, oraz false, gdy na żądanie odpowiada Twój własny kod. |
| Handlery | Handlers.Add | Handlers.Add('*.php', 'fcgi://127.0.0.1:9000') lub Handlers.Add('/app/', 'scgi://127.0.0.1:4000'). Handler dopasowuje się po rozszerzeniu (*.php), po prefiksie (/app/) lub po dokładnej ścieżce. |
| Ustawienia handlera | Path, URL, Protocol, Host, Port, DocumentRoot, Enabled | Wskaż każdemu handlerowi jego backend jednym adresem URL albo protokołem, hostem i portem, oraz ustaw katalog główny dokumentów backendu. |
| Środowisko CGI | SCRIPT_NAME, PATH_INFO, SCRIPT_FILENAME, QUERY_STRING, REMOTE_ADDR, HTTPS | Budowane zgodnie z RFC 3875, a każdy nagłówek żądania jest przekazywany jako zmienna HTTP_*. |
| Dodatkowe zmienne | Environment, OnBeforeRequest | Dodawaj zmienne dla każdego handlera przez Environment albo dla każdego żądania w OnBeforeRequest. |
| Odpowiedzi | Odpowiedź CGI | Parsuje nagłówek Status, przekierowania Location, nagłówki odpowiedzi i treść. Wszystkie nagłówki Set-Cookie są zachowywane. |
| Błędy bramy | OnError | 502 Bad Gateway, 503 Service Unavailable, gdy backend FastCGI jest przeciążony, oraz 504 Gateway Timeout, każdy zgłaszany w OnError. |
| Błędy backendu | OnStdErr | Dostarcza dane stderr wysyłane przez backend FastCGI. |
| Połączenia | ConnectTimeout, ReadTimeout, KeepAlive, MaxIdleConnections | Limity czasu dla każdego handlera oraz opcjonalna pula połączeń keep-alive dla FastCGI (FCGI_KEEP_CONN), domyślnie wyłączona. SCGI otwiera jedno połączenie na żądanie. |
| Rola FastCGI | Responder | Rola Responder FastCGI. Żądania nie są multipleksowane w jednym połączeniu. |
| Bezpieczeństwo | Wbudowane | Nagłówek żądania Proxy nigdy nie jest przekazywany jako HTTP_PROXY (httpoxy), ścieżki zawierające .. są odrzucane z kodem 403, a nagłówki z podkreśleniami w nazwie są ignorowane. |
| Ograniczenia | TCP, buforowanie | Obsługiwane są tylko backendy TCP, gniazda domeny Unix nie są jeszcze wspierane. Proces backendu musi już działać, brama go nie uruchamia. Odpowiedzi są buforowane, więc strumieniowanie, takie jak server-sent events, nie jest obsługiwane. |
| Zależność | Standardowe Indy | Działa z biblioteką Indy dostarczaną z RAD Studio, sgcCustomIndy nie jest potrzebny. Windows i Linux. |
| Moduł i demo | sgcHTTP_Gateway | Na stronie palety SGC HTTP. Demo znajduje się w Demos.HTTP_Protocol8.FastCGI_SCGI_Gateway. |
TsgcHTTP2Client mówi w HTTP/2 (RFC 9113) przez jedno połączenie TLS, negocjowane przez ALPN, dlatego jest zbudowany na sgcCustomIndy.
| Możliwość | API | Uwagi |
|---|---|---|
| Połączenie | Host, Port, Active | Jedno połączenie TLS przenosi każdy multipleksowany strumień żądań. |
| Nawiązanie połączenia | Connect, ConnectAsync | Otwiera połączenie i opcjonalnie wysyła żądanie w tym samym wywołaniu. |
| Odczyt | Get, GetAsync | Wywołanie synchroniczne albo fire-and-forget z odpowiedzią dostarczaną przez zdarzenie. |
| Zapis | Post, PostAsync, Put, PutAsync, Patch, PatchAsync | Treści żądań to strumienie, więc przesyłane dane nie muszą mieścić się w pamięci. |
| Delete i Options | Delete, DeleteAsync, Options, OptionsAsync | Reszta zestawu czasowników HTTP, ten sam schemat synchroniczny/asynchroniczny. |
| Odpowiedzi | OnHTTP2Response | Dostarcza obiekty żądania i odpowiedzi razem, w tym Response.DataString i status. |
| Treści fragmentowane (chunked) | OnHTTP2ResponseFragment | Uruchamia się przy nadejściu każdego fragmentu odpowiedzi typu chunked, przed finalnym OnHTTP2Response. |
| Server push | OnHTTP2PushPromise | Ujawnia zasoby wypychane przez serwer HTTP/2 (server push) w miarę ich nadejścia. |
| Cykl życia połączenia | OnHTTP2Connect, OnHTTP2Disconnect, OnHTTP2GoAway, OnHTTP2RSTStream | Sygnały połączenia, rozłączenia i resetu strumienia zdefiniowane przez HTTP/2. |
| Ustawienia | HTTP2Options, Settings | Wartości lokalnej ramki SETTINGS protokołu HTTP/2 wysyłane do peera. |
| Niezawodność | WatchDog, HeartBeat, Throttle | Automatyczne ponowne łączenie, keep-alive i ograniczanie liczby żądań, wspólne z resztą stosu sgc HTTP. |
| Uwierzytelnianie i TLS | Authentication, TLSOptions, OnHTTP2Authorization | Standardowe schematy uwierzytelniania i konfiguracja TLS, a także hak do niestandardowych nagłówków autoryzacji. |
| Zależność | sgcCustomIndy | ALPN negocjuje protokół h2 podczas uzgadniania TLS; standardowa biblioteka Indy nie potrafi tego zrobić. |
TsgcGRPCClient przenosi ładunki Protocol Buffers przez multipleksowane strumienie klienta HTTP/2, dzięki czemu obejmuje wszystkie cztery kształty wywołań gRPC.
| Możliwość | API | Uwagi |
|---|---|---|
| Transport | Client | Instancja TsgcHTTP2Client; klient gRPC jeździ na niej, zamiast otwierać własne połączenie. |
| RPC unarne | Call, CallAsync, CallString | Jedno żądanie, jedna odpowiedź. Call blokuje i zwraca TsgcGRPCResponse; CallAsync dostarcza ją przez OnGRPCResponse. |
| Strumieniowanie po stronie serwera | ServerStreamingCall | Jedno żądanie, strumień odpowiedzi dostarczanych przez OnGRPCStreamMessage aż do OnGRPCStreamEnd. |
| Strumieniowanie po stronie klienta | OpenClientStream, SendStreamMessage, CloseClientStream, CloseClientStreamAsync | Strumień żądań, jedna ostateczna odpowiedź po zamknięciu strumienia. |
| Strumieniowanie dwukierunkowe | OpenBidiStream, SendBidiMessage, CloseBidiStream | Obie strony strumieniują niezależnie w ramach tego samego wywołania. |
| Anulowanie | CancelCall | Anuluje trwające wywołanie po identyfikatorze jego strumienia. |
| Odpowiedzi | OnGRPCResponse, OnGRPCStreamMessage, OnGRPCStreamEnd | TsgcGRPCResponse niesie StatusCode, Data/DataString, Headers i Trailers. |
| Błędy | OnGRPCError, OnGRPCException | Błędy kodu statusu gRPC i wyjątki na poziomie transportu, dostarczane osobno. |
| Metadane | DefaultMetadata, OnGRPCBeforeRequest | Nagłówki metadanych gRPC, domyślne i dla poszczególnych wywołań. |
| Odporność | RetryPolicy, Interceptors, ServiceConfig | Zachowanie ponawiania, przekrojowy łańcuch przechwytywaczy (interceptorów) i konfiguracja usługi, bez dotykania poszczególnych miejsc wywołań. |
| Obserwowalność | MetricsCollector | Zbiera metryki wywołań dla klienta. |
| Zależność | sgcCustomIndy | Odziedziczona po kliencie HTTP/2, na którym jest zbudowany; ALPN jest wymagany w ten sam sposób. |
Trzy klasy dostępne wyłącznie z kodu, uwierzytelniane kontem usługi Google i osiągane przez zwykłe HTTPS. Żadna z nich nie potrzebuje sgcCustomIndy.
| Możliwość | API | Uwagi |
|---|---|---|
| Uwierzytelnianie | GoogleCloudOptions.JWT, OnAuthToken, OnAuthTokenError | JWT konta usługi: identyfikator projektu, adres e-mail klienta i klucz prywatny. Wspólny kształt dla wszystkich trzech klientów. |
| Pub/Sub: publikowanie i pobieranie | Publish, Pull, Acknowledge, Seek | TsgcHTTPGoogleCloud_PubSub_Client. Wysyłaj wiadomości do tematu, pobieraj i potwierdzaj z subskrypcji. |
| Pub/Sub: tematy | CreateTopic, DeleteTopic, GetTopic, ListTopics | Zarządzaj tematami bezpośrednio z kodu. |
| Pub/Sub: subskrypcje | CreateSubscription, DeleteSubscripton, ListSubscriptions, ModifyAckDeadlineSubscription | Pełny cykl życia subskrypcji, w tym zmiany terminu potwierdzenia i konfiguracji push. |
| Pub/Sub: migawki | CreateSnapshot, DeleteSnapshot, ListSnapshots | Zrób migawkę stanu potwierdzeń subskrypcji do późniejszego odtworzenia. |
| Calendar: kalendarze | NewCalendar, UpdateCalendar, DeleteCalendar, LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client. Opakowuje listę kalendarzy Google Calendar API v3. |
| Calendar: wydarzenia | NewEvent, UpdateEvent, DeleteEvent, LoadEvents | Twórz, zmieniaj i usuwaj wydarzenia w danym kalendarzu. |
| Calendar: synchronizacja | LoadCalendarsChanged, LoadEventsChanged, OnGetCalendar, OnGetCalendarEvent | Haki synchronizacji przyrostowej dla kalendarzy i wydarzeń zmienionych od ostatniej synchronizacji. |
| FCM: push | SendMessage | TsgcHTTPGoogleCloud_FCM_Client. Jedno wywołanie wysyła ładunek Firebase Cloud Messaging v1 do projektu. |
| TLS i logowanie | TLSOptions, LogFile | Wspólne dla wszystkich trzech klientów Google Cloud. |
Oficjalne standardy na łączu i te same źródła we wszystkich obsługiwanych kompilatorach.
| Obszar | Szczegóły |
|---|---|
| Serwer HTTP | Żądania i odpowiedzi HTTP, pliki statyczne, sesje oraz HTTPS przez TsgcHTTPServer. |
| FastCGI / SCGI | Rola Responder FastCGI i SCGI przez TCP, ze środowiskiem CGI budowanym zgodnie z RFC 3875, przez TsgcHTTPGateway. |
| HTTP/2 | RFC 9113, z kompresją nagłówków HPACK i negocjacją protokołu ALPN. |
| gRPC | Ładunki Protocol Buffers przesyłane strumieniami HTTP/2, zgodnie z protokołem transmisji gRPC. |
| Google Cloud | API REST Pub/Sub, Google Calendar API v3 oraz Firebase Cloud Messaging HTTP v1 API, wszystkie uwierzytelniane kontem usługi Google. |
| Platformy | Windows Win32, Windows Win64, Linux64, macOS, iOS i Android dla wszystkich pięciu klas klienckich. Brama FastCGI / SCGI działa w systemach Windows i Linux. |
| Zależność | Klient HTTP/2 i klient gRPC potrzebują sgcCustomIndy dla ALPN. Klienty Google Cloud potrzebują tylko dołączonego środowiska uruchomieniowego Core. Brama FastCGI / SCGI działa ze standardowym Indy dostarczanym z RAD Studio i nie potrzebuje sgcCustomIndy. |
| Kompilatory | Delphi i C++ Builder od 7 do 13. |
| Edycje | HTTP/2, gRPC i brama FastCGI / SCGI są dostarczane także wewnątrz sgcWebSockets od edycji Enterprise wzwyż, a klienty Google Cloud od edycji Standard wzwyż. Serwer HTTP jest częścią środowiska uruchomieniowego Core, więc zawiera go także każda edycja sgcWebSockets. |
| Licencjonowanie | Produkt samodzielny. Środowisko uruchomieniowe sgcWebSockets Core jest dołączone, a pełny kod źródłowy jest w zestawie. |