Partie 1 : Installation Maven

Etape 1 Tlchargez et d zipper larchive courante de MAVEN, par exemple apache-maven-2.2.1bin.zip. Vous obtenez le rpertoire apache-maven-2.2.1

tutoriel-maven-installation-analyse-1

Analysez le contenu du rpertoire bin

tutoriel-maven-installation-analyse-1bis

Analysez le contenu du rpertoire conf.

tutoriel-maven-installation-analyse-1ter

Etape 2 Ajouter la variable denvironnement utilisateur M2_HOME avec pour valeur le chemin du rpertoire apache-maven-2.2.1 (Ex : c:\outils\apache-maven-2.2.1-bin) Sous WinXP : Menu Dmarrer/Panneau de configuration/systme/Onglet Avanc/Zone variable utilisateur/Bouton Variable denvironnement/Ajouter

tutoriel-maven-installation-analyse-2

Etape 3 Dans la mme bote de dialogue, ajouter la variable denvironnement M2, avec comme valeur %M2_HOME%\bin

tutoriel-maven-installation-analyse-3

Etape 4 Crez ou mettez jour la variable denvironnement PATH avec %M2%

tutoriel-maven-installation-analyse-4

Etape 5 (Optionnel) Dans la mme bote de dialogue, ajouter la variable denvironnement MAVEN_OPTS pour spcifier paramtres JVM , par exemple -Xms256m -Xmx512m

tutoriel-maven-installation-analyse-5

Etape 6 Assurez-vous que la variable denvironnement JAVA_HOME pointe bien sur le rpertoire dinstallation 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 excuter : mvn version pour avoir la version de Maven installes Dmarrer/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 dfaut (ici fr_FR) ainsi que lencodage par dfaut (ici cp1252, reprsentant le jeu de caractre Windows)

Partie 2 : phases MAVEN

Contexte : comprendre les phases Maven Maven associe tout projet MAVEN des phases . A chacune de ces phases est associ/dclench par dfaut des taches mises en oeuvre par des plugins.

tutoriel-maven-installation-analyse-7bis

Dans le cycle de vie par dfaut dun projet Maven, les phases les plus utilises sont : validate : vrifie les prrequis dun 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 dautres projets sur le mme ordinateur deploy : publie le livrable pour dautres projets dans un repository distant Les phases sexcutente de faon squentielle de faon ce quune phase dpende de la phase prcdente. Par exemple, le lancement par lutilisateur de la phase test (mbn test) impliquera le lancement pralable par maven des phases validate et compile. Voici la liste complte 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 Crez le rpertoire : C :\formationmaven\TPs\TP1 Dans le rpertoire cr, excutez la commande suivante : mvn archetype:create -DgroupId=com.objis.mavenapps -DartifactId=monappli

tutoriel-maven-installation-analyse-11

Il semble que plusieurs fichiers soient tlchargs sur votre ordinateur. Aprs quelques secondes, vous pouvez lire :

tutoriel-maven-installation-analyse-12

Expliquez INFO : la commande archetype:create est dprcie. Elle est utilise ici uniquement des fins pdagogiques. Une meilleure pratique de cration de projet maven est prsente dans le tutoriel 2 cration de projet Maven via archetype:generate. Analysez le rpertoire .m2 cr par maven dans votre rpertoire utilisateurs systme ($HOME sous unix, Documents and Settings pour winxp) :

tutoriel-maven-installation-analyse-13

Expliquez Observez la cration par maven : du rpertoire monappli

tutoriel-maven-installation-analyse-8

 du fichier pom.xml la racine du rpertoire monappli des sous rpertoire src/main/java (code source) et src/test/java (code tests)

tutoriel-maven-installation-analyse-9

Analysez le contenu du sous-rpertoire mavenapps

tutoriel-maven-installation-analyse-10

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

tutoriel-maven-installation-analyse-14

Expliquez De mme, 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

Citez dautres balises que lon peut retrouver dans ce fichier pom.xl PHASE Compilation A partir du rpertoire monappli, lancez la commande : mvn compile

tutoriel-maven-installation-analyse-17

Analysez le contenu tu rpertoire monappli/target gnr

tutoriel-maven-installation-analyse-18

PHASE Test Lancez la commande : mvn test

tutoriel-maven-installation-analyse-19

Analysez le contenu tu rpertoire monappli/target gnr

tutoriel-maven-installation-analyse-20

Analysez le contenu tu rpertoire monappli/target/surefire-reports gnr

tutoriel-maven-installation-analyse-21

Expliquez PHASE Packaging Lancez la commande : mvn package Analysez le contenu tu rpertoire monappli/target gnr

tutoriel-maven-installation-analyse-22

Lancez la commande : java -cp target/monappli-1.0-SNAPSHOT.jar com.objis.mavenapps.App PHASE Install Lancez la commande : mvn install Montrez que le jar de lapplication est dsormais dans le repository local.

tutoriel-maven-installation-analyse-23

Confirmez la cration du jar monappli-1.0-SNAPSHOT.jar dans le rpertoire %USER_HOME%/.m2/repository/com/objis/demomaven

tutoriel-maven-installation-analyse-24

Nettoyage Lancez la commande : mvn clean Constatez la suppression du rpertoire target

tutoriel-maven-installation-analyse-8

Enchanement de phases Lancez la commande : mvn clean install Gnration du site web du projet Lancez la commande : mvn site Constatez la suppression du rpertoire target/site

tutoriel-maven-installation-analyse-25

Ouvrir le fichier index.html avec votre navigateur

tutoriel-maven-installation-analyse-26

Maven a gnr le site internet de votre projet. Ce site , mis jour, constitue un outil de communication pour lensemble de lquipe de dveloppement. Cliquez sur le lien Dependencies

tutoriel-maven-installation-analyse-27

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

Tutoriel Maven N2 : cration projet maven

Dans un rpertoire vide c :\formationmaven\TPs\TP2, lancez la commande : > mvn archetype:generate Vous obtenez un rsultat similaire ceci :

tutoriel-maven-creation-projet-archetype-generate-1 Maven vous demande dentrer le numro du type de projet pour le que vous lui demandez de gnrer un squelette.

Dans le cadre de ce tutoriel, nous allons choisir de crer un projet jee complet (en vue de cration dun livrable type EAR)

Partie 2 : Cration du projet

Entrez le chiffre 51 (maven-archetype-j2ee-simple) puis ENTREE Choisissez la version 1 puis ENTREE

tutoriel-maven-creation-projet-archetype-generate-3 Maven vous demande alors de prciser le groupId de votre projet, et plus gnralement les coordonnes MAVEN de votre projet. REMARQUE : si vous ne choisissez pas de numro et que vous tapez ENTREE Maven va crer le type 58 (maven-archetype-quikstart) gnrant un squelette de projet Maven dune application java simple. Maven y cre un fichier source Main.java dans src/main/java et un fichier test dans src/test.

tutoriel-maven-creation-projet-archetype-generate-2

Coordonnes Maven du projet crer Tout projet Maven est caractris par des coordonnes : un GroupId un ArtifactId Un version Les coordonnes Maven de notre projet Maven en cours de cration sont : GroupId : com.objis.demomaven ArtifactId : ObjisEarProject version : 1.0 Entrez ces coordonnes Maven

tutoriel-maven-creation-projet-archetype-generate-4 Maven vous demande ensuite le package de vos classes. Par dfaut il reprend le groupId. Acceptez la valeur par dfaut du package Maven gnre alors le squelette de votre projet :

tutoriel-maven-creation-projet-archetype-generate-5 Analysez les rpertoires et fichiers de configuration que maven a cr. a y est : vous avez cr votre projet Maven !

Partie 3 : lancienne mthode archetype:create

Pour des raisons de compatibilit entre les diffrentes versions de Maven, lancienne mthode de cration de projet est toujours possible, mais dprcie. Voici lquivalent : mvnarchetype:create -DgroupId=com.objis.demomaven DartifactId=ObjisEarProjectV2 -Dversion=1.0 -DarchetypeArtifactId=mavenarchetype-j2ee-simple Voici le rsultat de cette commande :

tutoriel-maven-creation-projet-archetype-generate-6

Notez linformation: [WARNING] this goal is deprecated. Please use mvn:archetype generate instead. Citez des exemples de projet AppFuse disponibles. En particuliers, expliquez la marche suivre pour crer les projets suivants : > Un projet Struts 2 > Un projet JSF > Un projet de service Jboss > Un projet de binding component JBI > Un projet Grails

Partie 4 : mieux comprendre le plugin archetype

RAPPEL : tout plugin correspond des goals = taches pour utiliser une des taches (= savoirfaire) dun plugin, lancer mvn plugin:tache (Ex : mvn archetype:generate) avec des paramtres (-Dparam1=valeur)

INFO : Le goal describe du plugin maven help vous permet de mieux connatre et comprendre dautres plugins (taches, paramtres...) Quel est par exemple le rsultat des commandes suivantes ? mvn help:describe mvn help:describe mvn help:describe mvn help:describe -Dplugin=help -Dplugin=help -Ddetail -Dplugin=help -Dfull -Dplugin=help -Dmojo=system -Dfull

Application au plugin archetype Quel est le rsultat des commandes suivantes ? mvn help:describe -Dplugin=archetype mvn help:describe -Dplugin=archetype -Ddetail mvn help:describe -Dplugin=archetype -Dfull En dduire au moins 3 autres savoir-faire (goal) du plugin archetype (en plus de create et generate).