Structure et gestion des dépendances Maven

1. Pourquoi avons-nous besoin de Maven ?

Imaginez que vous construisiez une application web. Vous aurez besoin de bibliothèques pour vous connecter à une base de données, pour gérer des requêtes web, pour effectuer des tests, etc. Sans un outil de gestion, vous devriez :

1. Trouver et télécharger manuellement les fichiers .jar de chaque bibliothèque.
2. Les ajouter à votre projet.
3. Vous assurer que les versions de toutes ces bibliothèques sont compatibles entre elles (un véritable casse-tête !).
4. Écrire des scripts complexes pour compiler tout votre code et créer un paquetage final.

Maven automatise tout ce processus. Comme npm pour Node.js ou pip pour Python, Maven gère les dépendances de votre projet. Mais il va plus loin : il impose une structure de projet standard et gère tout le cycle de vie de la construction (compilation, tests, empaquetage, etc.).

La vidéo suivante introduit très bien ces concepts.

En résumé, Maven apporte trois avantages majeurs :

• Standardisation : Tous les projets Maven ont la même structure de base. Un développeur qui rejoint un projet s'y retrouve instantanément.
• Gestion des dépendances : Vous déclarez les bibliothèques dont vous avez besoin dans un fichier, et Maven s'occupe de les télécharger et de les rendre disponibles.
• Automatisation du build : Des commandes simples comme mvn package permettent de compiler, tester et empaqueter votre application de manière fiable et reproductible.

2. La structure d'un projet Maven

Maven repose sur le principe de "Convention over Configuration" (la convention plutôt que la configuration). Cela signifie qu'il existe une structure de répertoires par défaut que vous devez suivre. En respectant cette convention, vous avez très peu de configuration à faire.

La vidéo que nous avons commencée vous montre maintenant comment créer un projet Maven directement dans IntelliJ et quelle est sa structure.

Voici une illustration plus complète de cette arborescence standard, qui inclut aussi des dossiers pour un projet web que nous verrons plus tard.

L'élément le plus important à la racine du projet est le fichier pom.xml.

3. Le cœur du projet : le fichier pom.xml

Le fichier pom.xml (Project Object Model) est le fichier de configuration central de votre projet Maven. C'est un fichier XML qui décrit tout ce qui concerne votre projet : ses coordonnées, les dépendances dont il a besoin, comment le compiler, etc.

4. Gérer les dépendances

C'est l'une des fonctionnalités les plus puissantes de Maven. Pour ajouter une bibliothèque externe (par exemple, pour se connecter à une base de données MySQL ou pour écrire des tests avec JUnit), il suffit de déclarer sa dépendance dans le pom.xml.

Comment ça marche ?

1. Vous ajoutez un bloc <dependency> dans la section <dependencies> de votre pom.xml.
2. Ce bloc contient les coordonnées (groupId, artifactId, version) de la bibliothèque souhaitée.
3. Lorsque vous construisez votre projet, Maven vérifie votre dépôt local (un dossier .m2 dans votre répertoire utilisateur) pour voir si la bibliothèque y est déjà.
4. Si elle n'y est pas, Maven la télécharge depuis le dépôt central Maven (un immense entrepôt de bibliothèques sur Internet) et la stocke dans votre dépôt local pour une utilisation future.
5. La bibliothèque est ensuite ajoutée au classpath de votre projet, la rendant disponible pour votre code.

Pour trouver les coordonnées d'une bibliothèque, vous pouvez utiliser des sites comme MVN Repository ou Maven Central Search.

L'article de "Developpez.com" donne un excellent exemple pratique.

5. Bonne pratique : Configurer la version de Java

Par défaut, Maven peut parfois utiliser une très ancienne version de Java pour la compilation (Java 5 !). Cela vous empêcherait d'utiliser des fonctionnalités modernes du langage. Il est donc crucial de toujours spécifier la version de Java que vous souhaitez utiliser.

Cela se fait en configurant un plugin dans la section <build> de votre pom.xml. Un plugin est une extension qui ajoute des capacités à Maven. Dans ce cas, nous allons configurer le maven-compiler-plugin.

La vidéo suivante montre ce problème et comment le résoudre. C'est une étape que vous ferez dans presque tous vos projets.

Voici le bloc de code à ajouter dans votre pom.xml (à l'intérieur de la balise <project>). Adaptez la version 17 si vous avez installé une autre version du JDK.

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version> <!-- ou une version plus récente -->
            <configuration>
                <source>17</source>
                <target>17</target>
            </configuration>
        </plugin>
    </plugins>
</build>

Dès que vous modifiez le pom.xml dans IntelliJ, une petite icône apparaît pour vous proposer de "charger les changements Maven". Cliquez dessus pour que l'IDE mette à jour le projet avec la nouvelle configuration.

Conclusion

Aujourd'hui, vous avez fait un grand pas vers le développement Java professionnel. Vous avez quitté le monde des simples fichiers pour entrer dans celui des projets structurés et gérables.

Les points clés à retenir :

• Maven est l'outil standard pour gérer la structure, les dépendances et le cycle de vie des projets Java.
• Il suit le principe de "Convention over Configuration", imposant une arborescence de dossiers standard (src/main/java, src/test/java, ...).
• Le fichier pom.xml est le cerveau du projet. Il définit ses coordonnées, ses dépendances et la configuration du build.
• Les dépendances (bibliothèques externes) sont déclarées dans le pom.xml et Maven les télécharge automatiquement depuis un dépôt central.
• Il est essentiel de configurer le maven-compiler-plugin pour s'assurer que votre projet est compilé avec la bonne version de Java.

Dans notre prochaine leçon, nous reviendrons aux fondamentaux du langage Java. Nous allons explorer en détail la différence entre les types de données primitifs (comme int, double, boolean) et les types référence (les objets), et nous verrons l'utilité des classes "wrapper" comme Integer ou Double. Nous mettrons en pratique ces concepts directement dans notre nouveau projet Maven.