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
essai("/commandes/7")essai("/commandes/8")essai("/clients/1")
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.