Trace Méthode

Surcharge 1

Syntaxe

function Trace(Const aURL: string): string;

Paramètres

Nom	Type	Description
aURL	const string	URL absolue à cibler. Les en-têtes de requête (potentiellement modifiés par des proxies dans le chemin) seront renvoyés par le serveur d'origine.

Valeur de retour

Corps de réponse contenant la requête répercutée, sous forme de document message/http. (string)

Remarques

TRACE effectue un test de rebouclage de message : le serveur répond avec la ligne de requête et les en-têtes exacts qu'il a reçus, ce qui le rend utile pour diagnostiquer quels proxies ou passerelles modifient le trafic. De nombreux serveurs désactivent TRACE pour des raisons de sécurité, donc soyez prêt à recevoir 405 Method Not Allowed.

Exemple

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

Surcharge 2

Syntaxe

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

Paramètres

Nom	Type	Description
aURL	const string	URL absolue à cibler avec la requête TRACE.
aResponseContent	const TStream	Flux qui capture le corps de la réponse message/http renvoyé en écho.

Remarques

Surcharge basée sur un flux. Pratique lorsque la requête répercutée est longue (par exemple lorsque de nombreux en-têtes proxy via ont été ajoutés) et que vous préférez la conserver sur disque ou dans un tampon mémoire pour une analyse ultérieure.

Exemple

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