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

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 を設定し、メソッドを呼び出すだけのコードオンリーのクラスです。