Trace Método

Sobrecarga 1

Sintaxis

function Trace(Const aURL: string): string;

Parámetros

Nombre	Tipo	Descripción
aURL	const string	URL absoluta del destino. Las cabeceras de la solicitud (potencialmente modificadas por proxies en el camino) serán devueltas por el servidor de origen.

Valor de Retorno

Cuerpo de la respuesta que contiene la solicitud reflejada, como documento message/http. (string)

Observaciones

TRACE realiza una prueba de bucle de mensajes: el servidor responde con la línea de solicitud exacta y las cabeceras que recibió, lo que resulta útil para diagnosticar qué proxies o puertas de enlace modifican el tráfico. Muchos servidores deshabilitan TRACE por razones de seguridad, así que esté preparado para recibir 405 Method Not Allowed.

Ejemplo

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

Sobrecarga 2

Sintaxis

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

Parámetros

Nombre	Tipo	Descripción
aURL	const string	URL absoluta a la que dirigir la solicitud TRACE.
aResponseContent	const TStream	Flujo que captura el cuerpo de la respuesta message/http ecoada.

Observaciones

Sobrecarga basada en flujos. Conveniente cuando la solicitud de eco es larga (por ejemplo, cuando se han añadido muchos encabezados proxy via) y prefiere guardarla en disco o en un búfer de memoria para su análisis posterior.

Ejemplo

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