1) Installation de Maven :

L’installation de Maven sous Windows est particulièrement simple. Il suffit de télécharger l’install depuis le site officiel (http://maven.apache.org/), et d’ajouter dans votre path le chemin vers son répertoire bin (chez moi : C:\Program Files\Apache Software Foundation\Maven 1.0.2\bin). A ce stade vous pouvez tester maven en lançant en ligne de commande : Maven. Lors de son installation Maven doit créer les variables d’environement :

MAVEN_HOME -> C:\Program Files\Apache Software Foundation\Maven 1.0.2

Vous devrez configurer une variable dzns eclipse pour permettre une parfaite interaction entre les deux :

Window -> Preferences -> Java -> Build Path -> Classpath Variables -> New

ajouter : MAVEN_REPO -> votre repository

(chez moi : C:`\Documents and Settings\Eric\.maven\repository)

Attention le repository n’existe qu’après la première exécution de maven 2) Création de l’arborescence de votre projet : L’arborescence des projets sous Maven doit respecter une recommandation dsponible ici : Maven Conventions Voici l’arborescence cible :

/+- src
/|  +- main
/|  |  +- java
/|  |  |  +- ...|  |  +- resources
/|  |     +- ...|  +- test
/|  |  +- java
/|  |  |  +- ...|  |  +- resources
/|  |     +- ...|  +- site
/|     +- xdoc
/|        +- ...+- target
/|  +- ...+- project.xml
+- README.tx
+- LICENSE.txt

3) Le fichier de configuration de Maven (project.xml) : project.xml

<?xml version="1.0" encoding="UTF-8"?>
<project>	
	<!--		
		POM : Project Object Model, c'est le modèle objet du projet.	
	-->	
	<pomVersion>1</pomVersion>	
	<groupId>tellaw.org</groupId>	
	<currentVersion>0.1-DEMO</currentVersion>	
	<organization />	
	<repository/>	
	<name>TagLib Sample</name>	
 
	<!--		
		C'est le nom de l'artifact  réaliser. 
		Sous Maven, les livrables à réaliser sont des artifacts.	
	-->	
	<artifactId>taglib_sample</artifactId>	
 
	<!--		
		Les dépendances : Maven va tenir à jour vos dépendances depuis son repository.		
		- Il téléchargera depuis un repository distant la version voulue si vouq ne la possédez pas encore.		
		- Notez la propriété WAR.BUNDLE = true, permettant d'embarquer la dépendance dans le war de livraison. 	
	-->	
	<dependencies>		
 
		<dependency>			
			<groupId>log4j</groupId>			
			<artifactId>log4j</artifactId>			
			<version>1.2.8</version>			
			<properties>				
				<war.bundle>true</war.bundle>			
			</properties>		
		</dependency>		
 
		<dependency>			
			<id>junit</id>			
			<version>3.8.1</version>		
		</dependency>		
 
		<dependency>			
			<groupId>servletapi</groupId>			
			<artifactId>servletapi</artifactId>			
			<version>2.4-20040521</version>		
		</dependency>		
 
		<dependency>			
			<groupId>jspapi</groupId>			
			<artifactId>jsp-api</artifactId>			
			<version>2.0-20040521</version>		
		</dependency>	
 
	</dependencies>	
 
	<!--		
		Définition du projet.	
	-->	
	<build>		
		<sourceDirectory>src/main/java</sourceDirectory>		
		<unitTestSourceDirectory>src/test/java</unitTestSourceDirectory>		
		<resources>			
			<resource>				
				<directory>src/main/webapp</directory>				
				<filtering>false</filtering>			
			</resource>		
		</resources>		
		<unitTest>			
			<includes>				
				<include>**/*Test.java</include>			
			</includes>		
		</unitTest>	
	</build>
</project>

4) Configuration du projet pour le workspace d’eclipse :

Tous les utilisateurs d’éclipse connaissent le soucis de dépendances perdues en cours de projets, a re-centraliser réguliérement, ou dont les versions sont différentes entre les intervenant du projet !!!!

Nous avons tous un jour hurler notre rage face à un Eclipse qui n’avait plus ses fichiers projets : .classpath et .project… Et bien c’est terminé, Maven peux générer pour vous les fichiers de configuration projet d’Eclipse, la commande magique ???? simpleeee :

maven eclipse

Résultat :

• Maven va vérifier les dépendances et télécharger celles dont le projet à besoin.
• Maven va reconstruire les fichiers projets : .classpath et .project
• Eclipse se basera sur les librairies de Maven.

5) Compilation et livraison sous Maven : La compilation est simple avec Maven :

maven war -> Création d’un war (Compilation, Tests Unitaires…).

maven jar -> Création d’un jar avec le projet.

maven java:compile-> Simple compilation du projet.

maven site -> Création d’un site d’information sur la compilation et la documentation (sortie dans target/docs).

maven clean -> Nettoyage des fichers de sortie de maven.

maven eclipse -> Reconstruit le projet eclipse.

Lors de chaque tache Maven validera que toutes ses dépendances sont présentes, si ce n’est pas le cas, il les télécharges depuis http://www.ibiblio.org/maven/ Maven utilise le repertoire target pour sortir ses fichiers. Beaucoup d’options et de plugins existent pour Maven, je ne peux évidemment pas en faire un listing. Cet article donne un kit de quickstart, pas une formation complète. Liens utiles :

• Site officiel
• Tutorial Maven