POST'tan sonra içeriğin REST tarafından döndürülmesi uygun mu?

RESTlet kullanıyorum ve bir kaynak oluşturdum. POST'u geçersiz kılarak ele alıyorum acceptRepresentation.

İstemci bana bazı veriler göndermeli, sonra bunu DB'ye depolamalı, yanıtı 201 (SUCCESS_CREATED) olarak ayarlamalı ve istemciye bazı verileri döndürmem gerekiyor, ancak acceptRepresentationis türünü döndürmeliyim void.

Benim durumumda, müşterinin bu kaynağa erişebilmesi için bir tanımlayıcı iade etmem gerekiyor.

Örneğin, URL ile bir kaynağım varsa /resourceve müşteri POST isteği gönderirse, DB'ye yeni bir satır eklerim ve adresi olmalıdır /resource/{id}. Ben göndermek gerekir {id}.

Yanlış bir şey mi yapıyorum? REST ilkeleri POST'tan sonra bir şey döndürmeye izin veriyor mu? Cevabınız evet ise, nasıl yapabilirim ve hayır ise bu durumu nasıl çözebilirim?

REST sadece tek tip arayüze uymanız gerektiğini söylüyor. Başka bir deyişle, HTTP özelliklerine göre POST'un yapması gereken şeyi yapmanız gerektiğini söylüyor . İşte bu spesifikasyondan alakalı olan alıntı,

Kaynak sunucuda bir kaynak yaratılmışsa, yanıt 201 (Oluşturuldu) OLMALIDIR ve talebin durumunu açıklayan ve yeni kaynağa atıfta bulunan bir varlık ve bir Konum başlığı (bkz. Bölüm 14.30).

Buradan da görebileceğiniz gibi, yeni oluşturulan kaynağın nerede olduğunu müşteriye belirtebileceğiniz iki yeriniz var. Konum başlığı, yeni kaynağa işaret eden bir URL'ye sahip olmalıdır ve ayrıca ayrıntılarla birlikte bir varlık da döndürebilirsiniz.

Kabul etmekRepresentation () ile postayı () geçersiz kılmak arasındaki farkın ne olduğundan emin değilim, ancak bu örnek bir POST'tan nasıl yanıt döndürüleceğini gösteriyor.

Yanıtın gövdesinde herhangi bir şey göndermekten vazgeçerim. Sadece Location: öğesini yeni oluşturulan kaynağın (tam) URL'sine ayarlayın.

Açıklamanız, bunun tam olarak sizin semantik olduğunu gösteriyor:

1. Oluşturmak için bir şey gönderin
2. İki şeyi bilecek kadar cevap verin:
   1. Yaratılışın gerçekleştiğini (201)
   2. Yeni şey nerede bulunur (Konum başlığı)

Başka herhangi bir şey gereksizdir.

İki farklı soru:

REST uygulama kalıbı, POST'ta veri döndürmeyi destekliyor mu?

REST'in bunu açıkça reddettiğini sanmıyorum, ancak tercih edilen tedavi Darrel'in cevabında açıklanıyor.

RESTlet çerçevesi bir POST'ta verilerin geri döndürülmesine izin veriyor mu?

Evet, void döndürmesine rağmen, Resource'u genişleten bir sınıfta, getResponse () yöntemi aracılığıyla Response nesnesine tam erişime sahipsiniz. Böylece getResponse (). SetEntity () 'yi istediğiniz verilerle çağırabilirsiniz.

İstenilen formatta çıktı alın. Bu olabilir:

<success>
    <id>5483</id>
</success>

Veya:

{ "type": "success", "id": 5483 }

Genelde ne yaptığına bağlı. Verileri beklemiyorlarsa, sadece görmezden gelmeleri gerekir, ancak verileri doğru şekilde kullanmak isteyen herhangi bir müşteri bunu yapabilmelidir.

Bir Konum yeniden yönlendirmesi yerine bir varlık gövdesiyle oluşturuldu olarak yanıt verirseniz, yanıtta temsil edilen kaynağa işaret eden bir İçerik-Konum başlığı eklemek iyi bir fikirdir.

Bu, bir müşterinin (haklı olarak) yanıt varlığının yaratılan kaynağın değil, 'yaratanın' yeni bir durumunu temsil ettiğini varsayabileceği olası karışıklığı önleyecektir.

> POST /collection
> ..new item..

< 201 Created
< Location: /collection/1354
< Content-Location: /collection/1354
< <div class="item">This is the new item that was created</div>