MAVEN Course Document
Cours Maven Ce cours sur Maven couvre les fonctionnalités essentielles, l'installation, la création d'un premier projet, l'arborescence du projet, les étapes de construction, la gestion des dépendances, ainsi que des travaux pratiques (TP) pour créer des projets JAR et WAR. Les étudiants apprendront à utiliser Maven pour automatiser la gestion de leurs projets Java.
D'après le document MAVEN Course Document
Cet article a été rédigé automatiquement à partir du document source, puis vérifié avant publication.
Document source
Programming, Project Management · PDF · 31 pages · 2019
Afficher l'aperçu du document
Cours Maven
Ce cours sur Maven couvre les fonctionnalités essentielles, l'installation, la création d'un premier projet, l'arborescence du projet, les étapes de construction, la gestion des dépendances, ainsi que des travaux pratiques (TP) pour créer des projets JAR et WAR. Les étudiants apprendront à utiliser Maven pour automatiser la gestion de leurs projets Java.
Fonctionnalités de Maven
Maven est un outil pour le management et l’automatisation de production des projets développé par la fondation Apache. Il permet :
- L’intégration continue
- La gestion des dépendances locales et distantes dans le Modèle de projet basé sur des conventions (POM)
- Automatiser la gestion des builds et la génération des livrables
- Automatisation de tâches récurrentes
- Le lancement des tests
Installation de Maven
Modes d'installation
Maven peut être installé de deux manières :
- En mode standalone : Utilisé dans l’intégration continue (domaine DevOps).
- En tant que plugin : Par défaut, STS intègre un plugin Maven.
Premier Projet Maven
Caractéristiques d'un projet Maven
Un projet Maven est caractérisé par plusieurs éléments dans le fichier pom.xml :
- project : Balise racine de tous les fichiers pom.xml.
- modelVersion : Version de POM utilisée.
- groupId : Identifiant du groupe qui a créé le projet (ex: org.apache).
- artifactId : Nom unique utilisé pour nommer l’artifact à construire.
- packaging : Type de packaging du projet (ex: JAR, WAR, EAR).
- archetype : Template de Projet.
- name : Nom du projet.
- description : Description du projet.
Exemple de fichier POM
Voici un exemple de fichier pom.xml :
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>com.esprit.spring</groupId>
<artifactId>tpMaven</artifactId>
<version>1.0</version>
<name>tpMaven</name>
<description>tpMaven</description>
<dependencies>
<dependency>
<groupId>org.apache.logging.log4j</groupId>
<artifactId>log4j-core</artifactId>
<version>2.14.0</version>
</dependency>
</dependencies>
</project>Arborescence du projet Maven
Maven est basé sur la notion de convention over configuration, ce qui le différencie de ses concurrents. Voici l'arborescence typique d'un projet Maven :
- pom.xml : le fichier de configuration du projet
- /src : code source et fichiers source principaux
- /src/main/java : code source Java
- /src/main/resources : fichiers de ressources (images, fichiers config...)
- /src/main/webapp : webapp du projet
- /src/test : fichiers de test
- /src/test/java : code source Java de test
- /src/test/resources : fichiers de ressources de test
- /target : fichiers résultat, les binaires, les packages générés et les résultats des tests
Étapes de construction du projet
Un cycle de vie est constitué de phases consécutives aboutissant à la création de l’artifact de notre projet. Voici les principales commandes Maven :
mvn compile: Créer les .classmvn test: Jouer les tests unitairesmvn package: Création du livrable dans targetmvn install: Copie du livrable dans le Repository localmvn deploy: Copie du livrable sur le repository distantmvn clean: Supprime le contenu du dossier target
Emplacement et nom du livrable
Le livrable est généralement situé à l'emplacement suivant :
{emplacement Repository}/groupId/artifactId/version
Le nom du package (jar en général) est : {artifactId}-{version}.{package}
Gestion et portée des dépendances
Pour ajouter une dépendance, il suffit de chercher la dépendance dans le mvnRepository et de l’inclure dans le pom.xml sous la balise <dependencies> :
<dependencies>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.23</version>
</dependency>
</dependencies>
Scope des dépendances
Le scope précise la portée de la dépendance :
- compile : par défaut, disponible dans tous les classpath
- provided : disponible seulement pour le classpath de compilation
- runtime : disponible pour l’exécution et test classpaths
- test : disponible seulement lors du lancement des tests
Dépôts Maven
Maven s’appuie sur les dépôts pour stocker les jars des dépendances et des livrables. Ce dépôt peut être :
- Distant : dépôt public accessible via mvnrepository.com ou privé.
- Local : se trouve par défaut sous l’arborescence %path_dossier_M2%\repository.
- Privé : dans des serveurs dédiés à l’entreprise.
Travaux Pratiques avec Maven
TP1 – Projet avec Maven (JAR)
Pour créer un projet Maven :
- Type : JAR
- groupId : tn.esprit
- artifactId / nom / description : tpMavenWithJar
- package : tn.esprit
Voici un exemple de code pour la classe RepositoryLocation :
package tn.esprit;
import java.io.File;
public class RepositoryLocation {
public static void main(String[] args) {
File file = new File("C:\\Users\\nameUser\\.m2\\repository\\tn\\esprit\\1.0");
String absolutePath = file.getAbsolutePath();
String filePath = absolutePath.substring(0, absolutePath.indexOf(File.separator, 30));
System.out.println("Le dossier contenant les dépendances et les livrables des projets est : ");
System.out.println(filePath);
}
}
TP2 – Projet Web avec Maven (WAR)
Pour créer un projet de type WAR, il est nécessaire de corriger certaines erreurs, comme l'absence du fichier web.xml. Ce fichier peut être généré en cliquant sur « Generate ... ».
Ajoutez également les propriétés suivantes dans le pom.xml pour pointer vers Java 8 :
<properties>
<maven.compiler.target>1.8</maven.compiler.target>
<maven.compiler.source>1.8</maven.compiler.source>
</properties>
Enfin, déployez l’application sur Tomcat et lancez l’URL : http://localhost:8080/maven-web.
Points clés à retenir
- Maven facilite l'automatisation de la gestion des projets Java.
- La structure de projet est standardisée, ce qui simplifie la configuration.
- Les dépendances sont gérées efficacement via le fichier
pom.xml. - Les commandes Maven permettent de gérer facilement le cycle de vie d'un projet.
Glossaire
- POM : Project Object Model, fichier de configuration de Maven.
- Artifact : Un produit construit par Maven, comme un JAR ou un WAR.
- Dependency : Une bibliothèque ou un module dont le projet a besoin.
- Repository : Un emplacement où les dépendances et les livrables sont stockés.
- Scope : La portée d'une dépendance dans le projet.
Questions fréquentes
Comment installer Maven ?
Maven peut être installé en mode standalone ou en tant que plugin dans des environnements comme STS. Pour le mode standalone, il suffit de télécharger Maven depuis le site officiel et de le configurer. En tant que plugin, il est intégré par défaut dans certains IDE.
Qu'est-ce qu'un fichier POM ?
Le fichier POM (Project Object Model) est un fichier XML qui contient des informations sur le projet et les configurations nécessaires pour construire le projet avec Maven. Il spécifie les dépendances, le groupId, l'artifactId, et d'autres paramètres essentiels.
Comment gérer les dépendances dans Maven ?
Les dépendances sont gérées dans le fichier pom.xml sous la balise <dependencies>. Il suffit d'ajouter une balise <dependency> pour chaque dépendance nécessaire, en spécifiant le groupId, l'artifactId et la version.
Quelles sont les étapes de construction d'un projet Maven ?
Les étapes de construction d'un projet Maven incluent des commandes comme mvn compile pour compiler le code, mvn test pour exécuter les tests unitaires, mvn package pour créer le livrable, et mvn install pour installer le livrable dans le repository local.
Comment créer un projet Web avec Maven ?
Pour créer un projet Web avec Maven, il faut choisir le type WAR lors de la création du projet. Il est important de s'assurer que le fichier web.xml est présent et de configurer le pom.xml pour utiliser la version appropriée de Java.
Commentaires
Aucun commentaire pour le moment. Posez la première question.