On part pour cela d'un projet Java vide, sous Eclipse. Pour créer un tel projet, on pourra se référer aux tutoriaux Premiers pas avec Eclipse et Premiers pas avec son projet dans Eclipse, sur Java le soir.

La création d'un nouveau projet Maven se fait de façon classique, comme tout autre projet.

Le panneau de création de projet s'ouvre alors. Il existe de nombreuses options dans ce panneau, on s'intéresse ici à l'option Maven, que l'on peut filtrer en tapant Maven dans la barre de filtrage.

On peut en fait créer un projet Maven de trois façons.

Créer un projet Maven simple requiert tout de même un peu plus d'informations que la création d'un projet Java de base. Le deuxième panneau nous demande essentiellement deux choses. Tout d'abord si nous souhaitons utiliser un archétype Maven. Un archétype Maven est en fait un modèle de projet, utile pour les projets un peu complexe ou nécessitant une configuration fastidieuse à créer. C'est le cas d'applications web, Java EE, Spring, etc... La seconde chose est l'endroit où l'on souhaite enregistrer notre projet. Il n'y a pas de raison pour nous de choisir un autre endroit que l'endroit par défaut.

Nous n'allons pas utiliser d'archétype, on coche donc la case qui permet de sauter la phase de sélection de l'archétype, et on laisse la localisation par défaut pour ce projet.

Une fois cette première étape passée, Maven nous demande des informations très importantes, dont il faut bien comprendre la signification.

Tout d'abord, il faut savoir que Maven reconnaît tous les projets qu'il gère par trois paramètres.

Remplissons donc ce panneau avec nos valeurs afin de terminer la création de notre projet. On ne touche pas à l'élément packaging, qui est JAR pour les projets Java classiques.

Notre projet créé apparaît donc dans la vue Package explorer d'Eclipse sous la forme suivante.

On peut remarquer d'emblée plusieurs choses.

Tout d'abord, Maven crée des projets Java avec une structure particulière. Il crée quatre répertoires de code source : src/main/java et src/test/java, pour le code source proprement dit de notre projet et des tests. Ces deux répertoires ont deux statuts très différents. Les deux autres répertoires créés sont src/main/resources et src/main/resources. Ce sont des répertoires dans lequel on range est fichiers de ressources, différents du code.

Le code source de notre application doit être créé dans src/main/java.

On peut redéfinir cette structure standard (pour Maven) de répertoires, mais il n'y a pas d'intérêt à le faire.

Maven nous a ensuite créé un répertoire target. C'est le répertoire qu'il utilise pour produire tous les fichiers de notre projet. Ce sont les fichiers des classes compilées, les rapports de test, les fichiers JAR, WAR, etc...

Enfin Maven nous a créé un fichier pom.xml. Ce fichier, appelé fichier POM (Project Object Model) est le fichier central de notre projet Maven, dans lequel Maven enregistre toutes les informations dont il a besoin. La structure complète d'un fichier POM peut être très complexe, nous n'en verrons que quelques aspects.

On peut aussi remarquer que Maven a configuré notre projet comme un projet Java 5. C'est le premier point que nous allons revoir, passer en Java 8, un peu plus à jour que Java 5, qui date tout de même de 2004.

La capture d'écran suivante nous montre le fichier POM ouvert. On reconnaît les différents éléments que nous avons rempli dans ce fichier XML. Il est parfaitement possible de créer un projet Maven entièrement à la main en créant ce fichier à partir de rien.

La première chose à configurer est la version de Java que nous voulons utiliser, ainsi qu'un point de configuration qui peut paraître un peu obscur à ce stade : l'encodage des fichiers source.

Comme on le voit sur la capture d'écran suivante, on a ajouté les lignes suivantes à notre fichier POM.

<properties>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
</properties>

Ces propriétés font ce que l'on pense qu'elles font. Elles indiquent à Maven que notre code source est du Java 8, qu'il doit être compilé en Java 8, et que les fichiers source sont encodés en UTF-8.

Le problème est que malgré cette déclaration, Eclipse continue à nous dire que notre projet est un projet Java 5. Pour lui faire entendre raison, il faut en fait rafraîchir la configuration de notre projet Maven. Cela se fait dans le menu contextuel de notre projet Eclipse, sous l'option Maven, se trouve une commande de rafraîchissement, comme dans la capture suivante.

On peut configurer certains aspects de ce rafraîchissement. Nous n'allons pas entrer dans ces détails et conserver la configuration par défaut.

Notre projet se met correctement à jour, et passe en Java 8 comme nous l'avons déclaré.

Une des premières utilités de Maven est de gérer automatiquement pour nous les dépendances de nos projets Java. Un projet industriel peut dépendre de dizaines, voire de centaines d'autres projets, certains développés en interne, d'autre en externe, qu'ils soient Open-source ou non.

Maven propose un mécanisme très pratique de déclaration de ces dépendances. Il gère le téléchargement automatique de ces dépendances dans un cache sur notre disque local, et la déclaration de ces dépendances dans Eclipse.

Ajoutons le code suivant dans notre POM.

<dependencies>
    <dependency>
        <groupId>dom4j</groupId>
        <artifactId>dom4j</artifactId>
        <version>1.6.1</version>
    </dependency>
</dependencies>

Cette déclaration indique à Maven que nous souhaitons mettre Dom4J en version 1.6.1 en dépendance de notre projet. Maven va commencer par regarder dans son cache local si cette dépendance s'y trouve. Si ce n'est pas le cas, il va interroger un repository de dépendances sur Internet (en général il s'agira de Maven Central : http://search.maven.org/, on peut également redéfinir ce point) afin de savoir si cette dépendance existe. Si tel est le cas, elle sera ajoutée au cache local.

Maven est assez malin pour se rendre compte que notre dépendance Dom4J dépend en fait elle même d'un autre projet : xml-apis. Il va donc également aller chercher cette dépendance, dite transitive. En fait il n'y a rien de magique là-dedans, cette dépendance est déclarée dans le POM de Dom4J.

Maven est également capable d'aller chercher le code source et la Javadoc de nos dépendances. On peut le configurer pour qu'il le fasse par défaut. Si ce n'est pas le cas, on peut demander ces téléchargement élément par élément, dans le menu contextuel de la dépendance.

Comme nous l'avons dit en début de ce tutorial, Maven est un outil séparé d'Eclipse, qui peut d'ailleurs se télécharger séparément.

Lorsque l'on télécharge Eclipse, on télécharge avec lui une version de Maven, qui est embarquée dans Eclipse. On peut aussi choisir d'utiliser une autre version de Maven, installée dans un répertoire de notre disque, avec sa configuration propre.

Pour ce faire, il faut aller chercher dans les Preferences d'Eclipse (Menu Window).

On peut filtrer l'ensemble des préférences avec le mot-clé Maven, et obtenir l'ensemble des préférences Eclipse pour Maven.

La première que nous allons voir est la préférence Installation, qui nous permet de choisir l'installation de Maven qu'Eclipse doit utiliser. On peut aller chercher une installation locale au travers du bouton Add... et naviguer vers le bon répertoire.

La deuxième préférence que nous voyons ici, permet d'avoir des informations sur la configuration de Maven. En particulier, on peut lire ici le répertoire que Maven utiliser comme cache. Un cache bien utilisé peut rapidement atteindre plusieurs Go de données. Il n'est donc pas inutile de s'arranger pour que tous nos projets Eclipse pointe bien vers le même Maven, et vers le même cache.

Il est possible d'utiliser plusieurs installations de Maven, dans plusieurs versions différentes. Cela dit, toutes ces installations peuvent pointer vers le même cache. La structure du cache Maven est très simple, et reste compatible de version en version.