Formations — 1 037 leçons en français

Accueil › Java › Construire avec Maven

Construire avec Maven

Organisation et outilsdebutant

Un projet Maven suit une structure standard qui évite toute configuration de chemins :

mon-projet/
├── pom.xml
└── src/
    ├── main/
    │   ├── java/          (code source)
    │   └── resources/     (fichiers non-Java : config, templates…)
    └── test/
        ├── java/          (tests)
        └── resources/

Le pom.xml décrit le projet : ses coordonnées (groupId, artifactId, version), ses dépendances, et éventuellement des plugins qui étendent le build.

<project>
    <groupId>com.boutique</groupId>
    <artifactId>boutique-core</artifactId>
    <version>1.0.0</version>

    <properties>
        <maven.compiler.release>21</maven.compiler.release>
    </properties>

    <dependencies>
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <version>6.1.3</version>
            <scope>test</scope>
        </dependency>
    </dependencies>
</project>

Maven exécute le build en phases ordonnées : mvn package compile, teste, puis empaquette (déclenchant automatiquement les phases précédentes). Les dépendances déclarées apportent elles-mêmes des dépendances transitives ; mvn dependency:tree affiche l'arbre complet pour diagnostiquer un conflit de version.

Les termes à connaître

pom.xml

Fichier XML à la racine du projet qui décrit tout ce dont Maven a besoin : coordonnées du projet, propriétés, dépendances et plugins. C'est le fichier de configuration central d'un projet Maven.

Coordonnées GAV

Triplet groupId (organisation, ex. com.boutique), artifactId (nom du module, ex. boutique-core) et version qui identifie uniquement un projet ou une dépendance dans un dépôt Maven.

Portée (scope)

Indique à quelle étape une dépendance est nécessaire et si elle finit dans le livrable final : compile (défaut), provided, runtime ou test.

Cycle de vie Maven

Suite ordonnée de phases (validate, compile, test, package, verify, install…) déclenchées en cascade : lancer une phase exécute automatiquement toutes celles qui la précèdent.

Dépendance transitive

Dépendance apportée automatiquement parce qu'une dépendance déclarée en a elle-même besoin. Maven les résout et les ajoute au classpath sans déclaration explicite de votre part.

mvn dependency:tree

Commande qui affiche l'arbre complet des dépendances (directes et transitives) d'un projet, avec les versions retenues et celles écartées en cas de conflit. Le premier réflexe pour diagnostiquer une version inattendue sur le classpath.

Gradle

Autre outil de build Java, basé sur un DSL Groovy ou Kotlin plutôt que sur du XML. Plus flexible et souvent plus rapide (démon, cache de build), au prix d'une configuration moins standardisée que celle de Maven.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.