Apache Maven par Johann AVELINE
Utilisation
Créer un Plug-in Maven
Il est possible de créer ses propres plugins Maven en utilisant l'Archetype correspondant.
Dans une console de commandes, exécuter la commande suivante :
mvn archetype:create
-DgroupId=exempleplugin
-DartifactId=exemple-plugin
-DarchetypeGroupId=org.apache.maven.archetypes
-DarchetypeArtifactId=maven-archetype-mojo
-DarchetypeVersion=1.0-alpha-4
Vous trouverez une classe Java nommée /exemple-plugin/src/main/java/exempleplugin/MyMojo.java contenant le code du plugin. Ce modèle de plugin généré par l'archetype a créé un goal nommé touch. Pour utiliser ce plugin, il faut maintenant l'installer.
Dans une console de commandes,accéder au répertoire du projet de plugin, et exécuter les commandes suivantes :
mvn install
mvn exempleplugin:exemple-plugin:touch
Vous verrez alors un répertoire target créé dans le répertoire projet et un fichier touch.txt à l'intérieur.
Définir un paramètre au Plug-in
On ajoute une variable de classe dans le fichier Java du plugin comme ceci :
/**
* Mon paramètre.
* @parameter expression="${mymavenparameter}"
* @required
*/
private String myJavaParameter;
Nous venons de créer une variable myJavaParameter, de type String, obligatoire(@required) et correspondant au paramètre mymavenparameter du pom.xml du projet exécutant le plugin :
<project>
...
<build>
<plugins>
<plugin>
<groupId>exempleplugin</groupId>
<artifactId>exemple-plugin</artifactId>
<configuration>
<mymavenparameter>valeur</mymavenparameter>
</configuration>
</plugin>
</plugins>
</build>
...
</project>
Récupérer les propriétés du projet exécutant le Plug-in
On ajoute la variable de classe suivante (avec l'annotation) :
/**
* Projet en cours de deploiement.
* @parameter expression="${project}"
*/
private org.apache.maven.project.MavenProject project;
Nous disposons maintenant d'une variable project qui sera automatiquement initialisée par Maven à l'exécution et nous avons maintenant accès aux informations telles que le groupId, l'artifactId, la version du projet, etc.
Voir les sources d'un Plug-in
Les sources des plugins Maven sont accessibles, ce qui permet à la fois de voir comment est réalisé un plugin, mais également de proposer votre participation. Prenons pour exemple le plugin clean, dont la page principale est http://maven.apache.org/plugins/maven-clean-plugin. Les sources du plugin clean sont visibles dans un navigateur via ViewVC à l'adresse suivante http://svn.apache.org/viewvc/maven/plugins/trunk/maven-clean-plugin.
On peut également créer une copie locale du plugin clean en utilisant Subversion avec la commande suivante :
svn checkout http://svn.apache.org/repos/asf/maven/plugins/trunk/maven-clean-plugin maven-clean-plugin
| << page précédente | page suivante >> |
