sgcREST: Delphi & C++ Builder 向け REST API サーバー & OpenAPI コンポーネント

TsgcHTTPRESTServer は標準の TsgcHTTPServer を拡張し、CORSOptions による CORS 処理と、任意のコンパニオン用の 2 つのプロパティ、ServerStats と Tenancy を追加します。TsgcHTTPServerStats は、あらゆるリクエストをステータスクラスごとに数え、レイテンシーの最小・平均・最大を追跡し、Prometheus 形式の /metrics エンドポイントと JSON 形式の /health エンドポイントを提供し、GetEndpointStats でルートごとの内訳も取得できます。TsgcHTTPServer_Tenancy は、ホスト名、パスセグメント、リクエストヘッダー、または JWT クレームから呼び出し元のテナントを解決し、サーバー自身の Tenant プロパティが、処理中のリクエストの結果を読み取ります。TsgcHTTPServer_Users は 4 つ目の独立したコンパニオンで、AddUser、ValidateCredentials、ロールタグ、ソルト付きパスワードハッシュを備えたローカルアカウントストアです。保存時の暗号化にも対応し、サーバーのプロパティとして接続するのではなく、ルートハンドラーから直接問い合わせます。

スペックファーストでは、OpenAPI 3.0 または 3.1 のドキュメントを読み込むと、TsgcOpenAPIRouteTable がその paths セクションから自動的にルートテーブルを構築します。マッチしたリクエストは、パスとクエリパラメータへの型付きアクセス、ボディ用のヘルパー、RespondJSON/RespondError を備えた TsgcOpenAPIServerContext として届きます。TsgcOpenAPIServerHandler は、すべての呼び出しを BeforeHandle、AfterHandle、HandleException でラップし、TsgcOpenAPIJSONValidator は、仕様が宣言する JSON スキーマに対してボディ、クエリ、パスパラメータを検証します。コードファーストは情報源を逆転させます。sgcServiceContract、sgcRoute、sgcHttpGet/sgcHttpPost、sgcFromPath/sgcFromQuery/sgcFromBody の各属性を素の Delphi クラスに付与すると、TsgcOpenAPICodeFirstScanner.GenerateSpec がその RTTI から直接 OpenAPI ドキュメントを生成します。YAML を手書きする必要はありません。TsgcOpenAPICodeFirstDispatcher と組み合わせれば、属性を付けたメソッドが各オペレーションに対して直接呼び出され、手動のディスパッチチェーンは不要です。コードファーストには Delphi XE7 以降が必要です。

TsgcOpenAPI_Client は、OpenAPI ドキュメントが記述するあらゆるエンドポイント向けの汎用ランタイムクライアントです。HTTP_REQUEST が呼び出しを担い、Authentication は Basic 認証とベアラートークンに加えて汎用の OAuth2 と JWT をカバーし、OnBeforeRequest、OnUpload、OnDownload がその過程を追跡します。