CHAPITRE 2 : INSTALLER SON ENVIRONNEMENT

Trois outils suffisent : un JDK, un gestionnaire de dependances et un editeur. Comptez une trentaine de minutes la premiere fois.

1. Le JDK

Spring Boot 3 exige Java 17 au minimum. Installez une version LTS (17 ou 21), plus stable et maintenue plus longtemps.

java -version
javac -version

Les deux commandes doivent afficher la meme version. Si javac est introuvable, vous avez installe un JRE et non un JDK : seul le second permet de compiler.

2. Maven

Maven telecharge les bibliotheques, compile le projet et produit l'executable.

mvn -version

Bonne nouvelle : un projet Spring Boot contient un wrapper (mvnw sous Linux et Mac, mvnw.cmd sous Windows). Il telecharge la bonne version de Maven automatiquement. Installer Maven globalement n'est donc pas indispensable.

3. L'editeur

Outil	Remarque
IntelliJ IDEA	Reference pour Java. La version Community suffit.
VS Code	Plus leger. Installez l'extension Extension Pack for Java.
Eclipse	Gratuit et complet, interface plus ancienne.

4. Un client HTTP

Pour tester une API, un navigateur ne suffit pas : il ne sait envoyer que des requetes GET. Prevoyez l'un de ces outils :

Postman : interface graphique, tres repandu
curl : en ligne de commande, deja present sur la plupart des systemes
L'onglet HTTP Client d'IntelliJ

curl http://localhost:8080/bonjour

curl -X POST http://localhost:8080/etudiants \
     -H "Content-Type: application/json" \
     -d '{"nom":"Awa","matricule":"19A123"}'

5. Les erreurs les plus frequentes

Message	Cause	Solution
`java n'est pas reconnu`	JDK absent du PATH	Rouvrez le terminal, verifiez la variable PATH
`invalid target release: 17`	JDK trop ancien	Installez un JDK 17 ou superieur
`Port 8080 already in use`	Un programme occupe deja le port	Arretez-le, ou changez de port (chapitre 11)
Telechargement tres long	Premier build	Normal : Maven remplit son cache local une seule fois

6. Un mot sur le premier build

La premiere compilation telecharge plusieurs centaines de megaoctets dans le dossier ~/.m2. Avec une connexion modeste, lancez-la quand vous avez du temps. Les projets suivants reutiliseront ce cache et demarreront en quelques secondes.

A retenir

JDK 17 minimum pour Spring Boot 3
javac doit repondre, pas seulement java
Le wrapper Maven evite d'installer Maven globalement
Prevoyez un client HTTP pour tester autre chose que des GET

Exercices d'application

Exercice 1. Verifier l'installationInstallez un JDK 17 ou 21 et verifiez avec java -version et javac -version. Notez les versions obtenues.

Exercice 2. Preparer l'editeurInstallez IntelliJ IDEA Community ou VS Code avec l'Extension Pack for Java. Creez un projet Java vide pour verifier que la compilation fonctionne.

Exercice 3. Premier curlTestez curl https://api.github.com. Que recevez-vous ? Essayez ensuite avec l'option -i pour voir les en-tetes.

Cherchez avant de regarder la solution : c'est en butant sur les difficultes que l'on progresse.