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 :
GET /produits→200, et le corps est la liste des résumés des produits, dans l'ordre rendu par le service :List<String>obtenue parProduit::resume. Catalogue vide :200et une liste vide, jamais un404.GET /produits/{id}→200et le résumé si le produit existe ; sinon404et le corps exactementproduit introuvable.
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
essai("/produits", false)essai("/produits/2", false)essai("/articles/1", false)essai("/produits/99", false)essai("/produits", true)
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
- 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
- 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