Connect Méthode

Surcharge 1

Syntaxe

function Connect(const aURL: string): string;

Paramètres

Nom	Type	Description
aURL	const string	URL absolue de la ressource cible. Le schéma (https / http) sélectionne entre h2 sécurisé par TLS et h2c en clair.

Valeur de retour

Corps de la réponse reçu du serveur décodé sous forme de chaîne. (string)

Remarques

Cette surcharge ouvre le transport TCP/TLS, effectue la négociation ALPN/Upgrade, émet la requête GET initiale et retourne une fois que la réponse entière a été lue. Utilisez-la lorsque vous avez besoin de la charge utile complète en mémoire sous forme de chaîne.

Exemple

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

Surcharge 2

Syntaxe

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

Paramètres

Nom	Type	Description
aURL	const string	URL absolue de la ressource cible utilisée par la première requête HTTP/2.
aResponseContent	const TStream	Flux fourni par l'appelant qui reçoit le corps de la réponse ; la position avance au fur et à mesure que les octets sont écrits. Utile pour les charges utiles volumineuses ou la sortie directe vers un fichier.

Remarques

Cette surcharge en mode streaming se comporte de manière identique à la variante retournant une chaîne, mais écrit la réponse directement dans le TStream fourni, évitant ainsi l'allocation intermédiaire de chaîne. Préférez-la lorsque la réponse n'a pas besoin d'être conservée en mémoire.

Exemple

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