Accueil › Spring Boot › Refuser une entrée, et nommer le champ fautif
Refuser une entrée, et nommer le champ fautif
Exercice de la série « Un projet de bout en bout »intermediaire
Où l'on en est. À l'exercice précédent, un POST avec un prix
illisible a créé un produit à -1 centime, et l'API a répondu 201.
Votre contrôleur — liste, détail, création — est le code de départ de
celui-ci. Il lui manque la seule chose qui sépare une API d'un formulaire
sans contrôle : le droit de dire non.
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, 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 : exactement le prélude de
l'exercice 3 — les annotations, le record Produit, le
record NouveauProduit et sa lecture du corps, le ReponseHttp à trois
composants, le DepotProduit, le ServiceCatalogue muni de creer, le
routeur, et le banc. Le banc affiche le statut, le corps et les en-têtes,
suit l'éventuel Location, puis compte les produits du catalogue :
c'est ainsi qu'on voit si un refus a vraiment empêché l'écriture.
Rappel sur la lecture du corps : un champ manquant devient une chaîne
vide, et un nombre illisible devient -1. Un corps vide donne donc
NouveauProduit["", "", -1, -1].
Ce qu'on vous demande. Dans votre route POST /produits, refusez une
entrée invalide avant d'appeler le service, et rendez :
- le statut
400; - en corps, une
Map<String, String>qui associe chaque champ fautif à son message, et rien d'autre ; - aucune création : le catalogue garde sa taille.
Les quatre règles, et le message exact de chacune :
| champ | règle | message |
|---|---|---|
nom |
non vide, pas seulement des blancs | ne doit pas etre vide |
categorie |
non vide, pas seulement des blancs | ne doit pas etre vide |
prixCentimes |
strictement positif | doit etre strictement positif |
stock |
positif ou nul | ne doit pas etre negatif |
Tous les champs fautifs sont rapportés, pas seulement le premier : un
corps vide donne quatre entrées. Les clés sont les noms des champs,
écrits comme dans le tableau. Si l'entrée est valide, rien ne change :
201, l'identifiant, et l'en-tête Location de l'exercice 3.
Où vous placez ce contrôle est libre — une méthode privée du contrôleur fait très bien l'affaire. Ce qui est vérifié est la réponse, pas la forme de votre code.
Pourquoi nommer le champ, et pas seulement refuser. « Requête
invalide » oblige le client à relire ses propres données en aveugle, puis
à ouvrir un ticket s'il ne trouve pas. Un corps qui dit
{prixCentimes=doit etre strictement positif} permet à une interface
d'afficher le message sous le bon champ du formulaire, et à un
intégrateur de corriger en dix secondes. C'est exactement la forme que
Spring produit à partir de BindingResult.getFieldErrors() : un champ,
un message.
Pourquoi 400, et pas 422 ni 409. 400 Bad Request dit « cette
requête est mal formée, ne la rejoue pas telle quelle », et c'est ce que
Spring rend par défaut pour une violation de @Valid. 422 se discute
quand le corps est bien formé mais sémantiquement refusé ; 409 Conflict
est autre chose encore — un conflit avec l'état du domaine, comme un
stock insuffisant, et vous le rencontrerez à l'exercice 10.
Les cas limites, annoncés. Corps vide → quatre fautes. Prix illisible
(abc) → prixCentimes fautif, puisque la lecture l'a ramené à -1.
Nom et catégorie faits d'espaces → fautifs tous les deux. Stock à 0 →
valide, un produit en rupture existe. Prix à 0 → invalide, un
produit gratuit n'existe pas au catalogue.
Le piège. Le code de départ ne vérifie que le nom, et répond un corps
plat : la chaîne produit invalide. Le client apprend qu'il a tort, et
rien de plus. Les trois autres champs passent sans contrôle, donc le prix
illisible crée toujours son produit à -1.
Cas de test
essai("POST", "/produits", "ecran;bureau;15900;4")essai("POST", "/produits", ";bureau;15900;4")essai("POST", "/produits", "ecran;bureau;abc;4")essai("POST", "/produits", " ; ;0;-5")essai("POST", "/produits", "")essai("POST", "/produits", "tapis;bureau;990;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.
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
- Créer une ressource, et dire où elle est
- 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