Formations — 1 037 leçons en français

Accueil › Spring Boot › Lister, consulter, et le 404 qui n'est pas celui du routeur

Lister, consulter, et le 404 qui n'est pas celui du routeur

Exercice de la série « Un projet de bout en bout »debutant

Où l'on en est. L'exercice précédent a laissé un DepotProduit en mémoire qui enregistre, relit, liste et supprime. Il est désormais fourni : rien de ce que vous avez écrit n'est à réécrire. Le catalogue existe, mais personne ne peut le consulter — il n'a pas de porte d'entrée.

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, 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.

Les annotations sont déclarées dans le code fourni, avec les noms et les attributs exacts de Spring : @RestController, @GetMapping(String) et @PathVariable(String). Vous les écrivez donc telles que vous les écririez dans un vrai projet — et n'écrivez aucun import, le programme est déjà entouré.

Ce que le code fourni vous donne, en plus des annotations : le record Produit, le DepotProduit de l'exercice 1, le record ReponseHttp(int statut, Object corps), le routeur, et le banc. Entre les deux, un service de lecture, déjà écrit :

final class ServiceCatalogue {
    List<Produit> tous()
    Optional<Produit> parId(long id)
}

Le banc enregistre trois produits — 1 clavier, 2 souris, 3 écran —, monte votre contrôleur sur le routeur, affiche les routes trouvées, puis envoie la requête du cas.

Ce qu'on vous demande. Écrivez ControleurProduit, annoté @RestController, qui reçoit un ServiceCatalogue par constructeur et expose deux routes rendant chacune un ReponseHttp :

Les deux 404 de votre API, et il faut les distinguer. Le troisième cas demande GET /articles/1 : aucune route ne s'apparie, et c'est le routeur qui répond 404 — votre méthode n'est jamais appelée. Le quatrième demande GET /produits/99 : la route existe, elle est appelée, et c'est vous qui décidez du 404. Le premier est une erreur d'URL, le second une information sur les données. Les journaux de production confondent les deux, et c'est une demi-heure perdue à chaque incident.

Une liste vide n'est pas une absence. Le cinquième cas interroge un catalogue vidé : GET /produits doit rendre 200 avec une liste vide. « Il n'y a pas de produit » est une réponse valide à « donne-moi les produits » ; 404 dirait « cette collection n'existe pas », ce qui est faux, et obligerait chaque client à traiter un cas d'erreur pour une situation normale.

Le piège. Le code de départ n'a qu'une seule route — le détail — et il enveloppe l'Optional tel quel dans un 200. Résultat : la liste répond 404 parce qu'elle n'existe pas, et le produit absent répond 200 avec le corps Optional.empty, qui part chez le client.

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 »