Organisation et dépendances des projets

a. Les éléments du POM concernés

Les exemples du projet banque-persistance ont mis en évidence dans les premiers chapitres quelques éléments au niveau du POM. Les éléments centraux impliqués dans la gestion des dépendances sont les suivants :

<project> 
  ... 
  <dependencyManagement/> 
  <dependencies/> 
 
  <repositories/> 
  ... 
  <profiles/> 
</project> 

b. Illustration des dépendances

Le plugin officiel de la fondation Apache centré sur la notion de dépendances...

a. La transitivité

Au début de ce chapitre, alors que seulement quatre dépendances sont déclarées dans le POM du projet banque-persistance, l’affichage complet de l’arborescence des dépendances du projet présente sept dépendances.

Ce phénomène s’explique par la notion de transitivité utilisée par Apache Maven pour résoudre le graphe des dépendances d’un projet. Le principe général de la transitivité repose sur le fait que lorsqu’un projet A possède une dépendance vers un projet B et que ce projet B dépend du projet C, alors le projet A dispose d’une dépendance transitive vers le projet C.

Ainsi, dans le projet de persistance, avec l’ajout des dépendances pour la mise en place de JPA 2 et de Spring Framework, le POM du projet contient désormais neuf dépendances directes, comme le montre le schéma suivant :

L’affichage du graphe complet des dépendances identifiées par Apache Maven présente alors 36 dépendances, c’est-à-dire 27 dépendances transitives. Les dépendances sont résolues dans l’ordre de leur déclaration dans le POM. Une valeur a été ajoutée en début de ligne de chaque dépendance pour identifier le niveau de la dépendance par rapport au projet, à savoir :

fr.eni.mvnbook:banque-persistance:jar:1.0.0-SNAPSHOT 
[1] +- junit:junit:jar:4.12:test 
[2] |  \- org.hamcrest:hamcrest-core:jar:1.3:test 
[1] +- org.hibernate:hibernate-core:jar:5.4.2.Final:compile 
[2] |  +- org.jboss.logging:jboss-logging:jar:3.3.2.Final:compile 
[2] |  +- javax.persistence:javax.persistence-api:jar:2.2:compile 
[2] |  +- org.javassist:javassist:jar:3.24.0-GA:compile 
[2] |  +- net.bytebuddy:byte-buddy:jar:1.9.10:compile 
[2] |  +- antlr:antlr:jar:2.7.7:compile 
[2] |  +- org.jboss.spec.javax.transaction:jboss-transaction-api_1.2_spec:jar:1.1.1.Final:compile ...

a. Le type POM

Pour créer un POM dont le but unique est de factoriser les informations communes à tous les projets, Apache Maven propose le type de projet pom.

Un projet de type pom est un projet spécifique car il possède uniquement le fichier pom.xml. Du fait de cette structure simplifiée, son cycle de vie est par conséquent minimal et contient uniquement deux phases comme le montre le schéma suivant.

Ainsi, l’artefact de sortie est le fichier pom.xml qui sera déployé dans le référentiel local et le référentiel distant.

b. Mise en place du Corporate POM

La mise en place du Corporate POM est également l’occasion de renseigner...

a. Les propriétés disponibles

La syntaxe de toutes les propriétés est la même, à savoir : ${nom.de.la.propriété}.

Tous les éléments simples du POM sont accessibles à partir du préfixe ${project.*}. Le super POM, affiché dans le chapitre Présentation d’Apache Maven, utilise cette syntaxe notamment pour préciser le nom de l’artefact de sortie par défaut d’un projet.

<project> 
<build> 
 ...    
 <finalName>${project.artifactId}-${project.version}</finalName> 
 ... 
</build>  
</project> 

La propriété ${project.basedir} permet d’accéder au chemin racine du projet, cette valeur est désormais également accessible via la propriété ${basedir} depuis Apache Maven 3.0.

La propriété ${maven.build.timestamp} a été utilisée dans les exemples précédents, elle est valorisée dans Apache Maven avec la date début de construction du projet et peut être utile dans les fichiers textes des archives.

Il est également possible d’accéder aux variables d’environnement du système grâce au préfixe ${env.*}.

b. Créer une propriété

Pour créer des propriétés dans le POM, il suffit d’utiliser l’élément <properties> disponible à la racine de l’élément <project>. Le nom de la balise XML alors créée est le nom de la propriété en question. Par exemple, dans le POM parent de tous les projets...