TsgcHTTP3Client › Methoden › Get

Get Methode

Sendet eine synchrone HTTP/3-GET-Anfrage und gibt den Antworttext als Zeichenfolge zurück oder schreibt ihn in einen Stream.

Syntax

Get(const aURL: string): string String-Überladung

function Get(const aURL: string): string; overload;

Name	Typ	Beschreibung
`aURL`	`const string`	Absolute URL der Zielressource.

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

Get(const aURL: string; const aResponseContent: TStream) Stream-Überladung

procedure Get(const aURL: string;

  const aResponseContent: TStream); overload;

Name	Typ	Beschreibung
`aURL`	`const string`	Absolute URL der Zielressource.
`aResponseContent`	`TStream`	Stream, der den Antwort-Body empfängt.

Keine. Der Antwort-Body wird nach aResponseContent geschrieben.

Hinweise

Der Aufruf blockiert den aufrufenden Thread, bis die vollständige Antwort empfangen wurde. Wenn der Client noch nicht verbunden ist, wird die URL verwendet, um zuerst die QUIC-Verbindung zu öffnen. Für eine nicht-blockierende Anfrage verwenden Sie GetAsync, das die Antwort über OnResponse liefert.

GET ruft eine Repräsentation der Zielressource ab und trägt keinen Anfrage-Body. Verwenden Sie die String-Überladung, wenn die Payload textuell ist (HTML, JSON, XML) und bequem in den Speicher passt, und die Stream-Überladung, um binäre oder große Inhalte direkt in einen TFileStream oder TMemoryStream herunterzuladen, ohne eine Zwischenzeichenfolge aufzubauen.

Die Menge der angenommenen Body-Daten lässt sich mit MaxResponseSize begrenzen. Dieser Client folgt Weiterleitungen nicht automatisch, ein 3xx-Status muss daher vom Aufrufer behandelt werden.

Beispiel



vJSON := oClient.Get('https://api.example.com/v1/users');



// stream overload

oStream := TFileStream.Create('file.bin', fmCreate);

try

  oClient.Get('https://api.example.com/v1/file.bin', oStream);

finally

  oStream.Free;

end;

Zurück zu Methoden