TsgcHTTP2Client方法 › Options

Options 方法

执行同步 HTTP/2 OPTIONS 请求,以发现资源的通信选项。

重载

重载 1

语法

function Options(const aURL: string): string;

参数

名称类型描述
aURLconst string正在查询其能力的资源的绝对 URL,或 * 表示查询整个服务器。

返回值

服务器以字符串形式返回的响应正文;有用信息通常在响应标头中。(string

备注

OPTIONS 通常被浏览器用于 CORS 预检,以及被客户端用于探测接受哪些方法。调用后检查 Request.Headers 以读取 allowaccess-control-allow-* 和相关头。

示例

vResponse := oClient.Options('https://api.example.com/v1/users');

重载 2

语法

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

参数

名称类型描述
aURLconst string被查询资源的绝对 URL。
aResponseContentconst TStream调用方拥有的流,用于接收响应体(如果服务器返回的话)。

备注

OPTIONS 的基于流的变体。当响应载荷应路由到任意 TStream 而非以字符串形式实体化时使用。

示例

oOut := TMemoryStream.Create;
try
  oClient.Options('https://api.example.com/v1/users', oOut);
finally
  oOut.Free;
end;

返回方法