FAQ MavenConsultez toutes les FAQ

Maven recherche les dépendances dans le repository dit central, présent à l'adresse : http://search.maven.org/

Sur ce serveur, dans un sous-répertoire correspondant au groupId (les '.' permettent de séparer chacun des sous-répertoires) puis à l'artifactId, puis enfin à la version, se trouvent le fichier POM de la dépendance ainsi que le fichier .jar (ou autre selon le type d'artefact).

Pour ajouter une dépendance à un projet, il suffit de la déclarer dans le pom.xml.

Maven s'occupera de la récupérer (s'il s'agit d'un projet ayant une licence compatible avec la redistribution) :

1
2
3
4
5
6
7
8
9
10
11
12
13
  
<project> 
... 
  <dependencies> 
    <dependency> 
      <groupId>junit</groupId> 
      <artifactId>junit</artifactId> 
      <version>3.8.1</version> 
      <scope>test</scope> 
    </dependency> 
  </dependencies> 
... 
</project>

On doit préciser à Maven la version de la dépendance que l'on souhaite utiliser :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<project> 
... 
  <dependencies> 
  
    <dependency> 
      <groupId>junit</groupId> 
      <artifactId>junit</artifactId> 
      <version>3.8.1</version> 
      <scope>test</scope> 
    </dependency> 
  
  </dependencies> 
... 
</project>

Le scope (la portée) d'une dépendance est déclaré par la balise scope dans la déclaration d'une dépendance :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<project> 
... 
  <dependencies> 
  
    <dependency> 
      <groupId>junit</groupId> 
      <artifactId>junit</artifactId> 
      <version>3.8.1</version> 
      <scope>test</scope> 
    </dependency> 
  
  </dependencies> 
... 
</project>

• compile : la dépendance est nécessaire pour toutes les phases du build ;
• test : la dépendance est nécessaire pour la compilation/l'exécution des tests ;
• runtime : la dépendance est nécessaire à l'exécution, mais pas à la compilation ;
• provided : la dépendance est nécessaire à la compilation, mais ne sera pas packagée avec le projet. Typiquement, un container lui fournira cette dépendance (par exemple servlet-api).
  

Certaines dépendances, de part leur licence, ne peuvent pas être distribuées via le repository central de Maven. Il faut alors trouver le .jar correspondant à cette dépendance et le charger dans le répository local en utilisant la commande :

1
2
mvn install:install-file -Dfile=<chemin-du-fichier> -DgroupId=<group-id> \ 
    -DartifactId=<artifact-id> -Dversion=<version>  -Dpackaging=<packaging> -DgeneratePom=true