Connect Method

Overload 1

Sintaxe

function Connect(const aURL: string): string;

Parâmetros

Name	Type	Descrição
aURL	const string	URL absoluta do recurso de destino. O esquema (https / http) seleciona entre h2 protegido por TLS e h2c em texto puro.

Valor de retorno

Corpo de resposta recebido do servidor decodificado como string. (string)

Observações

Este overload abre o transporte TCP/TLS, realiza a negociação ALPN/Upgrade, emite a requisição GET inicial e retorna quando toda a resposta foi lida. Utilize-o quando você precisa do payload completo em memória como uma string.

Exemplo

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

Sobrecarga 2

Sintaxe

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

Parâmetros

Name	Type	Descrição
aURL	const string	URL absoluta do recurso de destino utilizado pela primeira requisição HTTP/2.
aResponseContent	const TStream	Stream fornecido pelo chamador que recebe o corpo da resposta; a posição é avançada à medida que os bytes são escritos. Útil para payloads grandes ou saída direta para arquivo.

Observações

Esta sobrecarga de streaming se comporta de forma idêntica à variante que retorna string, mas escreve a resposta diretamente no TStream fornecido, evitando a alocação intermediária de string. Prefira-a quando a resposta não precisa ser mantida em memória.

Exemplo

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