Trace Methode

Overload 1

Syntaxis

function Trace(Const aURL: string): string;

Parameters

Naam	Type	Beschrijving
aURL	const string	Absolute URL als doel. De verzoekheaders (mogelijk gewijzigd door proxy's in het pad) worden teruggestuurd door de originele server.

Retourwaarde

Responsinhoud met het weergegeven verzoek, als een message/http-document. (string)

Opmerkingen

TRACE voert een bericht loopback-test uit: de server antwoordt met de exacte verzoeksregel en headers die hij heeft ontvangen, wat nuttig is voor het diagnosticeren welke proxies of gateways het verkeer wijzigen. Veel servers schakelen TRACE uit om beveiligingsredenen, dus wees voorbereid op het ontvangen van 405 Method Not Allowed.

Voorbeeld

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

Overload 2

Syntaxis

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

Parameters

Naam	Type	Beschrijving
aURL	const string	Absolute URL voor het TRACE-verzoek.
aResponseContent	const TStream	Stream die de teruggegeven message/http-antwoordtekst vastlegt.

Opmerkingen

Op streams gebaseerde overbelastingsvariant. Handig wanneer het herhaalverzoek lang is (bijvoorbeeld wanneer er veel proxy-via-headers zijn toegevoegd) en u het liever naar schijf of een geheugenbuffer wilt wegschrijven voor latere analyse.

Voorbeeld

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