Formations — 1 037 leçons en français

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 :

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

É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 »