Bir sürü öğeyi silmenin huzurlu yolu

In REST wiki makalesi bunu kullandığınız takdirde belirtilmektedir http://example.com/resources araçlarının tüm koleksiyonunu silme olduğunu, SİL.

Http://example.com/resources/7HOU57Y DELETE kullanırsanız , bu, o öğeyi sildiğiniz anlamına gelir.

WEB SİTESİ yapıyorum, WEB HİZMETİ DEĞİLDİR.

Listedeki her öğe için 1 onay kutusu olan bir listem var. Silmek için birden fazla öğe seçtiğimde, kullanıcıların SEÇİMİ SİL adlı bir düğmeye basmasına izin vereceğim. Kullanıcı düğmeye basarsa, bir js iletişim kutusu açılır ve kullanıcıdan silme işlemini onaylamasını ister. Kullanıcı onaylarsa tüm öğeler silinir.

Öyleyse, birden çok öğeyi RESTFUL bir şekilde silmeye nasıl hitap etmeliyim?

NOT, şu anda bir web sayfasında DELETE için yaptığım şey, eylem olarak POST ile FORM etiketini kullanıyorum, ancak bu, SO'da başkaları tarafından web sayfası için RESTful silme işleminin nasıl yapılacağıyla ilgili olarak belirtildiği için DELETE değerine sahip bir _metod eklemektir .

Bence rojoca'nın cevabı şimdiye kadarki en iyisi. Javascript'in aynı sayfada onaylanmasını ortadan kaldırmak ve bunun yerine, o sayfada bir onay mesajı göstererek seçimi oluşturup ona yönlendirmek için küçük bir değişiklik olabilir. Diğer bir deyişle:

From:
http://example.com/resources/

yap

Aşağıdaki kimlik seçenekleriyle birlikte POST:
http://example.com/resources/selections

başarılı olursa şununla yanıt vermelidir:

HTTP / 1.1 201 oluşturuldu ve şu adrese bir Konum başlığı:
http://example.com/resources/selections/DF4XY7

Bu sayfada daha sonra bir (javascript) onay kutusu göreceksiniz, eğer onaylarsanız aşağıdakilerden bir istekte bulunacaktır:

Http://example.com/resources/selections/DF4XY7’yi SİL

başarılı olursa şu şekilde yanıt vermelidir: HTTP / 1.1 200 Ok (veya başarılı bir silme için uygun olanı)

Seçeneklerden biri, silme "işlemi" oluşturmaktır. Böylece , silinecek kaynakların bir listesinden oluşan yeni bir kaynak POSTgibi http://example.com/resources/deletesbir şeye . Ardından uygulamanızda silme işlemini yaparsınız. Gönderiyi yaptığınızda, oluşturduğunuz işlemin bir konumunu döndürmelisiniz, örn http://example.com/resources/deletes/DF4XY7. Bunun GETüzerine bir işlemin durumunu (tamamlandı veya devam ediyor) ve / veya silinecek kaynakların bir listesini döndürebilir.

İşte Amazon'un S3 REST API ile yaptığı şey.

Bireysel silme talebi:

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))

Çok Nesne Silme isteği:

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>           

Ancak Facebook Graph API , Parse Server REST API ve Google Drive REST API , tek bir istekte bireysel işlemleri "toplu" hale getirmenizi sağlayarak daha da ileri gider.

İşte Ayrıştırma Sunucusundan bir örnek.

Bireysel silme talebi:

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

Toplu istek:

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

DELETE http://example.com/resources/id1,id2,id3,id4 veya DELETE http://example.com/resources/id1+id2+id3+id4 diyebilirim . Bu Wikipedia makalesini alıntılamak için "REST bir mimari (...) [protokol değil]" olduğundan, bunu yapmanın tek bir yolu olmadığına inanıyorum.

Yukarıdakinin HTML ile JS olmadan mümkün olmadığının farkındayım, ancak REST'in şöyle olduğu hissine kapılıyorum:

• İşlemler gibi küçük ayrıntılar düşünülmeden oluşturulur. Kimin tek bir öğeden daha fazla işlem yapması gerekir? Bu, statik web sayfalarından başka herhangi bir şey aracılığıyla sunulması amaçlanmadığı için HTTP protokolünde bir şekilde gerekçelendirilmiştir.
• Mevcut modellere iyi uyum sağlamaya gerek yok - saf HTML bile.

İlginç bir şekilde, aynı yöntemin birden fazla varlığı PATCHing için geçerli olduğunu ve URL, parametrelerimiz ve REST yöntemimizle ne demek istediğimizi düşünmeyi gerektirdiğini düşünüyorum.

1. tüm 'foo' öğelerini döndür:

   [GET] api/foo

2. belirli kimlikler için filtreleme ile 'foo' öğelerini döndür:

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

Bu anlamda URL ve filtre, "hangi öğelerle uğraştığımızı" belirler ve REST yöntemi (bu durumda "GET") "bu öğelerle ne yapmalı?"

1. Bu nedenle, okundu olarak işaretlemek için birden fazla kaydı YAMA

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

..veri ile foo [oku] = 1

1. Son olarak, birden çok kaydı silmek için, bu uç nokta en mantıklı olanıdır:

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

Lütfen anlayın bunda herhangi bir "kural" olduğuna inanmıyorum - bana göre bu sadece "mantıklı"

As Terbiyeli Dabbler cevap ve rojocas cevap diyor, en kanonik kaynaklarının seçimi silmek için sanal kaynakları kullanarak, ama bir yürütme çünkü o, REST açısından yanlış olduğunu düşünüyorum DELETE http://example.com/resources/selections/DF4XY7seçim kaynak kendisi değildir seçilmiş kaynaklar kaldırmalısınız.

Maciej Piechotka yanıtlayıcısını veya fezfox yanıtını alarak, yalnızca bir itirazım var: Bir dizi kimliği geçirmenin daha kanonik bir yolu var ve dizi operatörünü kullanıyor:

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

Bu şekilde Koleksiyonu Sil uç noktasına saldırırsınız, ancak silme işlemini bir sorgu dizesiyle doğru şekilde filtrelersiniz.

Bunu yapmanın 'uygun' bir yolu olmadığından, geçmişte yaptığım şey:

gövdede xml veya json kodlu verilerle http://example.com/something adresine DELETE gönderin .

İsteği aldığınızda, SİL seçeneğini işaretleyin, doğruysa, silinecekler için gövdeyi okuyun.

Birden çok öğeyi silmek için aynı durumu yaşadım. Sonunda yaptığım şey bu. DELETE işlemini kullandım ve silinecek öğelerin kimlikleri HTTP başlığının parçasıydı.