Formations — 1 037 leçons en français

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

É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 « Ce qui fait que Spring paraît magique »