Connect Metodo

Overload 1

Sintassi

function Connect(const aURL: string): string;

Parametri

Nome	Tipo	Descrizione
aURL	const string	URL assoluto della risorsa di destinazione. Lo schema (https / http) seleziona tra h2 protetto da TLS e h2c in chiaro.

Valore restituito

Corpo della risposta ricevuta dal server decodificato come stringa. (string)

Note

Questo overload apre il trasporto TCP/TLS, esegue la negoziazione ALPN/Upgrade, invia la richiesta GET iniziale e restituisce il controllo una volta letta l'intera risposta. Utilizzarlo quando si necessita del payload completo in memoria come stringa.

Esempio

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

Sovraccarico 2

Sintassi

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

Parametri

Nome	Tipo	Descrizione
aURL	const string	URL assoluto della risorsa di destinazione utilizzata dalla prima richiesta HTTP/2.
aResponseContent	const TStream	Flusso fornito dal chiamante che riceve il corpo della risposta; la posizione avanza man mano che i byte vengono scritti. Utile per payload di grandi dimensioni o output diretto su file.

Note

Questo overload in streaming si comporta in modo identico alla variante che restituisce una stringa, ma scrive la risposta direttamente nel TStream fornito, evitando l'allocazione intermedia della stringa. Preferirlo quando la risposta non deve essere mantenuta in memoria.

Esempio

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