Formations — 1 037 leçons en français

Accueil › Spring Boot › Le contrôleur, et sa première route

Le contrôleur, et sa première route

Exercice de la série « Les premiers gestes d'une application »debutant

Où l'on en est. Le dépôt stocke, le service décide. Personne n'a encore de porte d'entrée. C'est le contrôleur : trois annotations, une méthode, et une URL devient appelable.

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 : Etat, le record Commande, l'interface DepotCommande et son implémentation en mémoire, le service de l'exercice précédent — ici String resume(long id), qui lève NoSuchElementException si la commande n'existe pas —, le record ReponseHttp(int statut, Object corps), le routeur, et le banc. Le banc pose les commandes 7 et 8, construit votre contrôleur avec un service, demande au routeur la liste des routes qu'il a trouvées, puis envoie une requête GET sur le chemin du cas.

Ce qu'on vous demande. Écrivez :

@RestController
class ControleurCommande {
    // un constructeur qui reçoit un ServiceCommande
    // une méthode annotée @GetMapping("/commandes/{id}")
    // qui prend un long annoté @PathVariable("id")
    // et rend le String de service.resume(id)
}

Rendez une simple String : le routeur l'emballe lui-même dans une réponse 200. Choisir les statuts sera l'affaire de l'exercice suivant.

Ce qui est vraiment vérifié. Pas la présence d'une annotation à l'endroit attendu — le fait que ça réponde. Le routeur ne connaît pas votre classe : il lit ses méthodes, cherche celle dont le motif /commandes/{id} s'apparie à /commandes/7, en tire id = "7", le convertit en long d'après le type du paramètre, et vous appelle. C'est le même enchaînement que Spring MVC, en trente lignes.

Le troisième cas, /clients/1, ne correspond à aucune route : c'est le routeur qui rend 404, sans vous appeler. Ce 404-là n'est pas le vôtre — la différence comptera au prochain exercice.

Le piège. Le code de départ a la bonne classe, le bon constructeur, la bonne méthode, et aucune annotation sur celle-ci. Le routeur ne trouve donc aucune route — la liste est vide, et les trois cas répondent 404. Sans @GetMapping, une méthode de contrôleur n'est qu'une méthode.

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 « Les premiers gestes d'une application »