Get Metoda

Przeciążenie 1

Składnia

function Get(const aURL: string): string;

Parametry

Nazwa	Typ	Opis
aURL	const string	Bezwzględny adres URL zasobu do pobrania. Parametry ciągu zapytania powinny być już zakodowane.

Wartość zwracana

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

Uwagi

Tego przeciążenia należy użyć, gdy odpowiedź jest tekstowa (HTML, JSON, XML) i wygodnie mieści się w pamięci. Metoda blokuje działanie do chwili odebrania wszystkich ramek DATA i zwraca połączoną treść.

Przykład

vJSON := oClient.Get('https://api.example.com/v1/users');

Przeciążenie 2

Składnia

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

Parametry

Nazwa	Typ	Opis
aURL	const string	Bezwzględny URL zasobu do pobrania.
aResponseContent	const TStream	Strumień należący do wywołującego, który odbiera nieprzetworzone bajty odpowiedzi w miarę ich nadchodzenia.

Uwagi

Wariant strumieniowy przeznaczony do pobierania plików binarnych lub dużych ładunków, w których przechowywanie treści jako ciągu znaków jest niepożądane. Odpowiedź jest zapisywana sekwencyjnie do aResponseContent (na przykład TFileStream).

Przykład

oStream := TFileStream.Create('image.png', fmCreate);
try
  oClient.Get('https://api.example.com/image.png', oStream);
finally
  oStream.Free;
end;