Comment Créer votre premier Projet Spring Boot ?

Introduction

Tu as entendu parler de Spring boot et tu te de décides à explorer ses fonctionnalités.

Tu es au bon endroit. Car ce mini-article a pour but d’aider les débutants à créer leur première application Spring boot.

Les vieux développeurs savent combien il était difficile de créer et structurer une application dans les règles de l’art. Heureusement Spring boot propose une plateforme permettant de générer une application bien structurée. Cette plateforme s’appelle Spring initializr.

L’application générée ne contient naturellement pas de fonctionnalités métier. Mais elle vient avec tous les éléments de configuration pour pouvoir débuter le développement sereinement.

Ce n’est pas pour rien que les concepteurs de spring boot qualifie les applications de « production-grade » (c’est-à-dire dire application professionnelle prête à être utilisée dans un environnement de production réel, avec des performances, une fiabilité et une stabilité élevées).

Etape 1 : aller sur le site start.spring.io

Etape 2 : Renseigner les informations du formulaire

1. Projet
   Il s’agit de choisir en fait l’outil de build (gradle ou maven).
   Ce choix est souvent imposé par l’organisation ou l’entreprise. Si vous avez le choix je conseille d’utiliser gradle-groovy (le choix par défaut).
2. Le choix du langage de programmation
   Et oui ! Spring boot supporte java, Kotlin et groovy.
   Vous pouvez choisir le langage de développement qui vous convient. Même si je suis pas mal sûr que ce soit est souvent imposé par votre entreprise ou votre responsable.
   Quoi qu’il en soit si vous avez le choix, choisissez simplement le langage avec lequel vous êtes à l’aise. Si vous ne connaissez aucun des trois langages je vous conseille alors de choisir kotlin. Kotlin est en fait une sorte de java « amélioré » avec une syntaxe orienté vers une meilleure expérience de développement.
3. Le choix de la version de spring boot
   Actuellement la dernière version stable de spring boot est 3.2.2. Choisissez simplement la dernière version stable.
4. Les metadata du projets
   Il s’agit en fait de la carte d’identité du nouveau projet.
   • Group
     il s’agit du groupId maven (généralement com. suivi du nom de la société)
   • Artifact
     c’est l’identifiant technique du projet. Ce qu’il faut retenir c’est que le coupe group:artifact doit permettre d’identifier le projet parmi tous les projets de votre organisation.
   • Name
     c’est le nom user-friendly du projet. Il permet de nommer le projet de façon plus compréhensible si le nom technique (artifact) n’est pas suffisamment clair. Ce champ est optionnel.
   • Description
     Décrivez dans ce champ votre projet.
     
5. Spring initializr permet d’ajouter un ensemble de dépendances Maven au projet à générer. Dans cette partie nous pouvons par exemple ajouter la dépendance spring-boot-starter-web à notre projet web.
   Tu ne sais pas ce que c’est qu’un starter ? pas de panique : cet article éclairement ta lanterne.
6. Nous avons enfin la possibilité de télécharger notre code source et l’exploiter.
7. Package name
   C’est le package racine du projet. Généralement il s’agit simplement d’une concaténation des 2 premiers champs (group et artifact)

Les informations renseignées peuvent être modifiées après la génération du projet. Pas de panique si on oublie un élément ou qu’on renseigne mal une information.

Si votre environnement de développement intégré (IDE) prend en charge l’intégration de Spring initializr, vous pouvez accomplir ce processus directement depuis votre IDE. C’est notamment le cas de STS et de  la version payante de IntelliJ.

Etape 3 : Importer le projet sur votre IDE favori

Une fois le projet télécharger, nous le dézippons avec notre logiciel d’archivage favoris (Winrar, 7zip, winzip etc). Puis nous pouvons l’importer sur notre IDE favori (IntelliJ, eclipse sts etc).

Nous pouvons des à présent commencer à ajouter nos points d’entré (controlleur) et fonctionnalités (services) au projet.

Etape 4 : Démarrer l’application spring-boot

Pour exécuter l’application, lancez la commande suivante dans une fenêtre de terminal (dans le répertoire où se trouve l’application) :

./gradlew bootRun

Si vous utilisez Maven, lancez la commande suivante dans une fenêtre de terminal (dans le répertoire ou se trouve l’application):

./mvnw spring-boot:run

Voilà j’espère que tu as trouvé ce contenu instructif. Si tu as des remarques, des questions, insultes 😊 la section commentaire est prévu pour ça.

L’equipe qui maintient Spring offre gentillement une panoplie de guides utiles. Tu les trouveras ici.