Utiliser Maven 2
Date de publication : 04/08/2008 , Date de mise à jour : 04/08/2008
2. Organisation des fichiers
2. Organisation des fichiers
Maven propose une structure de fichier complète. Il s'agit de la configuration par
défaut mais elle est surchargeable.
Le principe général est de limiter le répertoire racine du projet à trois élements :
le fichier de description du projet
pom.xml
, le répertoire
src
qui contient uniquement les sources du projet et le répertoire
target
qui contient tous les éléments créé par Maven.
Structure des répertoires |
src/main/java |
Contient les sources Java de l'application |
src/main/resources |
Contient les resources de l'application |
src/main/webapp |
Contient les fichiers de l'application Web |
src/test/java |
Contient les sources Java pour les tests unitaires |
src/test/resources |
Contient les resources pour les tests unitaires |
src/site |
Contient les fichiers pour le site |
target |
Répertoire de destination de tous les traitements Maven |
Le tableau ci dessus ne présente que les répertoires les plus courants. Aucun de ces
répertoires n'est indispensable il est tout à fait possible de ne créer, par
exemple, que le répertoire src/main/java pour commencer un projet.
Faut-il tout configurer ou laisser les valeurs par défaut ?
Laisser la configuration par défaut apporte la standardisation des projets. Cela
peut s'avérer très important. Le passage d'une grande majorité des projets Java à
Maven 2 apporte une grande lisibilité. Quelque soit le framework (par exemple Spring
ou Hibernate), si on en consulte les sources, on trouve le code Java dans
src/main/java, les tests unitaires dans src/test/java etc.. Si on a téléchargé les
sources, on pourra même compiler ou packager le projet avec des commandes Maven.
|
En apportant une première classe Java au projet définit avec le pom.xml créé
précédemment, la structure du projet ressemble alors à ceci :
|
Structure des fichiers pour le projet |
+- cours-maven-example/
+- src
+- main
+- java
+- Test.java
+- pom.xml
|
|
Il est alors déjà possible d'utiliser Maven pour compiler les sources du projet. Il
faut pour cela utiliser la commande
mvn compile
(en se positionnant dans le répertoire du projet). Le résultat sera le suivant :
|
Exécution de maven pour la compilation |
~/cours-maven-example$ mvn compile
[INFO] Scanning for projects...
[INFO] ------------------------------------------------------------------------
[INFO] Building Projet d'exemple pour le cours Maven
[INFO] task-segment: [compile]
[INFO] ------------------------------------------------------------------------
[INFO] [resources:resources]
[INFO] Using default encoding to copy filtered resources.
[INFO] [compiler:compile]
[INFO] Compiling 1 source file to ~\cours-maven-example\target\classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 3 seconds
[INFO] Finished at: Tue Aug 12 11:38:35 CEST 2008
[INFO] Final Memory: 2M/9M
[INFO] ------------------------------------------------------------------------
|
Architecture des fichiers du projet |
+- cours-maven-example/
+- src
+- main
+- java
+- Test.java
+- target
+- classes
+- Test.class
+- pom.xml
|
Les sources présentés sur cette pages sont libre de droits, et vous pouvez les utiliser à
votre convenance. Par contre cette page de présentation de ces sources constitue une oeuvre
intellectuelle protégée par les droits d'auteurs. Copyright Matthieu Lux . Aucune
reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu
: textes, documents, images, etc sans l'autorisation expresse de l'auteur. Sinon vous
encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérets.