Accéder à l'application via un navigateur ou un outil comme curl/Postman

Interagir avec votre application en cours d'exécution

Votre application Spring Boot est maintenant lancée, écoutant les requêtes HTTP sur un port spécifique (par défaut, le port 8080). Le contrôleur REST que vous avez créé expose un ou plusieurs endpoints (URL) prêts à recevoir des requêtes. Pour vérifier que tout fonctionne comme prévu et pour interagir avec ces endpoints, vous devez utiliser un client HTTP. Il existe plusieurs outils adaptés à cette tâche, allant du simple navigateur web aux outils spécialisés en ligne de commande ou graphiques.

Le choix de l'outil dépend souvent du type de requête que vous souhaitez envoyer (GET, POST, PUT, DELETE...), de la nécessité de spécifier des en-têtes HTTP particuliers ou d'envoyer un corps de requête (payload). Pour notre premier contrôleur simple qui répond à des requêtes GET, plusieurs options sont facilement accessibles.

Utilisation du navigateur web : la méthode la plus simple pour GET

Pour les endpoints qui répondent aux requêtes HTTP GET sans nécessiter de paramètres complexes, d'en-têtes spécifiques ou de corps de requête, le navigateur web est l'outil le plus direct. Il suffit d'entrer l'URL complète de votre endpoint dans la barre d'adresse.

En reprenant l'exemple du `HelloController` avec l'endpoint `/greeting`, et en supposant que votre application tourne sur `localhost` et le port `8080`, vous pouvez simplement taper l'adresse suivante dans votre navigateur :

http://localhost:8080/greeting

Appuyez sur Entrée. Le navigateur enverra une requête GET à votre application Spring Boot. Si tout est correctement configuré, le serveur traitera la requête via le `HelloController`, et la réponse (la chaîne "Bonjour de la part de Spring Boot!") sera affichée directement dans la page du navigateur.

De même, pour l'endpoint racine :

http://localhost:8080/

Affichera : "Bienvenue sur l'application Spring Boot!".

Cette méthode est parfaite pour des vérifications rapides d'endpoints GET simples. Cependant, elle montre ses limites dès que vous devez tester d'autres méthodes HTTP (POST, PUT, DELETE), envoyer des données dans le corps de la requête (comme du JSON), ou manipuler les en-têtes HTTP.

Utilisation de `curl` : l'outil en ligne de commande

curl est un outil en ligne de commande extrêmement puissant et polyvalent pour transférer des données avec des URL. Il est disponible sur la plupart des systèmes Linux et macOS, et peut être facilement installé sur Windows. Il permet d'effectuer toutes sortes de requêtes HTTP directement depuis votre terminal.

Pour envoyer une requête GET à notre endpoint `/greeting`, ouvrez votre terminal et tapez la commande suivante :

curl http://localhost:8080/greeting

Le résultat de la commande sera le corps de la réponse renvoyé par le serveur, affiché directement dans le terminal :

Bonjour de la part de Spring Boot!

L'avantage de `curl` est sa flexibilité. Vous pouvez facilement spécifier la méthode HTTP avec l'option -X (par exemple, -X POST), ajouter des en-têtes avec -H (par exemple, -H "Content-Type: application/json"), et envoyer un corps de requête avec -d (par exemple, -d '{"name":"test"}'). Pour obtenir plus d'informations sur la réponse (comme les en-têtes de réponse et le code de statut), vous pouvez utiliser l'option -i ou -v (verbose).

# Exemple avec l'option -i pour voir les en-têtes de réponse
curl -i http://localhost:8080/greeting

curl est un outil indispensable pour les développeurs backend, idéal pour les scripts, les tests rapides et l'intégration dans des processus automatisés.

Utilisation d'outils graphiques : Postman, Insomnia, etc.

Pour une expérience plus visuelle et une gestion plus aisée des requêtes complexes et des collections d'API, les clients API graphiques comme Postman, Insomnia, ou même les clients HTTP intégrés dans certains IDE (comme IntelliJ IDEA) sont des choix populaires.

Prenons l'exemple de Postman :

1. Ouvrir Postman : Lancez l'application Postman.
2. Créer une nouvelle requête : Cliquez sur le bouton "New" ou sur l'icône "+" pour ouvrir un nouvel onglet de requête.
3. Sélectionner la méthode HTTP : Choisissez la méthode `GET` dans la liste déroulante (c'est généralement la méthode par défaut).
4. Entrer l'URL : Dans le champ d'adresse, saisissez l'URL complète de votre endpoint : http://localhost:8080/greeting.
5. Envoyer la requête : Cliquez sur le bouton bleu "Send".
6. Inspecter la réponse : Postman envoie la requête à votre application Spring Boot et affiche la réponse reçue dans la partie inférieure de la fenêtre. Vous pouvez facilement inspecter :
   • Le Body (corps) de la réponse : Vous verrez "Bonjour de la part de Spring Boot!". Postman permet de visualiser la réponse dans différents formats (Pretty, Raw, Preview).
   • Le Status Code : Vous devriez voir `200 OK`, indiquant que la requête a réussi.
   • Les Headers : Vous pouvez examiner tous les en-têtes de la réponse envoyés par Spring Boot (Content-Type, Date, etc.).
   • Le Temps de réponse, la Taille, etc.

L'avantage majeur de ces outils graphiques est leur interface utilisateur intuitive qui facilite la construction de requêtes complexes (POST, PUT avec corps JSON, authentification, en-têtes personnalisés), la sauvegarde des requêtes dans des collections pour les réutiliser, la gestion des environnements (développement, production) avec des variables, et l'écriture de scripts de test automatisés.

En conclusion, que vous utilisiez un simple navigateur pour des vérifications rapides, `curl` pour sa puissance en ligne de commande, ou Postman pour une approche graphique complète, savoir comment envoyer des requêtes à votre application Spring Boot est une compétence fondamentale. Ces outils seront vos compagnons constants tout au long du cycle de développement et de test de vos API REST.