Formations — 1 037 leçons en français

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.

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

  2. ReponseHttp a 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.

  3. 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 :

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

Écrire le code et le faire exécuter →

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 »