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 :
@GetMapping("/commandes/{id}")→200et le résumé si la commande existe ; sinon404et le corpscommande introuvable;@PostMapping("/commandes")→ si le client estnull, vide ou fait de blancs, ou si la quantité est inférieure ou égale à zéro :400et le corpscommande invalide, sans rien créer. Sinon201et le corps est l'identifiant attribué parservice.creer(...).
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
essai("GET", "/commandes/7", "")essai("GET", "/commandes/99", "")essai("POST", "/commandes", "lin;3")essai("POST", "/commandes", ";3")essai("POST", "/commandes", "ada;0")
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.