Prérequis : Installation de Java (JDK) et d'un outil de build (Maven/Gradle)

Les fondations indispensables pour développer avec Spring Boot

Avant de pouvoir écrire la moindre ligne de code avec Spring Boot et profiter de sa puissance pour créer des applications Java modernes, il est essentiel de mettre en place correctement les outils fondamentaux sur votre machine de développement. Spring Boot étant un framework basé sur Java, la première étape incontournable est l'installation d'un Kit de Développement Java (JDK) approprié. Ensuite, comme Spring Boot s'appuie fortement sur un écosystème de bibliothèques (les "starters") et nécessite un processus structuré pour compiler, tester et packager votre application, l'installation d'un outil de build tel que Maven ou Gradle est également requise.

Ce chapitre vous guidera à travers l'installation et la configuration de ces prérequis essentiels. Une installation correcte dès le départ vous évitera bien des tracas par la suite et vous permettra de vous concentrer sereinement sur le développement de votre application Spring Boot.

Installation du Kit de Développement Java (JDK)

Le JDK est le coeur de l'environnement de développement Java. Il contient tout ce dont vous avez besoin pour écrire, compiler et exécuter des applications Java :

• Le compilateur Java (javac) : transforme votre code source (.java) en bytecode (.class).
• L'environnement d'exécution Java (JRE - Java Runtime Environment, qui inclut la machine virtuelle Java ou JVM - java) : exécute le bytecode.
• Les bibliothèques de classes standard de Java (API Java SE).
• Divers autres outils de développement (débogueur, Javadoc, etc.).

Il est crucial de bien distinguer le JDK du JRE : le JRE suffit pour exécuter des applications Java, mais le JDK est indispensable pour les développer.

Quelle version de Java choisir ? Spring Boot a des exigences minimales en matière de version Java. Par exemple, Spring Boot 3.x nécessite au minimum Java 17. Il est fortement recommandé d'utiliser une version LTS (Long-Term Support) de Java, comme Java 17 ou Java 21, car elles bénéficient de mises à jour de sécurité et de corrections de bugs sur une plus longue période. Vérifiez toujours la documentation de la version de Spring Boot que vous comptez utiliser pour connaître la version minimale et recommandée de Java.

Vérifier votre installation existante : Avant d'installer, vérifiez si Java est déjà présent sur votre système. Ouvrez un terminal ou une invite de commande et tapez :

java -version

Si une version est affichée et qu'elle correspond aux exigences de Spring Boot, vous êtes prêt. Sinon, vous devez installer ou mettre à jour le JDK.

Où télécharger le JDK ? Il existe plusieurs distributions du JDK, toutes basées sur le projet OpenJDK. Choisissez celle qui vous convient le mieux :

• Adoptium Temurin : Un choix très populaire, gratuit, open-source, avec des builds pour toutes les plateformes et versions LTS. (Recommandé)
• Oracle OpenJDK / Oracle JDK : Oracle fournit des builds OpenJDK gratuits et une version commerciale Oracle JDK (vérifiez les termes de licence).
• Amazon Corretto : Distribution OpenJDK gratuite et supportée par Amazon.
• Microsoft Build of OpenJDK : Distribution OpenJDK gratuite par Microsoft.
• Autres (Azul Zulu, Red Hat OpenJDK, etc.)

Téléchargez l'installeur approprié pour votre système d'exploitation (Windows, macOS, Linux) et suivez les instructions d'installation.

Configurer les variables d'environnement (important !) : Après l'installation, il est essentiel de configurer correctement les variables d'environnement pour que votre système et vos outils de développement trouvent le JDK :

• JAVA_HOME : Définissez cette variable pour qu'elle pointe vers le répertoire d'installation de votre JDK (par exemple, C:\Program Files\Java\jdk-17.0.2 sur Windows ou /Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home sur macOS).
• PATH : Ajoutez le sous-répertoire bin de votre JDK (ex: %JAVA_HOME%\bin ou $JAVA_HOME/bin) à votre variable d'environnement PATH. Cela vous permet d'exécuter les commandes java et javac depuis n'importe quel emplacement dans votre terminal.

La méthode exacte pour définir ces variables dépend de votre système d'exploitation (variables système sous Windows, .bash_profile, .zshrc, ou /etc/environment sous Linux/macOS).

Après configuration, fermez et rouvrez votre terminal, puis vérifiez à nouveau avec java -version et essayez aussi javac -version.

Installation d'un outil de build : Maven ou Gradle

Un outil de build automatise le processus de transformation de votre code source en une application exécutable. Pour les projets Spring Boot, leurs rôles principaux sont :

• Gestion des dépendances : Télécharger automatiquement les bibliothèques nécessaires (starters Spring Boot, autres dépendances tierces) depuis des dépôts centraux (comme Maven Central) et gérer leurs versions et leurs dépendances transitives.
• Compilation : Utiliser le JDK pour compiler votre code source Java.
• Exécution des tests : Lancer vos tests unitaires et d'intégration.
• Packaging : Créer l'artefact final de votre application, généralement un fichier JAR exécutable autonome (contenant le serveur embarqué) ou un fichier WAR traditionnel.
• Autres tâches : Exécuter l'application en développement, générer de la documentation, etc.

Les deux outils de build les plus populaires dans l'écosystème Java et pleinement supportés par Spring Boot sont Maven et Gradle.

Apache Maven :

• Configuration : Basée sur un fichier XML nommé pom.xml (Project Object Model).
• Approche : Suit un principe de convention plutôt que de configuration (structure de projet standardisée).
• Installation :
  1. Téléchargez la dernière version depuis le site officiel de Maven (maven.apache.org).
  2. Décompressez l'archive dans un emplacement de votre choix (ex: C:\Program Files\Apache\maven-3.9.6).
  3. Définissez la variable d'environnement M2_HOME (ou MAVEN_HOME) pointant vers ce répertoire.
  4. Ajoutez %M2_HOME%\bin (ou $M2_HOME/bin) à votre PATH.
• Vérification : Ouvrez un nouveau terminal et tapez mvn -version.

Gradle :

• Configuration : Utilise des scripts de build écrits en Groovy (build.gradle) ou Kotlin (build.gradle.kts), offrant plus de flexibilité et de puissance programmatique.
• Approche : Très flexible, performant (grâce à un daemon et un système de cache avancé).
• Installation :
  1. Téléchargez la dernière version depuis le site officiel de Gradle (gradle.org).
  2. Décompressez l'archive (ex: C:\Program Files\Gradle\gradle-8.5).
  3. Définissez la variable d'environnement GRADLE_HOME pointant vers ce répertoire.
  4. Ajoutez %GRADLE_HOME%\bin (ou $GRADLE_HOME/bin) à votre PATH.
• Vérification : Ouvrez un nouveau terminal et tapez gradle -version.

Maven ou Gradle ? Le choix dépend souvent des préférences personnelles ou de l'équipe. Maven est souvent perçu comme plus simple pour commencer grâce à ses conventions strictes. Gradle est plus flexible et souvent plus rapide pour des projets complexes. Heureusement, Spring Initializr (l'outil pour créer des projets Spring Boot) vous permet de choisir l'un ou l'autre lors de la génération du projet.

Les Wrappers : une alternative à l'installation globale

Il est important de mentionner les **Wrappers** Maven (mvnw et mvnw.cmd) et Gradle (gradlew et gradlew.bat). Ce sont de petits scripts inclus dans votre projet (générés par Spring Initializr) qui téléchargent et utilisent automatiquement une version spécifique de Maven ou Gradle pour ce projet précis.

L'avantage principal est que les développeurs n'ont pas besoin d'installer Maven ou Gradle globalement sur leur machine. Ils peuvent simplement cloner le projet et utiliser le wrapper (ex: ./mvnw clean install ou ./gradlew build). Cela garantit que tous les membres de l'équipe et les systèmes d'intégration continue utilisent exactement la même version de l'outil de build, évitant les problèmes de compatibilité.

Même si vous avez installé Maven ou Gradle globalement, il est souvent recommandé d'utiliser le wrapper fourni avec le projet pour assurer la cohérence.

Conclusion : prêt à démarrer !

Avec un JDK compatible installé et correctement configuré (JAVA_HOME et PATH), et un outil de build (Maven ou Gradle) prêt à l'emploi (ou en vous reposant sur les wrappers), vous disposez maintenant de l'environnement minimal requis pour commencer à créer votre première application Spring Boot. Ces fondations solides vous permettront de suivre les prochains chapitres et d'explorer l'écosystème Spring Boot en toute sérénité.