Connect Método

Sobrecarga 1

Sintaxis

function Connect(const aURL: string): string;

Parámetros

Nombre	Tipo	Descripción
aURL	const string	URL absoluta del recurso de destino. El esquema (https / http) selecciona entre h2 con TLS y h2c en texto claro.

Valor de Retorno

Cuerpo de respuesta recibido del servidor decodificado como cadena de texto. (string)

Observaciones

Esta sobrecarga abre el transporte TCP/TLS, realiza la negociación ALPN/Upgrade, emite la solicitud GET inicial y retorna una vez que se ha leído la respuesta completa. Úsela cuando necesite el payload completo en memoria como cadena.

Ejemplo

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

Sobrecarga 2

Sintaxis

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

Parámetros

Nombre	Tipo	Descripción
aURL	const string	URL absoluta del recurso de destino utilizada por la primera solicitud HTTP/2.
aResponseContent	const TStream	Stream proporcionado por el llamador que recibe el cuerpo de la respuesta; la posición avanza a medida que se escriben los bytes. Útil para cargas útiles grandes o salida directa a archivo.

Observaciones

Esta sobrecarga de streaming se comporta de forma idéntica a la variante que devuelve una cadena, pero escribe la respuesta directamente en el TStream suministrado, evitando la asignación intermedia de cadenas. Prefiera esta opción cuando la respuesta no necesite mantenerse en memoria.

Ejemplo

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