Connect Methode

Overload 1

Syntax

function Connect(const aURL: string): string;

Parameter

Name	Typ	Beschreibung
aURL	const string	Absolute URL der Zielressource. Das Schema (https / http) wählt zwischen TLS-gesichertem h2 und unverschlüsseltem h2c.

Rückgabewert

Vom Server empfangener Antworttext, als String dekodiert. (string)

Hinweise

Diese Überladung öffnet den TCP/TLS-Transport, führt die ALPN-/Upgrade-Aushandlung durch, sendet die anfängliche GET-Anfrage und kehrt zurück, sobald die gesamte Antwort gelesen wurde. Verwenden Sie sie, wenn Sie die vollständige Nutzlast als Zeichenfolge im Speicher benötigen.

Beispiel

vResponse := oClient.Connect('https://api.example.com/status');

Überladung 2

Syntax

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

Parameter

Name	Typ	Beschreibung
aURL	const string	Absolute URL der Zielressource, die von der ersten HTTP/2-Anfrage verwendet wird.
aResponseContent	const TStream	Vom Aufrufer bereitgestellter Stream, der den Response-Body empfängt; die Position wird vorgerückt, während Bytes geschrieben werden. Nützlich für große Payloads oder die direkte Dateiausgabe.

Hinweise

Diese Streaming-Überladung verhält sich identisch zur zeichenkettenrückgebenden Variante, schreibt die Antwort jedoch direkt in den bereitgestellten TStream und vermeidet so eine zwischenzeitliche Zeichenkettenallokation. Bevorzugen Sie sie, wenn die Antwort nicht im Speicher gehalten werden muss.

Beispiel

oStream := TFileStream.Create('out.bin', fmCreate);
try
  oClient.Connect('https://api.example.com/download', oStream);
finally
  oStream.Free;
end;