Accueil › Spring Boot › Les trois couches, et une requête qui les traverse
Les trois couches, et une requête qui les traverse
Exercice de la série « Les premiers gestes d'une application »avance
Où l'on en est. Vous avez écrit chaque couche une fois. Il reste à les écrire ensemble : c'est ce qu'on fait le premier jour sur un vrai projet, et c'est la réponse vécue à la question d'entretien comment fonctionne l'architecture en couches ?
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.
Ce que le code fourni vous donne. Les annotations aux noms exacts de
Spring, Etat, le record Commande, le record ReponseHttp(int statut, Object corps), le routeur, et surtout un DepotEnMemoire qui
implémente l'interface que vous allez déclarer et qui note dans le
journal chaque appel qu'il reçoit. Le banc pose les commandes 7
(ada, NOUVELLE) et 8 (lin, PAYEE), monte les trois couches à la
main, envoie POST /commandes/<id>/annulation, puis relit le dépôt sans
passer par le journal.
Les lignes du journal sont donc intercalées dans le résultat : vous voyez la requête descendre les couches, et vous voyez ce que chaque couche a fait. C'est tout l'intérêt de cet exercice.
Ce qu'on vous demande. Trois types, et les signatures du dépôt doivent être exactement celles-ci — l'implémentation fournie s'y conforme :
interface DepotCommande {
Optional<Commande> parId(long id);
void enregistrer(Commande commande);
}
Puis le service, qui reçoit un DepotCommande par constructeur et expose
Commande annuler(long id) :
- commande absente →
NoSuchElementExceptionde messagecommande introuvable; - commande
PAYEE→IllegalStateExceptionde messageune commande payee ne s'annule pas, et le dépôt n'est pas écrit ; - sinon → la commande passe en
ANNULEE, est enregistrée, et rendue.
Puis le contrôleur, annoté @RestController, qui reçoit un
ServiceCommande par constructeur et expose
@PostMapping("/commandes/{id}/annulation") sur une méthode prenant un
long annoté @PathVariable("id") et rendant un ReponseHttp :
- succès →
200et le résumé de la commande annulée ; NoSuchElementException→404et le message de l'exception ;IllegalStateException→409et le message de l'exception.
Chaque couche fait sa part, et seulement sa part. Le contrôleur
traduit : une URL devient un long, une exception devient un code HTTP.
Il ne décide rien. Le service décide : il refuse l'annulation d'une
commande payée, et c'est lui qui sait que cela se refuse. Il ne connaît
ni URL ni statut — c'est pourquoi il lève une exception au lieu de rendre
un 409, et c'est ce qui permet à un import de fichier ou à un
consommateur de messages de réutiliser la même règle. Le dépôt stocke, et
ne juge rien.
Ce que le journal doit montrer, et c'est ce qui est vérifié :
- pour la commande
7:depot.parId(7), puisdepot.enregistrer(...ANNULEE), puis une réponse200; - pour la
8:depot.parId(8)et rien d'autre — la règle a arrêté la requête avant l'écriture —, puis409; - pour la
99:depot.parId(99)seul, puis404.
Le piège. Le code de départ a les trois couches et le bon câblage. Ce
qu'il n'a pas, c'est la répartition : le service ne vérifie rien et
enregistre toujours, le contrôleur ne traduit aucune erreur. Résultat :
la commande payée est annulée — 200, et une écriture dans le dépôt —, et
la commande absente laisse échapper une exception brute jusqu'au routeur.
C'est très exactement l'application de quelqu'un qui a écrit trois
fichiers sans se demander à quoi chacun sert.
Cas de test
essai(7L)essai(8L)essai(99L)
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.