Formations — 1 037 leçons en français

Accueil › Spring Boot › Le corps de la requête, et les codes qu'on choisit

Le corps de la requête, et les codes qu'on choisit

Exercice de la série « Les premiers gestes d'une application »intermediaire

Où l'on en est. Votre contrôleur répond en 200 à une lecture. Une API fait plus que lire : elle crée, elle refuse, elle dit qu'elle n'a pas trouvé. Chacun de ces cas a son code, et le choisir est une décision du contrôleur.

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.

Ce que le code fourni vous donne. Les annotations, aux noms et attributs exacts de Spring — @RestController, @GetMapping, @PostMapping, @PathVariable, @RequestBody —, le modèle, le dépôt, le record NouvelleCommande(String client, int quantite) qui sert de corps de requête, le record ReponseHttp(int statut, Object corps) que vous construirez vous-même, le routeur, et le banc. Le service fourni expose :

Optional<String> resume(long id)      // vide si la commande n'existe pas
long creer(NouvelleCommande nouvelle) // rend l'identifiant attribué

Le banc pose les commandes 7 (ada) et 8 (lin), envoie la requête du cas, affiche le statut et le corps rendus, puis compte les commandes du dépôt — c'est ainsi qu'on voit si une création a vraiment eu lieu. Dans le corps de requête, les deux champs sont séparés par un point-virgule : lin;3.

Ce qu'on vous demande. Écrivez ControleurCommande avec deux routes qui rendent toutes deux un ReponseHttp :

Le paramètre de la méthode POST est un NouvelleCommande annoté @RequestBody : c'est le routeur qui lit le texte de la requête et le construit, exactement comme Jackson désérialise un JSON.

Pourquoi ces codes et pas d'autres. 201 Created dit au client qu'une ressource est née — un 200 le laisserait croire qu'il a simplement consulté quelque chose. 400 dit « votre requête est fautive, ne la rejouez pas telle quelle » ; 404 dit « cette ressource n'existe pas », et c'est une information sur le serveur, pas un reproche. Rendre 200 partout avec un champ erreur dans le corps oblige chaque client à lire le corps pour savoir si ça a marché — et casse tout ce qui compte sur les statuts : les caches, les relances, les tableaux de bord.

Le piège. Le code de départ répond 200 à tout. Sur le GET, il enveloppe l'Optional tel quel : le corps devient Optional[...] ou Optional.empty, ce qui part chez le client. Sur le POST, il crée sans rien valider — la commande au client vide entre dans le dépôt, et le compteur du banc le montre.

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 « Les premiers gestes d'une application »