Trace Methode

Overload 1

Syntax

function Trace(Const aURL: string): string;

Parameter

Name	Typ	Beschreibung
aURL	const string	Absolute Ziel-URL. Die Anfrage-Header (möglicherweise von Proxys auf dem Pfad verändert) werden vom Origin-Server zurückgespiegelt.

Rückgabewert

Antwort-Body, der die zurückgesendete Anfrage enthält, als message/http-Dokument. (string)

Hinweise

TRACE führt einen Nachrichten-Loop-Back-Test durch: der Server antwortet mit genau der Request-Zeile und den Headern, die er empfangen hat, was es nützlich macht, um zu diagnostizieren, welche Proxys oder Gateways den Verkehr verändern. Viele Server deaktivieren TRACE aus Sicherheitsgründen, seien Sie also darauf vorbereitet, 405 Method Not Allowed zu empfangen.

Beispiel

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

Überladung 2

Syntax

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

Parameter

Name	Typ	Beschreibung
aURL	const string	Absolute URL, die mit der TRACE-Anfrage adressiert werden soll.
aResponseContent	const TStream	Stream, der den zurückgegebenen message/http-Antworttext erfasst.

Hinweise

Stream-basierte Überladung. Praktisch, wenn die zurückgespiegelte Anfrage lang ist (zum Beispiel wenn viele Proxy-via-Header hinzugefügt wurden) und Sie sie zur späteren Analyse auf der Festplatte oder in einem Speicherpuffer persistieren möchten.

Beispiel

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