Est-ce que REST peut renvoyer du contenu après le POST?

J'utilise RESTlet et j'ai créé une ressource. Je gère POST en remplaçant la acceptRepresentationméthode.

Le client doit m'envoyer des données, puis je les stocke dans DB, définit la réponse sur 201 (SUCCESS_CREATED) et je dois renvoyer des données au client, mais retourne le type de acceptRepresentationest void.

Dans mon cas, je dois retourner un identifiant afin que le client puisse accéder à cette ressource.

Par exemple, si j'avais une ressource avec une URL /resourceet que le client envoie une demande POST, j'ajoute une nouvelle ligne dans DB et son adresse devrait être /resource/{id}. J'ai besoin d'envoyer {id}.

Est-ce que je fais quelque chose de mal? Les principes REST permettent-ils de retourner quelque chose après le POST? Si oui, comment puis-je le faire, et si non, quelle est la manière de gérer cette situation?

REST dit simplement que vous devez vous conformer à l'interface uniforme. En d'autres termes, il indique que vous devez faire ce que POST est censé faire selon la spécification HTTP . Voici la citation de cette spécification qui est pertinente,

Si une ressource a été créée sur le serveur d'origine, la réponse DEVRAIT être 201 (Créée) et contenir une entité qui décrit l'état de la demande et se réfère à la nouvelle ressource, et un en-tête Location (voir la section 14.30).

Comme vous pouvez le voir, vous avez deux emplacements où vous pouvez indiquer au client où réside la ressource nouvellement créée. L'en-tête Location doit avoir une URL qui pointe vers la nouvelle ressource et vous pouvez également renvoyer une entité avec les détails.

Je ne suis pas sûr de la différence entre la substitution d'acceptRepresentation () et la substitution de post (), mais cet exemple montre comment renvoyer une réponse à partir d'un POST.

Je renoncerais à envoyer quoi que ce soit dans le corps de la réponse. Définissez simplement Location: sur l'URL (complète) de la ressource nouvellement créée.

Votre description suggère que c'est exactement la sémantique que vous:

1. POSTER une chose pour la créer
2. Répondez avec suffisamment pour savoir deux choses:
   1. Que la création est arrivée (le 201)
   2. Où trouver la nouvelle chose (l'en-tête Location)

Tout le reste est superflu.

Deux questions différentes:

Le modèle d'application REST prend-il en charge le renvoi de données dans un POST?

Je ne pense pas que REST le rejette explicitement, mais le traitement préféré est précisé dans la réponse de Darrel.

Le framework RESTlet permet-il de renvoyer des données dans un POST?

Oui, même si elle renvoie void, dans une classe qui étend Resource, vous avez un accès complet à l'objet objet Response via la méthode getResponse (). Vous pouvez donc appeler getResponse (). SetEntity () avec les données de votre choix.

Sortez-le dans le format demandé. Cela pourrait être:

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

Ou:

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

Cela dépend de ce que vous faites habituellement. S'ils n'attendent pas les données, ils devraient simplement les ignorer, mais tout client qui souhaite les gérer correctement devrait pouvoir le faire.

Si vous répondez 201 Created avec un corps d'entité, plutôt qu'une redirection d'emplacement, il est judicieux d'inclure un en-tête Content-Location pointant vers la ressource qui est représentée dans la réponse.

Cela évitera une confusion potentielle - dans laquelle un client pourrait (à juste titre) supposer que l'entité de réponse représente en fait un nouvel état du «créateur», et non la ressource créée.

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