sgcHTTP: Delphi & C++ Builder 向け HTTP Server, HTTP/2, gRPC & Google Cloud コンポーネント

TsgcHTTPServer は、Delphi または C++ Builder のアプリケーションを HTTP サーバーに変えます。Port を設定し、OnCommandGet を処理して、Active を true にするだけで、すべてのリクエストがリクエストオブジェクトとレスポンスオブジェクトとともにコードに届きます。PUT や DELETE などのメソッドは OnCommandOther が受け持ちます。DocumentRoot をフォルダーに向ければ、サーバーはそこから静的ファイルを返します。HTTPCompression はレスポンスを圧縮し、KeepAlive は接続を再利用し、SessionState と OnSessionStart、OnSessionEnd でセッションを追跡し、MaxRequestBodySize でリクエストボディのサイズを制限し、HTTPUploadFiles はアップロードされたファイルをディスクに保存します。本番運用では、SSL と SSLOptions で TLS を有効にし、Authentication と OnAuthentication でエンドポイントを保護し、ThreadPool と MaxConnections でスケーリングを制御します。これは sgcWebSockets の WebSocket サーバーと同じエンジンから WebSocket の部分を除いたもので、同梱の Core ランタイムに含まれています。

TsgcHTTPGateway は、TsgcHTTPServer または TsgcWebSocketHTTPServer が受け取ったリクエストを、TCP 経由で FastCGI と SCGI のアプリケーションサーバーに転送します。PHP は PHP-FPM または php-cgi -b 経由で、Python アプリケーションは flup などの SCGI または FastCGI サーバー経由で動かせます。Apache の mod_proxy_fcgi と mod_proxy_scgi、あるいは nginx の fastcgi_pass と scgi_pass の役割を果たすため、Delphi サーバーの前段に Apache や nginx は不要です。Handlers.Add('*.php', 'fcgi://127.0.0.1:9000') や Handlers.Add('/app/', 'scgi://127.0.0.1:4000') のようにハンドラーを登録すると、拡張子、プレフィックス、完全一致のパスで照合されます。あとは OnCommandGet と OnCommandOther から Process を呼び出すだけです。ハンドラーが一致してレスポンスが設定されたときは true を、独自のコードがリクエストに応答するときは false を返します。ゲートウェイは RFC 3875 の CGI 環境を構築し、ステータス、リダイレクト、すべての Set-Cookie ヘッダーを含む CGI レスポンスを解析します。バックエンドが失敗したときは 502、503、504 を返し、OnError で通知します。RAD Studio に同梱されている標準の Indy で動作し、Windows と Linux に対応します。

TsgcHTTP2Client は HTTP/2(RFC 9113)を話します。複数のリクエストが独立したストリームとして 1 つの TCP 接続を共有するため、1 つの遅いレスポンスが他をブロックすることはありません。ヘッダーは HPACK で圧縮され、h2 プロトコルは TLS ハンドシェイク中に ALPN で交渉されます。これが、このコンポーネントが標準の Indy ライブラリではなく sgcCustomIndy の上に構築されている理由です。Connect、Get、Post、Put、Patch、Delete、Options と、すべての HTTP メソッドをカバーしており、それぞれ同期呼び出しと Async の対を備えています。イベントが接続のライフサイクルを伝えます: OnHTTP2Connect、OnHTTP2Response、チャンク化されたボディ向けの OnHTTP2ResponseFragment、サーバープッシュ向けの OnHTTP2PushPromise、OnHTTP2GoAway、OnHTTP2Disconnect です。HTTP2Options がローカルの SETTINGS フレームを設定し、TLSOptions と Authentication は sgc HTTP スタックの他の部分から引き継がれます。

TsgcGRPCClient は HTTP/2 クライアントの上に構築されているため、多重化された接続を引き継ぎ、その上に gRPC のワイヤーフォーマットを追加します。HTTP/2 ストリーム上を流れる、長さプレフィックス付きの Protocol Buffers メッセージです。Call と CallAsync が単項 RPC をカバーし、ServerStreamingCall が 1 つのリクエストに対するレスポンスのストリームを処理し、OpenClientStream/SendStreamMessage/CloseClientStream と OpenBidiStream/SendBidiMessage/CloseBidiStream が、クライアントストリーミングと双方向ストリーミングの RPC をカバーします。OnGRPCResponse、OnGRPCStreamMessage、OnGRPCStreamEnd が通信内容を届け、RetryPolicy、Interceptors、ServiceConfig が、呼び出し箇所に手を加えることなくリトライ動作、横断的なロジック、サービス設定を追加します。土台となる HTTP/2 クライアントと同様、ALPN のために sgcCustomIndy を必要とします。

さらに 3 つのクラスが、Google サービスアカウントで認証された素の HTTPS 経由で Google Cloud サービスに到達します。いずれも sgcCustomIndy を必要としません。TsgcHTTPGoogleCloud_PubSub_Client はメッセージの発行とプル、トピック・サブスクリプション・スナップショットの管理を行います。Publish、Pull、Acknowledge、CreateTopic、CreateSubscription、そのほか Pub/Sub REST サーフェス全体です。TsgcHTTPGoogleCloud_Calendar_Client は Google Calendar API v3 をラップします。NewCalendar、NewEvent、LoadEvents、LoadCalendars、そして同期用の OnGetCalendar と OnGetCalendarEvent イベントです。TsgcHTTPGoogleCloud_FCM_Client は、SendMessage という 1 回の呼び出しで Firebase プロジェクトにプッシュ通知ペイロードを送信します。3 つとも、生成して GoogleCloudOptions を設定し、メソッドを呼び出すだけのコードオンリーのクラスです。