Connect Method

Overload 1

Syntaxis

function Connect(const aURL: string): string;

Parameters

Naam	Type	Beschrijving
aURL	const string	Absolute URL van de doelbron. Het schema (https / http) bepaalt of er TLS-beveiligde h2 of cleartext h2c wordt gebruikt.

Retourwaarde

Responsebody die van de server is ontvangen, gedecodeerd als een string. (string)

Opmerkingen

Deze overload opent het TCP/TLS-transport, voert de ALPN/Upgrade-onderhandeling uit, verstuurt het initiële GET-verzoek en keert terug zodra het volledige antwoord is gelezen. Gebruik deze variant wanneer u de volledige payload als tekenreeks in het geheugen nodig heeft.

Voorbeeld

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

Overload 2

Syntaxis

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

Parameters

Naam	Type	Beschrijving
aURL	const string	Absolute URL van de doelresource die wordt gebruikt door het eerste HTTP/2-verzoek.
aResponseContent	const TStream	Door de aanroeper geleverde stream die de antwoord-body ontvangt; de positie wordt gevorderd naarmate bytes worden geschreven. Nuttig voor grote payloads of directe bestandsuitvoer.

Opmerkingen

Deze streaming-overload gedraagt zich identiek aan de tekenreeks-retournerende variant, maar schrijft het antwoord direct naar de opgegeven TStream, waardoor tussentijdse tekenreekstoewijzing wordt vermeden. Gebruik deze methode bij voorkeur wanneer het antwoord niet in het geheugen hoeft te worden bewaard.

Voorbeeld

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