REST può restituire il contenuto dopo il POST?

Sto usando RESTlet e ho creato una risorsa. Gestisco il POST sovrascrivendo il acceptRepresentationmetodo.

Il client dovrebbe inviarmi alcuni dati, quindi li memorizzo su DB, impostare la risposta su 201 (SUCCESS_CREATED) e devo restituire alcuni dati al client, ma il tipo di ritorno acceptRepresentationè void.

Nel mio caso, devo restituire un identificatore in modo che il client possa accedere a quella risorsa.

Ad esempio, se avessi una risorsa con URL /resourcee il client invia una richiesta POST, aggiungo una nuova riga nel DB e il suo indirizzo dovrebbe essere /resource/{id}. Devo inviare {id}.

Sto facendo qualcosa di sbagliato? I principi REST consentono di restituire qualcosa dopo il POST? Se sì, come posso farlo e in caso negativo qual è il modo per gestire questa situazione?

REST dice solo che dovresti conformarti all'interfaccia uniforme. In altre parole, dice che dovresti fare ciò che POST dovrebbe fare secondo le specifiche HTTP . Ecco la citazione da quella specifica che è rilevante,

Se una risorsa è stata creata sul server di origine, la risposta DOVREBBE essere 201 (Created) e contenere un'entità che descrive lo stato della richiesta e fa riferimento alla nuova risorsa, e un'intestazione Location (vedere la sezione 14.30).

Come puoi vedere da questo, hai due posti dove puoi indicare al cliente dove risiede la risorsa appena creata. L'intestazione Location dovrebbe avere un URL che punta alla nuova risorsa e puoi anche restituire un'entità con i dettagli.

Non sono sicuro di quale sia la differenza tra l'override di acceptRepresentation () e l'override di post (), ma questo esempio mostra come restituire una risposta da un POST.

Rinuncerei a inviare qualsiasi cosa nel corpo della risposta. Basta impostare Location: sull'URL (completo) della risorsa appena creata.

La tua descrizione suggerisce che questa è esattamente la semantica che tu:

1. POSTARE una cosa per crearla
2. Rispondi con abbastanza per sapere due cose:
   1. Che la creazione è avvenuta (il 201)
   2. Dove trovare la nuova cosa (l'intestazione Posizione)

Qualsiasi altra cosa è superflua.

Due domande diverse:

Il pattern dell'applicazione REST supporta la restituzione dei dati in un POST?

Non penso che REST lo neghi esplicitamente, ma il trattamento preferito è spiegato nella risposta di Darrel.

Il framework RESTlet consente la restituzione dei dati in un POST?

Sì, anche se restituisce void, in una classe che estende Resource, hai pieno accesso all'oggetto oggetto Response tramite il metodo getResponse (). Quindi puoi chiamare getResponse (). SetEntity () con tutti i dati che desideri.

Emetterlo in qualsiasi formato richiesto. Potrebbe essere:

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

O:

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

Dipende da cosa fai di solito. Se non si aspettano i dati, dovrebbero semplicemente ignorarli, ma qualsiasi cliente che desideri gestirli correttamente dovrebbe essere in grado di farlo.

Se rispondi 201 Created con un corpo di entità, piuttosto che un reindirizzamento Location, allora è una buona idea includere un'intestazione Content-Location che punta alla risorsa che viene rappresentata nella risposta.

Ciò eviterà una potenziale confusione, in cui un cliente potrebbe (giustificatamente) presumere che l'entità di risposta rappresenti effettivamente un nuovo stato del "creatore" e non la risorsa creata.

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