sgcQUIC のすべての機能を、4 つのコンポーネントとそれぞれが実装する RFC にわたって整理しています。生の QUIC のペアはストリームとデータグラムを提供し、HTTP/3 のペアはリクエスト/レスポンス、QPACK、WebTransport を追加します。すべての機能は Delphi、C++ Builder、.NET で同じように動作し、すべてのライセンスに完全なソースコードが付属します。コンポーネントをクリックすると、使い方と例を載せた専用ページが開きます。
RFC 9000
RFC 9114 + QPACK
RFC 9220
TLS 1.3 / OpenSSL 3.5
2 つのレイヤー: 生の QUIC トランスポートと、その上に構築された HTTP/3 のリクエスト/レスポンスです。
| コンポーネント | クラス | ファミリー | 説明 |
|---|---|---|---|
| QUIC クライアント | TsgcQUICClient | QUIC | 生の QUIC トランスポートクライアント: ストリームとデータグラム、0-RTT、コネクションマイグレーション（RFC 9000）。 |
| QUIC サーバー | TsgcQUICServer | QUIC | 生の QUIC トランスポートサーバー: UDP ポートをバインドし、TLS 1.3 を終端し、コネクションごと・ストリームごとにイベントを発生させます。 |
| HTTP/3 クライアント | TsgcHTTP3Client | HTTP/3 | QPACK、Alt-Svc、サーバープッシュ、Extended CONNECT、WebTransport に対応した HTTP/3 クライアント（RFC 9114）。 |
| HTTP/3 サーバー | TsgcHTTP3Server | HTTP/3 | HTTP/3 サーバー: QUIC 上でリクエストを処理し、サーバープッシュ、WebTransport セッション、データグラムに対応します。 |
トランスポート層を直接公開しており、QUIC の上に独自のプロトコルを構築できます。
| 機能 | クライアント | サーバー | 備考 |
|---|---|---|---|
| トランスポートと TLS 1.3 を統合した単一のハンドシェイク | ✓ | ✓ | 1 回のやり取りでコネクションが確立します。別途の TLS ラウンドトリップは不要です。 |
| 独立した双方向ストリーム | ✓ | ✓ | パケットが失われても、そのデータを運んでいたストリームだけが止まります。 |
| 単方向ストリーム | ✓ | ✓ | builtin エンジンでの OpenStream(aUnidirectional := True)。 |
| 1 コネクションあたり複数のストリーム | ✓ | ✓ | qmBuiltin エンジンでの EnableMultiStream / OpenStream。 |
| 0-RTT 再開 | ✓ | ✓ | 再開されたセッションは、最初のやり取りで early data を運べます。 |
| コネクションマイグレーション | ✓ | ✓ | connection ID ベースで、クライアントのネットワーク切り替えを乗り越えます。 |
| バイト列の送受信 | WriteData | WriteData(connection, …) | ストリーム上で string または TBytes のペイロードを扱います。 |
| コネクションのライフサイクルイベント | OnQUICConnect / OnQUICDisconnect | OnQUICConnect / OnQUICDisconnect | トランスポートエラー用の OnQUICException もあります。 |
| 受信ストリームデータイベント | OnQUICStreamData | OnQUICStreamData / OnQUICData | ストリームのバイト列が届くたびに発生します。 |
QUIC 上の HTTP セマンティクスで、HTTP/3 固有の仕組みはメソッドとイベントとして公開されます。
| 機能 | クライアント | サーバー | 備考 |
|---|---|---|---|
| リクエストメソッド | GET, HEAD, POST, PUT, DELETE, PATCH, OPTIONS, TRACE, CONNECT, QUERY | ✓ | クライアント側ではそれぞれブロッキング呼び出しとして提供され、多くには非同期版もあります。 |
| QPACK ヘッダー圧縮 | ✓ | ✓ | RFC 9204。動的テーブルの更新は専用のエンコーダー/デコーダーストリームで行われます。 |
| Alt-Svc によるディスカバリー | OnAltSvc | アドバタイズ | RFC 7838。クライアントがヘッダーを解析し、切り替えるタイミングはアプリケーション側で判断します。 |
| サーバープッシュ | SetMaxPushId / OnPushPromise / OnPush | OnH3Request からプッシュ | クライアントは上限をアドバタイズし、プッシュされたレスポンスを拒否できます。 |
| Extended CONNECT トンネル | ExtendedConnect / TunnelSend / OnTunnelData | OnH3TunnelData / TunnelSend | RFC 9220 は、リクエストストリームを通じて別のプロトコルをトンネリングします。 |
| リクエストイベント | — | OnH3Request | リクエストごとに発生し、アプリケーションがレスポンスを埋めます。 |
| グレースフルシャットダウン | OnGoAway | GOAWAY | RFC 9114 のコネクションシャットダウンのシグナリングです。 |
| 証明書 / 鍵 | — | QUICOptions.SSLOptions.CertFile / KeyFile | リスナー用の PEM 証明書と秘密鍵です。 |
Extended CONNECT でネゴシエートされるセッションで、アプリケーションに QUIC ストリームを直接渡します。
| 機能 | クライアント | サーバー | 備考 |
|---|---|---|---|
| セッションの確立 | WebTransportConnect | OnWebTransportSession | HTTP/3 の Extended CONNECT リクエスト上でブートストラップされます。 |
| 双方向ストリーム | ✓ | ✓ | builtin エンジン上での低遅延な双方向トラフィックです。 |
| データグラム | ✓ | SendDatagram | セッションのストリームと並行する、信頼性のないデータグラムです。 |
| builtin エンジンが必須 | ✓ | ✓ | セッションには 1 つのコネクション上の複数のストリームが必要です（qmBuiltin）。 |
OpenSSL 3.5 のネイティブ QUIC エンジン上に構築された、標準準拠のスタックです。
| 領域 | 詳細 |
|---|---|
| RFC 9000 | QUIC トランスポート — ストリーム、connection ID、マイグレーション、トランスポートと TLS を統合したハンドシェイク。 |
| RFC 9114 | HTTP/3 — HTTP セマンティクスを QUIC ストリームにマッピング。 |
| RFC 9204 | QPACK — HTTP/3 向けのヘッダー圧縮。 |
| RFC 9220 | HTTP/3 上での WebTransport のブートストラップ（Extended CONNECT）。 |
| RFC 7838 | Alt-Svc — サーバーがアドバタイズする HTTP/3 の可用性。 |
| TLS | QUIC のハンドシェイクに組み込まれた TLS 1.3。 |
| 暗号エンジン | OpenSSL 3.5 のネイティブ QUIC（qmBuiltin、マルチストリーム）。quictls 系のビルド向けに qmCustom 経路もありますが、1 コネクションあたり 1 ストリームに制限されます。 |
| プラットフォーム | Win32、Win64、Linux64、および OpenSSL 3.5 の QUIC エンジンが利用可能な macOS、iOS、Android。 |
| 言語 | Delphi と C++ Builder（7 から 13 まで）、および同名の Tsgc クラスを持つ .NET。 |