Spokojny sposób na usuwanie wielu elementów

W artykule wiki dla REST wskazano, że jeśli używasz http://example.com/resources DELETE, oznacza to, że usuwasz całą kolekcję.

Jeśli używasz http://example.com/resources/7HOU57Y DELETE, oznacza to, że usuwasz ten element.

Robię STRONĘ INTERNETOWĄ, uwaga NIE SERWIS INTERNETOWY.

Mam listę zawierającą 1 pole wyboru dla każdej pozycji na liście. Po wybraniu wielu elementów do usunięcia, pozwolę użytkownikom nacisnąć przycisk o nazwie USUŃ WYBÓR. Jeśli użytkownik naciśnie przycisk, pojawi się okno dialogowe js z prośbą o potwierdzenie usunięcia. jeśli użytkownik potwierdzi, wszystkie pozycje zostaną usunięte.

Jak więc powinienem zająć się usuwaniem wielu elementów w PEWNY sposób?

UWAGA, obecnie dla DELETE na stronie internetowej, co robię, to używam znacznika FORM z POST jako akcją, ale dołączam _method z wartością DELETE, ponieważ jest to to, co zostało wskazane przez innych w SO, jak zrobić RESTful delete dla strony internetowej .

Myślę, że odpowiedź rojoca jest jak dotąd najlepsza. Niewielką różnicą może być wyeliminowanie potwierdzenia javascript na tej samej stronie, a zamiast tego utworzenie zaznaczenia i przekierowanie do niego, wyświetlając komunikat potwierdzający na tej stronie. Innymi słowy:

Od:
http://example.com/resources/

zrób

POST z wyborem identyfikatorów do:
http://example.com/resources/selections

który, jeśli się powiedzie, powinien odpowiedzieć:

Utworzono protokół HTTP / 1.1 201 i nagłówek lokalizacji:
http://example.com/resources/selections/DF4XY7

Na tej stronie zobaczysz następnie pole potwierdzenia (javascript), które po potwierdzeniu wykona żądanie:

USUŃ http://example.com/resources/selections/DF4XY7

który, jeśli się powiedzie, powinien odpowiedzieć: HTTP / 1.1 200 Ok (lub cokolwiek jest odpowiednie do pomyślnego usunięcia)

Jedną z opcji jest utworzenie „transakcji” do usunięcia. Więc POSTdo czegoś w rodzaju http://example.com/resources/deletesnowego zasobu składającego się z listy zasobów do usunięcia. Następnie w swojej aplikacji wystarczy usunąć. Kiedy wysyłasz wiadomość, powinieneś zwrócić lokalizację utworzonej transakcji, np http://example.com/resources/deletes/DF4XY7. A GETna tym może zwrócić status transakcji (zakończona lub w toku) i / lub listę zasobów do usunięcia.

Oto, co Amazon zrobił ze swoim interfejsem API S3 REST.

Indywidualne żądanie usunięcia:

DELETE /ObjectName HTTP/1.1
Host: BucketName.s3.amazonaws.com
Date: date
Content-Length: length
Authorization: authorization string (see Authenticating Requests (AWS Signature Version 4))

Żądanie usunięcia wielu obiektów :

POST /?delete HTTP/1.1
Host: bucketname.s3.amazonaws.com
Authorization: authorization string
Content-Length: Size
Content-MD5: MD5

<?xml version="1.0" encoding="UTF-8"?>
<Delete>
    <Quiet>true</Quiet>
    <Object>
         <Key>Key</Key>
         <VersionId>VersionId</VersionId>
    </Object>
    <Object>
         <Key>Key</Key>
    </Object>
    ...
</Delete>           

Ale Facebook Graph API , Parse Server REST API i Google Drive REST API idą jeszcze dalej, umożliwiając „grupowanie” poszczególnych operacji w jednym żądaniu.

Oto przykład z Parse Server.

Indywidualne żądanie usunięcia:

curl -X DELETE \
  -H "X-Parse-Application-Id: ${APPLICATION_ID}" \
  -H "X-Parse-REST-API-Key: ${REST_API_KEY}" \
  https://api.parse.com/1/classes/GameScore/Ed1nuqPvcm

Żądanie partii:

curl -X POST \
  -H "X-Parse-Application-Id: ${APPLICATION_ID}" \
  -H "X-Parse-REST-API-Key: ${REST_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
        "requests": [
          {
            "method": "POST",
            "path": "/1/classes/GameScore",
            "body": {
              "score": 1337,
              "playerName": "Sean Plott"
            }
          },
          {
            "method": "POST",
            "path": "/1/classes/GameScore",
            "body": {
              "score": 1338,
              "playerName": "ZeroCool"
            }
          }
        ]
      }' \
  https://api.parse.com/1/batch

Powiedziałbym DELETE http://example.com/resources/id1,id2,id3,id4 lub DELETE http://example.com/resources/id1+id2+id3+id4 . Ponieważ „REST jest architekturą (…) [nie] protokołem”, cytując ten artykuł w Wikipedii, nie ma, jak sądzę, jednego sposobu na zrobienie tego.

Zdaję sobie sprawę, że powyższe nie jest możliwe bez JS z HTML, ale mam wrażenie, że REST był:

• Stworzone bez myślenia o drobnych szczegółach, takich jak transakcje. Kto musiałby operować na więcej niż jednym elemencie? Jest to w jakiś sposób uzasadnione w protokole HTTP, ponieważ nie było to przeznaczone do obsługi przez niego niczego innego niż statyczne strony internetowe.
• Nie trzeba dobrze dopasowywać się do obecnych modeli - nawet czystego HTML.

Co ciekawe, myślę, że ta sama metoda ma zastosowanie do PATCHOWANIA wielu jednostek i wymaga zastanowienia się, co mamy na myśli z naszym adresem URL, parametrami i metodą REST.

1. zwraca wszystkie elementy „foo”:

   [GET] api/foo

2. zwraca elementy „foo” z filtrowaniem pod kątem określonych identyfikatorów:

   [GET] api/foo?ids=3,5,9

W jakim sensie adres URL i filtr określają „z jakimi elementami mamy do czynienia?”, A metoda REST (w tym przypadku „GET”) mówi „co zrobić z tymi elementami?”.

1. Dlatego PATCH wiele rekordów, aby oznaczyć je jako przeczytane

   [PATCH] api/foo?ids=3,5,9

..z danymi foo [odczyt] = 1

1. Wreszcie, aby usunąć wiele rekordów, ten punkt końcowy jest najbardziej logiczny:

   [DELETE] api/foo?ids=3,5,9

Proszę zrozumieć, że nie wierzę w żadne „zasady” w tym zakresie - dla mnie to po prostu „ma sens”

Jak mówi odpowiedź Decent Dabbler i odpowiedź rojocas , najbardziej kanonicznym jest użycie zasobów wirtualnych do usunięcia wybranych zasobów, ale myślę, że jest to niepoprawne z perspektywy REST, ponieważ wykonanieDELETE http://example.com/resources/selections/DF4XY7 powinno usunąć sam zasób selekcji, a nie wybrane zasoby.

Biorąc pod uwagę odpowiedź Macieja Piechotki lub odpowiedź fezfox , mam tylko zastrzeżenie: istnieje bardziej kanoniczny sposób przekazywania tablicy identyfikatorów i używa operatora tablicy:

DELETE /api/resources?ids[]=1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d&ids[]=7e8f9a0b-1c2d-3e4f-5a6b-7c8d9e0f1a2b

W ten sposób atakujesz punkt końcowy Usuń kolekcję, ale filtrujesz usunięcie za pomocą zapytania w odpowiedni sposób.

Ponieważ nie ma `` właściwego '' sposobu, aby to zrobić, w przeszłości zrobiłem:

wyślij DELETE na adres http://example.com/something z danymi zakodowanymi w formacie XML lub JSON w treści.

kiedy otrzymasz żądanie, sprawdź, czy nie ma opcji DELETE, jeśli prawda, a następnie przeczytaj treść tych, które mają zostać usunięte.

Miałem tę samą sytuację, aby usunąć wiele elementów. Oto, co ostatecznie zrobiłem. Użyłem operacji DELETE, a identyfikatory elementów, które miały zostać usunięte, były częścią nagłówka HTTP.