Patch Metoda

Wysyła synchroniczne żądanie HTTP/3 PATCH z treścią i zwraca treść odpowiedzi.

Składnia

function Patch(const aURL: string; const aData: string; const aContentType: string = 'application/json'): string; overload;
procedure Patch(const aURL: string; const aSource: TStream; const aResponseContent: TStream); overload;

Parametry

Nazwa	Typ	Opis
`aURL`	`const string`	Bezwzględny adres URL zasobu, do którego wysyłane jest żądanie.
`aData`	`const string`	Treść żądania z częściową aktualizacją wysyłaną do serwera.
`aContentType`	`const string`	Wartość nagłówka content-type. Domyślna wartość to `application/json`.
`aSource`	`TStream`	Strumień, którego zawartość jest wysyłana jako treść żądania (tylko przeciążenie strumieniowe).
`aResponseContent`	`TStream`	Strumień odbierający surową treść odpowiedzi (tylko przeciążenie strumieniowe).

Wartość zwracana

Treść odpowiedzi otrzymana od serwera, zdekodowana jako ciąg znaków. Przeciążenie strumieniowe zapisuje treść do aResponseContent. (string)

Uwagi

Patch stosuje częściową aktualizację do zasobu i blokuje wątek wywołujący do momentu odebrania pełnej odpowiedzi HTTP/3. W odróżnieniu od Put, który zastępuje cały zasób, PATCH wysyła tylko zmiany. Użyj pierwszego przeciążenia, aby wysłać treść tekstową, a przeciążenia strumieniowego, aby wysłać treść z TStream i zapisać odpowiedź do innego strumienia. W przypadku żądania nieblokującego użyj PatchAsync, które dostarcza odpowiedź przez OnResponse.

Przykład


vResponse := oClient.Patch('https://api.example.com/v1/users/42', '{"name":"john"}');

Powrót do metod