Accueil › Spring Boot › Le routeur, pris par l'autre bout
Le routeur, pris par l'autre bout
Exercice de la série « Ce qui fait que Spring paraît magique »avance
Vous vous en êtes déjà servi ; voici ce qu'il y avait dedans. Dans la
série « Les premiers gestes », votre contrôleur était appelé par un
routeur miniature fourni : il relisait vos annotations, appariait
/commandes/{id} à /commandes/7, en tirait id = "7", le convertissait,
et vous appelait. Vous l'avez utilisé sans le lire. Aujourd'hui, c'est lui
l'objet d'étude — et il avait un défaut.
Ni Spring, ni serveur, ni base de données ne tournent ici : votre code
est compilé par javac seul. Votre Routeur remplace le
RequestMappingHandlerMapping du DispatcherServlet — la pièce qui, à
chaque requête HTTP, décide quelle méthode de quel contrôleur va
répondre. C'est ce que @GetMapping("/commandes/{id}") déclare, et rien de
plus.
Il n'y a aucune annotation à écrire ni à lire dans cet exercice : les routes vous arrivent déjà déclarées, sous forme de données. Ce qu'on vérifie est la décision, pas l'orthographe d'une annotation.
Ce que le code fourni vous donne (bloc « Code fourni, déjà en
place ») : le record Route(String verbe, String motif, String nom), le
record Appariement(String nom, Map<String, String> variables), et le banc
d'essai avec sa table de six routes, déclarées dans un ordre que vous
verrez.
Ce qu'on vous demande. Écrivez la classe Routeur avec :
static Appariement choisir(List<Route> routes, String verbe, String chemin)
Elle rend l'appariement retenu, ou null si aucune route ne convient
— c'est le 404 du serveur, celui qui tombe avant tout contrôleur.
Ce qu'apparier veut dire. On découpe le motif et le chemin sur /.
Même nombre de segments, sinon aucun appariement. Un segment écrit
{nom} accepte n'importe quoi et capture la valeur sous ce nom ; tout
autre segment doit être égal au segment reçu. Le verbe doit correspondre.
Et les deux routes qui se disputent. La table contient, dans cet ordre :
GET /commandes/{id} -> commandeParId
GET /commandes/recentes -> listerRecentes
La requête GET /commandes/recentes s'apparie aux deux. Laquelle
choisir ? La plus spécifique : celle qui contient le moins de
variables de chemin. Un segment littéral est une affirmation, une variable
est un joker, et un joker ne doit jamais battre une affirmation. À nombre
de variables égal, la première déclarée gagne.
Le piège du code de départ, et c'est celui du routeur de la série 00.
Il rend le premier appariement trouvé. Sur cinq requêtes sur six, il a
raison. Sur GET /commandes/recentes, il appelle commandeParId avec
id = "recentes" — et dans un vrai projet, cela donne un
NumberFormatException en pleine requête, ou pire, un 404 métier sur une
commande dont l'identifiant est le mot « recentes ». Vous ne saviez pas que
le routeur que vous utilisiez avait ce défaut ; maintenant vous le corrigez.
Cas de test
essai("GET", "/commandes/recentes")essai("GET", "/commandes/7")essai("GET", "/commandes/7/lignes")essai("GET", "/commandes")essai("POST", "/commandes")essai("DELETE", "/commandes/7")
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.