Formations — 1 037 leçons en français

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.

  1. Le contrôleur est fourni, et il est enfin propre : plus un seul try, plus un seul if de traduction. Il appelle le service et rend le cas normal. Quand quelque chose cloche, il lève.

  2. 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 : archive
    

    CategorieFermee est une règle du métier : la boutique a fermé la catégorie archive, on n'y crée plus rien.

  3. Le routeur sait consulter un gestionnaire d'erreurs : un objet annoté @RestControllerAdvice dont 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 le ReponseHttp obtenu. S'il n'en trouve aucune, il rend 500 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

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