Connect Metoda

Przeciążenie 1

Składnia

function Connect(const aURL: string): string;

Parametry

Nazwa	Typ	Opis
aURL	const string	Bezwzględny URL zasobu docelowego. Schemat (https / http) decyduje o wyborze między zabezpieczonym TLS h2 a niezaszyfrowanym h2c.

Wartość zwracana

Treść odpowiedzi odebrana z serwera, zdekodowana jako ciąg znaków. (string)

Uwagi

To przeciążenie otwiera transport TCP/TLS, wykonuje negocjację ALPN/Upgrade, wysyła początkowe żądanie GET i zwraca wynik po odczytaniu całej odpowiedzi. Należy go użyć, gdy cały ładunek jest potrzebny w pamięci jako ciąg znaków.

Przykład

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

Przeciążenie 2

Składnia

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

Parametry

Nazwa	Typ	Opis
aURL	const string	Bezwzględny adres URL zasobu docelowego używanego przez pierwsze żądanie HTTP/2.
aResponseContent	const TStream	Strumień dostarczony przez wywołującego, który odbiera treść odpowiedzi; pozycja jest przesuwana w miarę zapisywania bajtów. Przydatne dla dużych ładunków lub bezpośredniego wyjścia do pliku.

Uwagi

To przeciążenie strumieniowe zachowuje się identycznie jak wariant zwracający ciąg znaków, lecz zapisuje odpowiedź bezpośrednio do dostarczonego TStream, unikając pośredniej alokacji ciągu. Preferowane, gdy odpowiedź nie musi być przechowywana w pamięci.

Przykład

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