Nous passons maintenant à la partie la plus passionnante, où nous allons exécuter notre première application Spring Boot à l'aide d'un exemple pratique et analyser la structure du projet.

Nous utiliserons IntelliJ IDEA, mais il est recommandé d’utiliser la version Ultimate pour travailler avec Spring Boot.

Cette version est payante, mais IntelliJ IDEA propose un mois d’essai gratuit, ce qui permet d’utiliser le programme sans problème !

Si vous souhaitez utiliser Spring Boot avec l’édition Community, voici un lien vers un article expliquant comment faire. Passons donc à la suite !

Création du projet

Tout d'abord, création d'un nouveau projet, puis, dans le panneau de gauche, sélection de Spring Boot.

Ensuite, configuration des paramètres du projet de la même manière que présenté. Toute version de Java peut être utilisée, ce n'est pas déterminant. Veiller à sélectionner Maven comme type de build.

Après avoir cliqué sur le bouton Next, une fenêtre affichera les dépendances qui seront incluses dans l'application.

Vous devez sélectionner Web -> Spring Web.

La dépendance Spring Web est nécessaire pour développer des applications web capables de gérer les requêtes HTTP, les services RESTful (nous aborderons cela plus tard), et bien plus encore. Elle fournit le support fondamental pour la création d'applications web au sein de l'Spring écosystème, incluant des fonctionnalités pour le mapping des requêtes et la gestion des exceptions.

Cliquez sur le bouton Create pour configurer votre projet ! Passons rapidement en revue la structure du projet.

Structure du projet

Au début, une structure similaire sera présente, et ici se trouve le fichier pom.xml, qui représente Maven. Examen de ce fichier :

Il est possible de remarquer une grande quantité de code qui peut sembler peu clair, mais pour l’instant, le bloc qui nous intéresse se trouve à l’intérieur des balises <dependencies> </dependencies>.

Ici, il est possible d’ajouter les dépendances sélectionnées lors de la création du projet (comme Spring Web), cette dépendance est également appelée un starter.

Par exemple, le starter spring-boot-starter-web inclut toutes les dépendances nécessaires pour développer des applications web, telles que Spring MVC et Tomcat (un serveur sur lequel notre application s'exécute), permettant aux développeurs de démarrer rapidement.

Ensuite, mettre à jour la configuration en cliquant sur ce bouton. Cela va télécharger toutes les dépendances dans le projet.

Il existe également le répertoire src qui, lorsqu'il est développé, révèle deux autres répertoires appelés main et test. Le répertoire test est utilisé pour écrire des tests, mais cela sera abordé dans d'autres sections.

Lorsque nous développons le répertoire main, nous voyons deux autres répertoires : java et resources.

Le répertoire resources est utilisé pour stocker toutes les ressources de notre site web. Les fichiers HTML sont conservés dans le répertoire templates, tandis que tout le reste (comme les fichiers CSS, JS et les images) est stocké dans le dossier static. De plus, il y a le fichier application.properties, où l’on spécifie des paramètres supplémentaires du projet.

Ce fichier spécifie le port sur lequel le serveur sera exécuté, mais il est possible de le modifier, et le serveur démarrera sur un autre port. Ce fichier sera essentiel lorsque nous nous connecterons à une base de données, nous l’étudierons donc plus en détail ultérieurement.

Enfin, dans le répertoire java, vous trouverez le chemin vers notre classe principale.

Où l'application elle-même est-elle lancée ?

Sur la capture d'écran, il est clairement indiqué où se trouve la classe principale FirstSpringBootAppApplication permettant d'exécuter l'application. Dans le répertoire où se trouve la classe principale, il est possible d'écrire vos propres classes et d'exécuter vos applications.

À présent, exécutons notre première application et vérifions si tout fonctionne comme prévu.

Si vous avez démarré le serveur et que vous voyez des journaux similaires à ceux-ci dans la console, alors félicitations, tout fonctionne !

Que faire si l’application ne démarre pas ?

Lors du démarrage d’une application Spring Boot, il est possible de rencontrer une erreur si le port est déjà utilisé. Cela se produit lorsqu’un autre processus utilise le port que vous avez spécifié, empêchant votre application de s’y lier. Pour résoudre ce problème, il suffit de modifier le port dans le fichier application.properties, par exemple en le passant à 8081.

Vous pouvez également rencontrer des problèmes liés à des dépendances incorrectes. Si vous oubliez d’inclure les dépendances nécessaires ou si vous indiquez des versions incorrectes dans votre pom.xml, l’application ne pourra pas trouver les classes requises. Vérifiez que toutes les dépendances sont correctement définies.

De plus, des dépendances indisponibles peuvent empêcher le chargement des bibliothèques en raison de problèmes de connexion Internet ou d’accessibilité du dépôt. Vérifiez votre connexion et assurez-vous que les dépôts sont accessibles.

Enfin, des erreurs dans votre code, telles que des fautes de frappe ou des annotations incorrectes, peuvent également provoquer des échecs au démarrage. Consultez les journaux pour les messages d’erreur et corrigez les problèmes identifiés.

Résumé

Dans un projet Spring Boot, la structure comprend la classe principale de l’application et les fichiers de configuration, qui se trouvent dans src/main/resources. L’accent est mis sur la simplification de la configuration et la possibilité d’un déploiement rapide de l’application.