Accueil › Spring Boot › Créer une ressource, et dire où elle est
Créer une ressource, et dire où elle est
Exercice de la série « Un projet de bout en bout »debutant
Où l'on en est. Votre contrôleur sait lister le catalogue et montrer un produit : c'est le code de départ de cet exercice, repris tel quel de l'exercice 2. Une API qui ne fait que lire n'est qu'un rapport ; il est temps d'écrire.
Ni Spring, ni serveur, ni base de données ne tournent ici : votre code
est compilé par javac seul, et c'est un routeur miniature fourni —
visible sous « Code fourni, déjà en place » — qui relit par réflexion les
annotations que vous avez posées, apparie le chemin, extrait la variable,
transforme le corps de la requête en objet, et appelle votre méthode.
Monter le projet, le pom.xml, le application.yml et le démarrage ne
s'apprennent pas ici : ils restent dans les leçons, et c'est leur place.
Les annotations sont déclarées dans le code fourni, avec les noms et
les attributs exacts de Spring. Toutes celles dont la série a besoin y
sont ; vous n'utilisez ici que @RestController, @GetMapping,
@PostMapping, @PathVariable et @RequestBody. N'écrivez aucun
import : le programme est déjà entouré.
Ce que le code fourni vous donne, en plus : le record Produit, le
DepotProduit de l'exercice 1, le routeur, le banc, et trois nouveautés.
Le corps de requête, sous forme d'objet — c'est le rôle d'un DTO d'entrée :
record NouveauProduit(String nom, String categorie, int prixCentimes, int stock)Le routeur le construit à partir du texte de la requête, où les quatre champs sont séparés par des points-virgules :
ecran;bureau;15900;4. C'est, en miniature, ce que fait Jackson avec un JSON.ReponseHttpa gagné un troisième composant — les en-têtes :record ReponseHttp(int statut, Object corps, Map<String, String> entetes)Le constructeur à deux arguments reste disponible et pose des en-têtes vides :
new ReponseHttp(200, corps)s'écrit comme avant.Le service sait créer :
long creer(NouveauProduit nouvelle)rend l'identifiant attribué par le dépôt.
Ce qu'on vous demande. Ajoutez à votre contrôleur une troisième route, sans toucher aux deux autres :
@PostMapping("/produits"), dont le paramètre est unNouveauProduitannoté@RequestBody;- elle rend le statut
201, le corps est l'identifiant attribué, et les en-têtes contiennentLocation→/produits/<id>.
Ce que le banc fait de votre en-tête, et c'est tout l'exercice. Après
votre réponse, s'il y trouve un Location, il envoie un GET sur cette
adresse et affiche ce qu'elle rend. Un Location juste donne donc 200
et le produit créé ; un Location absent ne donne rien du tout.
L'en-tête n'est pas décoratif : c'est l'adresse de ce que vous venez de
créer, et un client bien écrit la suit au lieu de deviner.
Deux cas limites, annoncés. Le cas PUT /produits/1 : le routeur
connaît ce verbe, mais votre contrôleur n'expose aucune route pour lui —
réponse 404, là où Spring répondrait 405 Method Not Allowed parce
qu'il sait que le chemin existe pour un autre verbe. Et le cas
ecran;bureau;abc;4 : le prix est illisible, le DTO le ramène à -1, et
le produit est créé tel quel, avec un prix négatif. C'est normal :
rien ne valide encore. C'est le sujet de l'exercice suivant.
Le piège. Le code de départ crée bien le produit, mais répond 200
avec une phrase et aucun en-tête. Le client ne sait donc pas qu'une
ressource est née, et surtout il ne sait pas où elle est : il devra
deviner l'URL, ou relister tout le catalogue pour retrouver son propre
produit.
Cas de test
essai("GET", "/produits", "")essai("POST", "/produits", "ecran;bureau;15900;4")essai("POST", "/produits", "ecran;bureau;abc;4")essai("PUT", "/produits/1", "clavier;bureau;4500;12")
Votre code est réellement compilé par javac et exécuté sur une JVM — aucun JDK à installer —, et la correction compare son résultat à celui d'une solution de référence.
La leçon qui prépare cet exercice
Les autres exercices de « Un projet de bout en bout »
- Le modèle et le dépôt, premières fondations
- Lister, consulter, et le 404 qui n'est pas celui du routeur
- Refuser une entrée, et nommer le champ fautif
- Remplacer, modifier, supprimer — et rejouer deux fois
- Filtrer et trier, sans casser l'URL de la liste
- Une page de catalogue, et ses bornes
- Les erreurs, traitées en un seul endroit
- Protéger les écritures, devant le contrôleur
- Une commande qui touche deux agrégats, et reste cohérente