Put メソッド

ボディペイロードを含む同期 HTTP/3 PUT リクエストを送信し、レスポンスボディを返します。

構文

function Put(const aURL: string; const aData: string; const aContentType: string = 'application/json'): string; overload;
procedure Put(const aURL: string; const aSource: TStream; const aResponseContent: TStream); overload;

パラメータ

名前	タイプ	説明
`aURL`	`const string`	リクエストの送信先リソースの絶対 URL。
`aData`	`const string`	サーバーに送信されるリクエストボディ。
`aContentType`	`const string`	content-type ヘッダーの値。デフォルトは `application/json` です。
`aSource`	`TStream`	リクエストボディとして送信されるコンテンツのストリーム（ストリームオーバーロードのみ）。
`aResponseContent`	`TStream`	生のレスポンスボディを受け取るストリーム（ストリームオーバーロードのみ）。

戻り値

サーバーから受信したレスポンスボディ（文字列としてデコード済み）。ストリームオーバーロードは代わりに aResponseContent にボディを書き込みます。（string）

解説

Put は、完全な HTTP/3 レスポンスが受信されるまで呼び出しスレッドをブロックします。文字列ボディを送信するには最初のオーバーロードを使用し、ペイロードに合わせて aContentType を設定してください。TStream からリクエストボディを送信して別のストリームに返信を書き込むには、ストリームオーバーロードを使用してください。ノンブロッキングリクエストには PutAsync を使用してください。返信は OnResponse で通知されます。

使用例


vResponse := oClient.Put('https://api.example.com/v1/users/42', '{"name":"john"}');

メソッドに戻る