REST PUT vs POST z UUID

Question

Jeśli używam UUID zidentyfikować podmiot jako część mojego URI mego odpoczynku punkt końcowy:

/entities/<uuid>/ 

i że UUID jest generowany przez klienta przy tworzeniu nowych podmiotów jest istnieje najlepsza praktyka w zakresie używania PUT vs POST? Innymi słowy, UUID jest generowany przez klienta, a nie przez serwer.

Jeśli miałbym używać PUT, czy oczekuje się, że treść wiadomości zawiera także UUID? W takim przypadku zarówno wiadomość, jak i identyfikator URI identyfikujący jednostkę, będą zawierały UUID.

Dla specyfikacji, patrz: REST RFC

Answer 1

Ponieważ (klient) już wiedzą UUID, powiedziałbym PUT jest najlepsza praktyka, a nie muszą zawierać UUID w ładunku. Prawdą jest, że PUT vs POST jest nieco kontrowersyjne, a czytanie i ponowne czytanie RFC nie całkowicie to wyjaśnia. Ale myślę, że poprzednim jest ortodoksja.

Zobacz fajną dyskusję na stronie PUT vs POST in REST.

Answer 2

Główną różnicą między POST i PUT:

POST służy do dołączania nowych podmiotów. POST to nie idempotent. Oznacza to, że jeśli wysyłasz żądanie POST dziesięć razy, utworzysz dziesięć różnych podmiotów. Zwykle powinieneś otrzymać kod odpowiedzi 201 (Utworzony) na żądanie POST w połączeniu z nagłówkiem Lokalizacja wskazujący adres URL nowo utworzonego zasobu. W twoim przypadku proponuję opublikować URL sthm jak

POST /entities/ HTTP/1.1 
Content-Type: application/json 
{ 
    UUID: <UUID>.. 
    OtherStuff: ... 
} 

Response:

HTTP/1.1 201 Created 
Location: http://www.myREST/entities/<uuid>/ 

PUT żądanie służy do modyfikowania istniejącego stanu. PUT to idempotent. Zwykle otrzymasz kod odpowiedzi 200 (OK).

Musisz podać UUID w polu danych PUT/POST. UUID jest częścią reprezentacji Twojego zasobu. PUT i POST obie reprezentacje przesyłania do serwera REST w celu zmiany/dołączenia stanu zasobów.

BTW nie powinieneś używać terminu URI w REST. Identyfikator URI to sthm, który może nie mieć reprezentacji, ale URL zawsze ma reprezentację.

Answer 3

Zrozumieć różnicę między PUT i POST.

PUT ma na celu zastąpienie zasobu (http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9.6) wskazywanego przez identyfikator URI nowym. I jest to idempotentne, tzn. Ile razy wywołasz go z taką samą ładownością, wynik jest taki sam; udostępni ten sam zasób za pośrednictwem URI.

Tak więc, jeśli zasób już nie istnieje, zostanie utworzony nowy. Nawet w tym przypadku wynik jest taki sam, tzn. Udostępni ten sam zasób za pośrednictwem URI.

POST oznacza utworzenie pod-zasobu (http://www.w3.org/Protocols/rfc2616/rfc2616-sec9.html#sec9.5) do zasobu wskazywanego przez URI.Jeśli zasób jest listą, to doda element do niego. Jeśli jest to przedmiot, powinien dodać coś do przedmiotu, może to być atrybut.

Najlepiej jeśli element wskazywany przez identyfikator URI jest niedostępny, powinien to być warunek błędu. Może być "404". POST polega na dodawaniu do istniejącego zasobu.

Wychodząc z pytaniem, najlepiej użyć testu POST z "/ entity /" jako identyfikatorem URI, jak w powyższym opisie. Nie powinieneś używać nieistniejącego identyfikatora UUID zasobu w URI z metodą POST. Jeśli używasz PUT, użyj "/ entity /".

POST /entities/ HTTP/1.1 
Content-Type: application/json 
{ 
    UUID: <UUID>.. 
    OtherStuff: ... 
} 

PUT /entities/<UUID> HTTP/1.1 
Content-Type: application/json 
{ 
    UUID: <UUID>.. 
    OtherStuff: ... 
} 

reakcji powinien być taki sam

HTTP/1.1 201 Created 
Location: http://www.examples.com/entities/<uuid>/ 

chociaż sprzedaży jest idempotent ale jeśli metoda sprzedaży jest ponownie użyty, należy używać 200 lub 204 w odpowiedzi.

Twoje drugie pytanie: najlepiej pełny szczegół zasobów powinien znajdować się w polu danych PUT zamiast tylko URI.