Accueil › Spring Boot › Les erreurs, traitées en un seul endroit
Les erreurs, traitées en un seul endroit
Exercice de la série « Un projet de bout en bout »avance
Où l'on en est. Six exercices, et une API complète. Mais regardez
votre contrôleur : il est plein de décisions qui ne parlent pas du
catalogue. isEmpty() → 404, map de fautes → 400, booléen → 204 ou
404. Chaque nouvelle route recopiera les mêmes if, et la cinquième
oubliera le 404. Il est temps de sortir la traduction 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 apparie le chemin,
appelle votre méthode, et, si elle laisse échapper une exception,
cherche qui sait la traduire avant de rendre la réponse. 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 qui a changé dans le code fourni, et c'est le sujet.
Le contrôleur est fourni, et il est enfin propre : plus un seul
try, plus un seulifde traduction. Il appelle le service et rend le cas normal. Quand quelque chose cloche, il lève.Le service, fourni lui aussi, lève trois exceptions métier — déclarées dans le code fourni :
class ProduitIntrouvable extends RuntimeException // message : produit introuvable : 99 class DonneesInvalides extends RuntimeException // porte fautes() : Map<String, String> class CategorieFermee extends RuntimeException // message : categorie fermee aux ajouts : archiveCategorieFermeeest une règle du métier : la boutique a fermé la catégoriearchive, on n'y crée plus rien.Le routeur sait consulter un gestionnaire d'erreurs : un objet annoté
@RestControllerAdvicedont les méthodes portent@ExceptionHandler(UneException.class). Devant une exception, il cherche parmi ces méthodes celle dont le type déclaré est le plus proche de l'exception reçue, l'appelle avec l'exception en argument, et rend leReponseHttpobtenu. S'il n'en trouve aucune, il rend500 aucun gestionnaire. Les deux annotations sont déclarées dans le code fourni, aux noms exacts de Spring.
Ce qu'on vous demande. Écrivez la classe GestionnaireErreurs,
annotée @RestControllerAdvice, avec une méthode par cas. Chacune prend
l'exception en unique paramètre et rend un ReponseHttp :
| exception | statut | corps |
|---|---|---|
ProduitIntrouvable |
404 |
le message de l'exception |
DonneesInvalides |
400 |
la map rendue par fautes() |
CategorieFermee |
409 |
le message de l'exception |
toute autre RuntimeException |
500 |
la chaîne erreur interne |
Le dernier cas est un filet : il attrape ce que personne n'a prévu.
Le banc envoie exprès une requête qui fait lever une
IllegalStateException depuis le service, et votre filet doit répondre
500 avec erreur interne — et surtout pas le message de
l'exception, qui est le détail d'implémentation que vous ne voulez pas
publier.
Le plus proche gagne, et c'est vérifié. Vos quatre méthodes se
chevauchent : ProduitIntrouvable est une RuntimeException. Le
routeur choisit la plus spécifique, comme Spring, et c'est ce qui permet
au filet d'exister sans tout avaler. Si vous n'écriviez que le filet,
les trois premiers cas répondraient 500 : c'est exactement le code de
départ.
Pourquoi 409 pour la catégorie fermée, et 400 pour les données.
400 dit « votre requête est mal formée » : le client peut la corriger
seul. 409 Conflict dit « votre requête est correcte, mais elle se
heurte à l'état actuel du domaine » : la même requête sera peut-être
acceptée demain, et le client n'a rien à corriger dans sa syntaxe. Rendre
400 sur un conflit métier envoie le client chercher une faute qui n'est
pas dans ses données.
Le piège. Le code de départ est une classe correctement annotée, avec
une seule méthode : le filet. Toutes les erreurs deviennent donc
500, y compris le produit introuvable, ce qui est le plus mauvais
message qu'une API puisse rendre — le client croit que votre serveur est
cassé, et vous réveille à trois heures du matin pour une URL mal tapée.
Cas de test
essai("GET", "/produits/1", "")essai("GET", "/produits/99", "")essai("POST", "/produits", "ecran;bureau;15900;4")essai("POST", "/produits", ";bureau;0;-5")essai("POST", "/produits", "vieux stock;archive;500;2")essai("DELETE", "/produits/2", "")
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
- Refuser une entrée, et nommer le champ fautif
- Remplacer, modifier, supprimer — et rejouer deux fois
- Filtrer et trier, sans casser l'URL de la liste
- Une page de catalogue, et ses bornes
- Protéger les écritures, devant le contrôleur
- Une commande qui touche deux agrégats, et reste cohérente