Maîtrisez l’installation pas à pas de MAVEN 2. Comprenez la valeur ajoutée de cet outil : automatisation des taches récurrentes , gestion des dépendances (fini la gestion manuelle des jars !) et génération de rapports contribuant à un meilleur pilotage de votre projet . Créez enfin avec Objis un projet maven simple et découvrez les phases MAVEN en action.

Ce tutoriel est un extrait de séances pratiques de la formation MAVEN 2 dispensée par Objis.

Les + objis
 70% de travaux pratiques
 Clé USB avec tous les outils utilisés + Corrigés TPs
 Bilan pédagogique individuel + conseils

Liens utiles

 + de 100 tutoriaux java/jee Objis
 Site du livre de référence (Maven by example)

Prérequis, outils et versions

 Installation kit de développement Java (JDK)

Objectifs

 Maîtriser l’installation de MAVEN
 Comprendre les phases MAVEN et les mettre en œuvre
 Créer un projet MAVEN simple via le plugin Maven ’archetype’
 Maîtriser la compilation, le test, le packaging d’une application,
 Installer une application dans un repository local
 Comprendre l’enchaînement de phases
 Générer le site web du projet

Programme

 Partie 1 : installation Maven
 Partie 2 : phases Maven

Durée

 30 min

Partie 1 : Installation Maven

Etape 1
 Téléchargez et dézipper l’archive courante de MAVEN, par exemple apache-maven-2.2.1-bin.zip. Vous obtenez le répertoire apache-maven-2.2.1

tutoriel-maven-installation-analyse-1

 Analysez le contenu du répertoire bin

tutoriel-maven-installation-analyse-1bis

QUESTION : à quoi sert le fichier m2.conf ?

 Analysez le contenu du répertoire conf.

tutoriel-maven-installation-analyse-1ter

QUESTION : à quoi sert la balise ’localRepository’ présente dans le fichier settings.xml

Etape 2
 Ajouter la variable d’environnement utilisateur M2_HOME avec pour valeur le chemin du répertoire apache-maven-2.2.1 (Ex : c :\outils\apache-maven-2.2.1-bin)

— Sous WinXP : Menu Démarrer/Panneau de configuration/système/Onglet Avancé/Zone ’variable utilisateur’/Bouton Variable d’environnement/Ajouter

tutoriel-maven-installation-analyse-2

Etape 3

Dans la même boîte de dialogue, ajouter la variable d’environnement M2 , avec comme valeur %M2_HOME%\bin

tutoriel-maven-installation-analyse-3

Etape 4

Créez ou mettez à jour la variable d’environnement PATH avec %M2%

tutoriel-maven-installation-analyse-4

Etape 5 (Optionnel)

Dans la même boîte de dialogue, ajouter la variable d’environnement MAVEN_OPTS pour spécifier paramètres JVM , par exemple -Xms256m -Xmx512m

tutoriel-maven-installation-analyse-5

Etape 6

Assurez-vous que la variable d’environnement JAVA_HOME pointe bien sur le répertoire d’installation du JDK, et que %JAVA_HOME%\bin est bien dans la variable PATH.

tutoriel-maven-installation-analyse-6

Etape 7

Lancez une nouvelle commande MS-DOS et exécuter : mvn –version pour avoir la version de Maven installées Démarrer/Programmes/Accesoires/Invite de commandes

tutoriel-maven-installation-analyse-7

Maven est correctement installé sur votre ordinateur.

INFO : à partir de la version maven 2.1.0, la commande mvn —version vous fournit également comme information la ’locale’ par défaut (ici fr_FR) ainsi que l’encodage par défaut (ici cp1252, représentant le jeu de caractère Windows)

Partie 2 : phases MAVEN

Contexte : comprendre les phases Maven

Maven associe à tout projet MAVEN des phases . A chacune de ces phases est associé/déclenché par défaut des taches mises en oeuvre par des plugins.

tutoriel-maven-installation-analyse-7bis

Dans le cycle de vie ’par défaut’ d’un projet Maven, les phases les plus utilisées sont :

 validate : vérifie les prérequis d’un projet maven
 compile : compilation du code source
 test : lancement des tests unitaires
 package : assemble le code compilé en un livrable
 install : partage le livrable pour d’autres projets sur le même ordinateur
 deploy : publie le livrable pour d’autres projets dans un ’repository’ distant

Les phases s’exécutente de façon séquentielle de façon à ce qu’une phase dépende de la phase précédente.

Par exemple, le lancement par l’utilisateur de la phase test (mbn test) impliquera le lancement préalable par maven des phases ’validate’ et ’compile’.

Voici la liste complète des phases pour un projet maven 2.2 :

— validate
— generate-sources
— process-sources
— generate-resources
— process-resources
— compile
— process-classes
— generate-test-sources
— process-test-sources
— generate-test-resources
— process-test-resources
— test-compile
— test
— prepare-package
— package
— integration-test
— verify
— install
— deploy

REMARQUE : Cette partie ne traite pas de plugin ni de taches (Goals). Cette partie a pour objectif de vous faire comprendre et mettre en oeuvre des phases MAVEN.

Mise en oeuvre

 Crééez le répertoire : C :\formationmaven\TPs\TP1
 Dans le répertoire créé, exécutez la commande suivante :

mvn archetype:create -DgroupId=com.objis.mavenapps -DartifactId=monappli

— Que se passe t’il ?

tutoriel-maven-installation-analyse-11

Il semble que plusieurs fichiers soient téléchargé sur votre ordinateur.

QUESTION : quels types de fichiers sont téléchargés ? et où sont t’ils déposés ?

Après quelques secondes, vous pouvez lire :

tutoriel-maven-installation-analyse-12

 Expliquez

INFO : la commande archetype:create est dépréciée . Elle est utilisée ici uniquement à des fin pédagogique. Une meilleure pratique de création de projet maven est présentée dans le tutoriel 2 ’création de projet Maven’ via archetype:generate.

 Analysez le répertoire .m2 créé par maven dans votre répertoire utilisateurs système ($HOME sous unix, Documents and Settings pour winxp) :

tutoriel-maven-installation-analyse-13

 Expliquez

 Observez la création par maven :
— du répertoire ’monappli’

tutoriel-maven-installation-analyse-8

— du fichier pom.xml à la racine du répertoire monappli

— des sous répertoire src/main/java (code source) et src/test/java (code tests)

tutoriel-maven-installation-analyse-9

 Analysez le contenu du sous-répertoire mavenapps

tutoriel-maven-installation-analyse-10

 Editez le fichier App.java (par exemple avec éditeur Notepad++)

tutoriel-maven-installation-analyse-14

 Expliquez

 De même, éditez le fichier src/test/java/TestApp.java

tutoriel-maven-installation-analyse-15

 Expliquez

 Analysez le contenu du fichier pom.xml

tutoriel-maven-installation-analyse-16

— Qu’est ce que le fichier xsd référencé par http://maven.apache.org/maven-v4_0_0.xsd ?
— Qu’est ce que le groupId ? l’ artifactId ? la ’version’ ? En déduire les ’coordonnées MAVEN’ de l’application monappli

— Qu’est ce que les ’dependencies’ ?
— A quoi sert la balise ’scope’ de la dépendence Junit ?

 Citez d’autres balises que l’on peut retrouver dans ce fichier pom.xl

PHASE Compilation

 A partir du répertoire ’monappli’, lancez la commande : mvn compile
— Que se passe t’il ?

tutoriel-maven-installation-analyse-17

 Analysez le contenu tu répertoire monappli/target généré

tutoriel-maven-installation-analyse-18

PHASE Test
 Lancez la commande : mvn test

tutoriel-maven-installation-analyse-19

— Que se passe t’il ?

 Analysez le contenu tu répertoire monappli/target généré

tutoriel-maven-installation-analyse-20

 Analysez le contenu tu répertoire monappli/target/surefire-reports généré

tutoriel-maven-installation-analyse-21

 Expliquez

PHASE Packaging Lancez la commande : mvn package

— Que se passe t’il ?

 Analysez le contenu tu répertoire monappli/target généré

tutoriel-maven-installation-analyse-22

— Quelle relation avec mvn compile ?

 Lancez la commande : java -cp target/monappli-1.0-SNAPSHOT.jar com.objis.mavenapps.App

— Que se passe t’il ?

PHASE Install
 Lancez la commande : mvn install

— Que se passe t’il ?
 Qu’est ce qu’un repository local ?
 Quel est le repository local par defaut ? Comment le changer ?

 Montrez que le jar de l’application est désormais dans le repository local. A quel endroit ?

tutoriel-maven-installation-analyse-23

 Confirmez la création du jar monappli-1.0-SNAPSHOT.jar dans le répertoire %USER_HOME%/.m2/repository/com/objis/demomaven

tutoriel-maven-installation-analyse-24

Nettoyage
 Lancez la commande : mvn clean
— Que se passe t’il ?

 Constatez la suppression du répertoire ’target’

tutoriel-maven-installation-analyse-8

Enchaînement de phases
 Lancez la commande : mvn clean install
— Que se passe t’il ?

Génération du site web du projet
 Lancez la commande : mvn site
 Que se passe t’il ?

 Constatez la suppression du répertoire ’target/site’

tutoriel-maven-installation-analyse-25

 Ouvrir le fichier index.html avec votre navigateur

tutoriel-maven-installation-analyse-26

Maven a généré le site internet de votre projet. Ce site , mis à jour, constitue un outil de communication pour l’ensemble de l’équipe de développement.

 Cliquez sur le lien ’Dependencies’

tutoriel-maven-installation-analyse-27

— Quel lien avec notre fichier pom.xml ?

 Expliquez les autres liens du menu (gauche) du site :
— about
— Continous integration
— Issue tracking
— Mailing list
— Plugin Management
— Project License
— Project Summary
— Project Team
— Source Repository

QUESTION : comment faire pour que ce rapport soit en français ?

QUESTION : comment modifier le contenu des différentes sections ?

Projet

monappli

Conclusion

Dans ce tutoriel, vous avez installé maven 2. Vous vous êtes également initié aux phases d’un projet Maven. Vous avez créé un projet maven simple.

Dans le tutoriel Maven N°2 ’création projet Maven’, vous allez mieux découvrir la bonne pratique de création d’un projet maven : avec le plugin archetype et le ’goal’ generate.

Prochaine formation MAVEN

Le chemin le plus court pour avoir les réflexes et la méthodologie du bon développeur MAVEN :

Pour aller plus loin : le réseau Objis

Si vous appréciez notre sens du partage, devenez gratuitement membre ’classic’ du Club Objis :
 Votez pour les prochains tutoriaux à publier
 Préparez vos entretiens techniques
 Valorisez votre profil / expertise
 Identifiez des opportunités d’emploi
 Recevez la newsletter objis.com

• Tous nos tutos
• Débutants Java
• Débutants Jee
• Ajax-ExtJS-Gwt
• Struts1-Struts2-Jsf
• Spring- Ejb3-Websrvce
• Hibernate
• AspectJ
• Tomcat-Jboss-Glassfi
• ActiveMq-Esb
• Subversion
• Ant-Maven
• Intégration Continue
• Architecture Soa
• Entretien technique