Trace 方法

重载 1

语法

function Trace(Const aURL: string): string;

参数

名称	类型	描述
aURL	const string	目标的绝对 URL。请求头（可能已由路径中的代理修改）将由源服务器原样返回。

返回值

响应体，包含回显的请求，格式为 message/http 文档。（string）

备注

TRACE 执行消息环回测试：服务器回复其收到的原始请求行和标头，便于诊断哪些代理或网关修改了流量。出于安全考虑，许多服务器会禁用 TRACE，因此请做好收到 405 Method Not Allowed 响应的准备。

示例

vEcho := oClient.Trace('https://api.example.com/diag');

重载 2

语法

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

参数

名称	类型	描述
aURL	const string	以 TRACE 请求为目标的绝对 URL。
aResponseContent	const TStream	捕获回显的 message/http 响应正文的流。

备注

基于流的重载。当回显的请求较长时（例如添加了许多代理 via 请求头），且您希望将其持久化到磁盘或内存缓冲区以供后续分析时，此重载非常方便。

示例

oOut := TFileStream.Create('trace.log', fmCreate);
try
  oClient.Trace('https://api.example.com/diag', oOut);
finally
  oOut.Free;
end;