sgcHTTP でできることすべてを、HTTP サーバー、FastCGI / SCGI ゲートウェイ、HTTP/2 クライアント、gRPC クライアント、そして 3 つの Google Cloud クライアントに対応付けて示します。すべての機能は Delphi と C++ Builder で同じように動作し、すべてのライセンスに完全なソースコードが付属します。今回のローンチではコンポーネントのサブページはまだ公開されておらず、以下の各項目はこのページ内で完結しています。
エンドポイント、静的ファイル、セッション、TLS
PHP & Python をサーバーの背後で
多重化ストリーム、HPACK、ALPN
単項呼び出し & ストリーミング RPC
Pub/Sub、Calendar & FCM
Delphi 7 から 13、C++ Builder
sgcHTTP は単体で完結しています。sgcWebSockets Core ランタイムを同梱して出荷されるため、アドオンではありません。HTTP サーバーの TsgcHTTPServer は、そのランタイムの一部です。
HTTP/2 と gRPC には sgcCustomIndy が必要です。両クラスとも TLS プロトコル交渉に ALPN を必要としますが、標準の Indy ライブラリは対応していないため、代わりに sgcCustomIndy の上に構築されています。注文には常に含まれており、表示されている sgcHTTP の価格にはその分がすでに含まれています。3 つの Google Cloud クライアントは素の HTTPS で、これを必要としません。FastCGI / SCGI ゲートウェイも同様で、RAD Studio に同梱されている標準の Indy で動作します。
SGC HTTP パレットページの 4 つのコンポーネントと、コードオンリーの Google Cloud クラス 3 つ。HTTP サーバーは同梱 Core ランタイムの sgcHTTP_Server ユニットで、FastCGI / SCGI ゲートウェイは sgcHTTP_Gateway ユニットで、それ以外はすべて sgcHTTP ユニットで宣言されています。
| コンポーネント | クラス | パレット? | 説明 |
|---|---|---|---|
| HTTP サーバー | TsgcHTTPServer | あり | HTTP サーバーです。リクエストイベント、ドキュメントルートからの静的ファイル、圧縮、キープアライブ、セッション、アップロード、TLS、認証。Core ランタイムに同梱されています。 |
| FastCGI / SCGI ゲートウェイ | TsgcHTTPGateway | あり | HTTP サーバーが受け取ったリクエストを、PHP-FPM や Python の SCGI サーバーなどの FastCGI および SCGI アプリケーションサーバーへ TCP 経由で転送します。ユニットは sgcHTTP_Gateway。標準の Indy で動作し、sgcCustomIndy は不要です。 |
| HTTP/2 クライアント | TsgcHTTP2Client | あり | ネイティブの HTTP/2 クライアントです。多重化されたストリーム、HPACK によるヘッダー圧縮、ALPN 交渉。sgcCustomIndy が必要です。 |
| gRPC クライアント | TsgcGRPCClient | あり | HTTP/2 クライアントの上に構築された gRPC クライアントです。単項、サーバーストリーミング、クライアントストリーミング、双方向の各 RPC。sgcCustomIndy が必要です。 |
| Google Cloud Pub/Sub | TsgcHTTPGoogleCloud_PubSub_Client | なし、コードオンリー | Google Cloud Pub/Sub REST API です。トピック、サブスクリプション、スナップショット、発行と取得。Core 上の素の HTTPS。 |
| Google Cloud Calendar | TsgcHTTPGoogleCloud_Calendar_Client | なし、コードオンリー | Google Calendar API v3 です。カレンダーとイベントの作成・更新・一覧・削除。Core 上の素の HTTPS。 |
| Google Cloud FCM | TsgcHTTPGoogleCloud_FCM_Client | なし、コードオンリー | Firebase Cloud Messaging HTTP v1 API です。1 回の呼び出しでプッシュ通知ペイロードを送信します。Core 上の素の HTTPS。 |
TsgcHTTPServer は、お使いのアプリケーションから HTTP エンドポイントと静的ファイルを公開します。sgcWebSockets の WebSocket サーバーと同じエンジンから WebSocket の部分を除いたもので、同梱の Core ランタイムに含まれています。
| 機能 | API | 備考 |
|---|---|---|
| 待ち受け | Port, Bindings, Active | ポートを設定するか、特定のアドレスにバインドしてから、サーバーを有効にします。 |
| リクエスト | OnCommandGet, OnCommandOther | すべてのリクエストが、リクエストオブジェクトとレスポンスオブジェクトとともにコードに届きます。OnCommandOther は PUT や DELETE などのメソッドを受け持ちます。 |
| 静的ファイル | DocumentRoot | 指定したフォルダーから静的ファイルを返します。 |
| 圧縮 | HTTPCompression | レスポンス圧縮のオプションです。 |
| 接続 | KeepAlive, MaxConnections | リクエスト間で接続を開いたままにし、同時に開く接続数に上限を設けます。 |
| セッション | SessionState, AutoStartSession, SessionTimeOut, OnSessionStart, OnSessionEnd | タイムアウト付きのサーバー側セッションと、開始および終了イベントです。 |
| リクエストの制限 | MaxRequestBodySize | リクエストボディのサイズに上限を設けます。 |
| アップロード | HTTPUploadFiles | アップロードされたファイルを、指定したディレクトリに保存します。 |
| TLS | SSL, SSLOptions | 独自の証明書で HTTPS を提供します。 |
| 認証 | Authentication, OnAuthentication | リクエストを処理する前に、自分のコードで資格情報を検証します。 |
| スレッド | ThreadPool, ThreadPoolOptions | 接続ごとにスレッドを作成する代わりに、プールのワーカースレッドを再利用します。 |
| ランタイム | sgcWebSockets Core | 同梱 Core ランタイムの sgcHTTP_Server ユニットで宣言され、SGC HTTP パレットページに登録されています。 |
TsgcHTTPGateway は、TsgcHTTPServer または TsgcWebSocketHTTPServer が受け取ったリクエストを、TCP 経由で FastCGI と SCGI のアプリケーションサーバーに転送します。Apache の mod_proxy_fcgi と mod_proxy_scgi、あるいは nginx の fastcgi_pass と scgi_pass の役割を果たすため、PHP と Python のアプリケーションを、前段に Apache や nginx を置かずに Delphi サーバーから提供できます。
| 機能 | API | 備考 |
|---|---|---|
| バックエンド | FastCGI, SCGI | PHP は PHP-FPM または php-cgi -b 経由で、Python アプリケーションは flup などの SCGI または FastCGI サーバー経由で動かせます。 |
| リクエスト | Process | サーバーの OnCommandGet と OnCommandOther イベントから呼び出します。ハンドラーが一致してレスポンスが設定されたときは true を、独自のコードがリクエストに応答するときは false を返します。 |
| ハンドラー | Handlers.Add | Handlers.Add('*.php', 'fcgi://127.0.0.1:9000') や Handlers.Add('/app/', 'scgi://127.0.0.1:4000') のように登録します。ハンドラーは、拡張子 (*.php)、プレフィックス (/app/)、完全一致のパスで照合されます。 |
| ハンドラーの設定 | Path, URL, Protocol, Host, Port, DocumentRoot, Enabled | 各ハンドラーのバックエンドを 1 つの URL、またはプロトコル、ホスト、ポートで指定し、バックエンドのドキュメントルートを設定します。 |
| CGI 環境 | SCRIPT_NAME, PATH_INFO, SCRIPT_FILENAME, QUERY_STRING, REMOTE_ADDR, HTTPS | RFC 3875 に従って構築され、すべてのリクエストヘッダーが HTTP_* 変数として渡されます。 |
| 追加の変数 | Environment, OnBeforeRequest | Environment でハンドラーごとに、または OnBeforeRequest でリクエストごとに変数を追加できます。 |
| レスポンス | CGI レスポンス | Status ヘッダー、Location によるリダイレクト、レスポンスヘッダー、本文を解析します。複数の Set-Cookie ヘッダーもすべて保持されます。 |
| ゲートウェイのエラー | OnError | 502 Bad Gateway、FastCGI バックエンドが過負荷のときの 503 Service Unavailable、504 Gateway Timeout を、それぞれ OnError で通知します。 |
| バックエンドのエラー | OnStdErr | FastCGI バックエンドが送ってくる stderr の出力を受け取ります。 |
| 接続 | ConnectTimeout, ReadTimeout, KeepAlive, MaxIdleConnections | タイムアウトはハンドラーごとに設定でき、FastCGI にはオプションのキープアライブ接続プール (FCGI_KEEP_CONN) もあります。既定ではオフです。SCGI はリクエストごとに 1 つの接続を開きます。 |
| FastCGI のロール | Responder | FastCGI の Responder ロールです。リクエストは 1 つの接続上で多重化されません。 |
| セキュリティ | 組み込み | Proxy リクエストヘッダーは HTTP_PROXY として渡されることはなく (httpoxy)、.. を含むパスは 403 で拒否され、アンダースコアを含むヘッダー名は無視されます。 |
| 制限事項 | TCP、バッファリング | TCP バックエンドのみで、Unix ドメインソケットはまだサポートされていません。バックエンドのプロセスはすでに動作している必要があり、ゲートウェイは起動しません。レスポンスはバッファリングされるため、Server-Sent Events のようなストリーミングはサポートされません。 |
| 依存関係 | 標準の Indy | RAD Studio に同梱されている Indy ライブラリで動作し、sgcCustomIndy は不要です。Windows と Linux に対応します。 |
| ユニットとデモ | sgcHTTP_Gateway | SGC HTTP パレットページにあります。デモは Demos\20.HTTP_Protocol\18.FastCGI_SCGI_Gateway にあります。 |
TsgcHTTP2Client は、ALPN で交渉される 1 つの TLS 接続上で HTTP/2(RFC 9113)を話します。これが sgcCustomIndy の上に構築されている理由です。
| 機能 | API | 備考 |
|---|---|---|
| 接続 | Host、Port、Active | 1 つの TLS 接続が、多重化されたすべてのリクエストストリームを運びます。 |
| 接続開始 | Connect、ConnectAsync | 接続を開き、同じ呼び出しの中で任意のリクエストを発行します。 |
| 読み取り | Get、GetAsync | 同期呼び出し、またはイベントでレスポンスを受け取る fire-and-forget 呼び出しです。 |
| 書き込み | Post、PostAsync、Put、PutAsync、Patch、PatchAsync | リクエストボディはストリームなので、アップロードがメモリに収まる必要はありません。 |
| Delete & Options | Delete、DeleteAsync、Options、OptionsAsync | 残りの HTTP メソッド一式で、同じ同期/非同期のペア構成です。 |
| レスポンス | OnHTTP2Response | リクエストとレスポンスのオブジェクトをまとめて渡し、Response.DataString やステータスも含みます。 |
| チャンク化されたボディ | OnHTTP2ResponseFragment | チャンク化されたレスポンスの各フラグメントが届くたびに、最終的な OnHTTP2Response より前に発生します。 |
| サーバープッシュ | OnHTTP2PushPromise | HTTP/2 サーバープッシュされたリソースが届いたときに伝えます。 |
| 接続のライフサイクル | OnHTTP2Connect、OnHTTP2Disconnect、OnHTTP2GoAway、OnHTTP2RSTStream | HTTP/2 が定める接続、切断、ストリームリセットの各シグナルです。 |
| 設定 | HTTP2Options、Settings | 相手に送信するローカルの HTTP/2 SETTINGS フレームの値です。 |
| 信頼性 | WatchDog、HeartBeat、Throttle | 自動再接続、キープアライブ、リクエストのスロットリングで、sgc HTTP スタックの他の部分と共通です。 |
| 認証 & TLS | Authentication、TLSOptions、OnHTTP2Authorization | 標準的な認証方式と TLS 設定に加え、カスタム認可ヘッダー用のフックです。 |
| 依存関係 | sgcCustomIndy | ALPN が TLS ハンドシェイク中に h2 プロトコルを交渉します。標準の Indy ライブラリにはこれができません。 |
TsgcGRPCClient は Protocol Buffers のペイロードを HTTP/2 クライアントの多重化ストリーム上に載せて運ぶため、4 つの gRPC 呼び出し形式すべてをカバーします。
| 機能 | API | 備考 |
|---|---|---|
| トランスポート | Client | TsgcHTTP2Client のインスタンスです。gRPC クライアントは自身の接続を開かず、これに乗って動作します。 |
| 単項 RPC | Call、CallAsync、CallString | 1 リクエスト、1 レスポンスです。Call はブロックして TsgcGRPCResponse を返し、CallAsync は OnGRPCResponse で結果を届けます。 |
| サーバーストリーミング | ServerStreamingCall | 1 リクエストに対し、OnGRPCStreamMessage で届くレスポンスのストリームが、OnGRPCStreamEnd まで続きます。 |
| クライアントストリーミング | OpenClientStream、SendStreamMessage、CloseClientStream、CloseClientStreamAsync | リクエストのストリームがあり、ストリームが閉じたときに最終レスポンスが 1 つ返ります。 |
| 双方向ストリーミング | OpenBidiStream、SendBidiMessage、CloseBidiStream | 同じ呼び出しの中で、両側が独立してストリーミングします。 |
| キャンセル | CancelCall | ストリーム ID を指定して、進行中の呼び出しをキャンセルします。 |
| レスポンス | OnGRPCResponse、OnGRPCStreamMessage、OnGRPCStreamEnd | TsgcGRPCResponse が StatusCode、Data/DataString、Headers、Trailers を保持します。 |
| エラー | OnGRPCError、OnGRPCException | gRPC のステータスコードエラーと、トランスポートレベルの例外を別々に届けます。 |
| メタデータ | DefaultMetadata、OnGRPCBeforeRequest | 呼び出しごと、または既定の gRPC メタデータヘッダーです。 |
| 耐障害性 | RetryPolicy、Interceptors、ServiceConfig | リトライ動作、横断的なインターセプターチェーン、サービス設定を、個々の呼び出し箇所に手を加えずに追加できます。 |
| 可観測性 | MetricsCollector | クライアントの呼び出しメトリクスを収集します。 |
| 依存関係 | sgcCustomIndy | 土台となる HTTP/2 クライアントから引き継ぎ、同様に ALPN が必要です。 |
Google サービスアカウントで認証され、素の HTTPS 経由で到達する、コードオンリーの 3 クラスです。いずれも sgcCustomIndy を必要としません。
| 機能 | API | 備考 |
|---|---|---|
| 認証 | GoogleCloudOptions.JWT、OnAuthToken、OnAuthTokenError | サービスアカウントの JWT です。プロジェクト ID、クライアントメール、秘密鍵。3 つのクライアントすべてで共通の形です。 |
| Pub/Sub: 発行 & プル | Publish、Pull、Acknowledge、Seek | TsgcHTTPGoogleCloud_PubSub_Client。トピックへのメッセージ送信、サブスクリプションからのプルと確認応答。 |
| Pub/Sub: トピック | CreateTopic、DeleteTopic、GetTopic、ListTopics | コードから直接トピックを管理します。 |
| Pub/Sub: サブスクリプション | CreateSubscription、DeleteSubscripton、ListSubscriptions、ModifyAckDeadlineSubscription | ack-deadline やプッシュ設定の変更を含む、サブスクリプションのライフサイクル全体です。 |
| Pub/Sub: スナップショット | CreateSnapshot、DeleteSnapshot、ListSnapshots | 後で再生するために、サブスクリプションの確認応答状態をスナップショットします。 |
| Calendar: カレンダー | NewCalendar、UpdateCalendar、DeleteCalendar、LoadCalendars | TsgcHTTPGoogleCloud_Calendar_Client。Google Calendar API v3 のカレンダー一覧をラップします。 |
| Calendar: イベント | NewEvent、UpdateEvent、DeleteEvent、LoadEvents | 指定したカレンダー上でイベントを作成・変更・削除します。 |
| Calendar: 同期 | LoadCalendarsChanged、LoadEventsChanged、OnGetCalendar、OnGetCalendarEvent | 前回の同期以降に変更されたカレンダーとイベントを対象にした、差分同期用フックです。 |
| FCM: プッシュ | SendMessage | TsgcHTTPGoogleCloud_FCM_Client。1 回の呼び出しで Firebase Cloud Messaging v1 のペイロードをプロジェクトに送信します。 |
| TLS とログ | TLSOptions、LogFile | 3 つの Google Cloud クライアントすべてで共通です。 |
通信経路上の公開規格と、対応するすべてのコンパイラで共通のソースです。
| 項目 | 内容 |
|---|---|
| HTTP サーバー | TsgcHTTPServer による HTTP リクエストとレスポンス、静的ファイル、セッション、HTTPS。 |
| FastCGI / SCGI | FastCGI の Responder ロールと TCP 上の SCGI。TsgcHTTPGateway により、CGI 環境は RFC 3875 に従って構築されます。 |
| HTTP/2 | RFC 9113、HPACK によるヘッダー圧縮と ALPN によるプロトコル交渉を伴います。 |
| gRPC | gRPC ワイヤープロトコルに従い、HTTP/2 ストリーム上を流れる Protocol Buffers ペイロードです。 |
| Google Cloud | Pub/Sub REST API、Google Calendar API v3、Firebase Cloud Messaging HTTP v1 API のすべてが、Google サービスアカウントで認証されます。 |
| プラットフォーム | 5 つのクライアントクラスすべてで、Windows Win32、Windows Win64、Linux64、macOS、iOS、Android に対応します。FastCGI / SCGI ゲートウェイは Windows と Linux で動作します。 |
| 依存関係 | HTTP/2 クライアントと gRPC クライアントは、ALPN のために sgcCustomIndy を必要とします。Google Cloud クライアントは、同梱の Core ランタイムだけで動作します。FastCGI / SCGI ゲートウェイは RAD Studio に同梱されている標準の Indy で動作し、sgcCustomIndy は不要です。 |
| コンパイラ | Delphi および C++ Builder 7 から 13 まで。 |
| エディション | HTTP/2、gRPC、FastCGI / SCGI ゲートウェイは sgcWebSockets の Enterprise エディション以上にも、Google Cloud クライアントは Standard エディション以上にも含まれています。HTTP サーバーは Core ランタイムの一部であるため、sgcWebSockets のすべてのエディションにも含まれます。 |
| ライセンス | 単体で完結します。sgcWebSockets Core ランタイムを同梱し、完全なソースコードが含まれます。 |