Connect メソッド

オーバーロード 1

構文

function Connect(const aURL: string): string;

パラメータ

名前	タイプ	説明
aURL	const string	ターゲットリソースの絶対URLです。スキーム（https / http）により、TLSで保護されたh2とクリアテキストのh2cが選択されます。

戻り値

文字列としてデコードされた、サーバーから受信したレスポンスボディ。（string）

解説

このオーバーロードは、TCP/TLSトランスポートを開き、ALPN/Upgradeネゴシエーションを実行し、初期GETリクエストを発行して、レスポンス全体が読み取られると戻ります。完全なペイロードを文字列としてメモリに保持する必要がある場合に使用してください。

使用例

vResponse := oClient.Connect('https://api.example.com/status');

オーバーロード 2

構文

procedure Connect(Const aURL: string; const aResponseContent: TStream);

パラメータ

名前	タイプ	説明
aURL	const string	最初の HTTP/2 リクエストが使用するターゲットリソースの絶対 URL。
aResponseContent	const TStream	レスポンスボディを受け取る呼び出し元提供のストリーム。バイトが書き込まれるにつれて位置が進みます。大きなペイロードや直接のファイル出力に便利です。

解説

このストリーミングオーバーロードは文字列を返すバリアントと同じ動作をしますが、レスポンスを直接提供された TStream に書き込み、中間文字列の割り当てを回避します。レスポンスをメモリに保持する必要がない場合に優先してください。

使用例

oStream := TFileStream.Create('out.bin', fmCreate);
try
  oClient.Connect('https://api.example.com/download', oStream);
finally
  oStream.Free;
end;