Maven: The definitive Guide FR

Le premier cycle de vie auquel nous allons nous intéresser est le cycle de vie le plus simple de Maven. L'exécution de la commande mvn clean invoque le cycle de vie 'clean'. Celui-ci contient trois phases :

La phase la plus intéressante de ce cycle de vie est celle nommée clean. Le goal 'clean' du plugin Clean (clean:clean) est attaché à la phase clean du cycle de vie clean. Le goal clean:clean efface les traces laissées par la dernière construction en supprimant le répertoire de build. Si vous n'avez pas modifié l'emplacement du répertoire de build, celui-ci se trouve par défaut dans le répertoire ${basedir}/target. Lorsque vous exécutez le goal clean:clean, vous ne l'exécutez pas directement avec mvn clean:clean, vous l'utilisez par l'intermédiaire de la phase clean du cycle de vie du même nom. Exécuter la phase clean donne à Maven l'opportunité d'exécuter les autres goals rattachés à la phase pre-clean.

Par exemple, supposez que vous vouliez exécuter un goal antrun:run pour afficher une notification lors du pre-clean, ou archiver le répertoire de build du projet avant qu'il ne soit supprimé. Exécuter directement le goal clean:clean ne lancera pas le cycle de vie, vos tâches annexes ne seront donc pas exécutées. Par contre, si vous utilisez la phase clean, vous utiliserez le cycle de vie du même nom (clean) et traverserez de ce fait les trois phases du cycle de vie de jusqu'à la phase clean. L'Exemple 4.1, « Exécuter un goal lors du pre-clean » montre une configuration de build qui permet de rattacher le goal antrun:run à la phase pre-clean pour afficher une alerte avant la suppression de l'artefact en cours de nettoyage. Dans cet exemple, le goal antrun:run est utilisé pour exécuter des commandes Ant qui permettent de tester l'existence d'un artefact de projet. Ainsi, si l'artefact du projet est trouvé et est donc sur le point d'être effacé, une alerte s'affichera à l'écran.

<project>
  ...
  <build>
    <plugins>... <plugin>
    <artifactId>maven-antrun-plugin</artifactId>
    <executions>
      <execution>
        <id>file-exists</id>
        <phase>pre-clean</phase>
        <goals>
          <goal>run</goal>
        </goals>
        <configuration>
          <tasks>
            <!-- adds the ant-contrib tasks (if/then/else used below) -->
            <taskdef resource="net/sf/antcontrib/antcontrib.properties" />
            <available 
      file="${project.build.directory}/${project.build.finalName}.${project.packaging}"
      property="file.exists" value="true" />

            <if>
              <not>
                <isset property="file.exists" />
              </not>
              <then>
                <echo>No
                  ${project.build.finalName}.${project.packaging} to
                  delete</echo>
              </then>
              <else>
                <echo>Deleting
                  ${project.build.finalName}.${project.packaging}</echo>
              </else>
            </if>
          </tasks>
        </configuration>
      </execution>
    </executions>
    <dependencies>
      <dependency>
        <groupId>ant-contrib</groupId>
        <artifactId>ant-contrib</artifactId>
        <version>1.0b2</version>
      </dependency>
    </dependencies>
  </plugin>
  </plugins>
  </build> 
</project>

[INFO] Scanning for projects...
[INFO] ----------------------------------------------------------------------
[INFO] Building Your Project
[INFO]    task-segment: [clean]
[INFO] ----------------------------------------------------------------------
[INFO] [antrun:run {execution: file-exists}]
[INFO] Executing tasks
     [echo] Deleting your-project-1.0-SNAPSHOT.jar
[INFO] Executed tasks
[INFO] [clean:clean]
[INFO] Deleting directory ~/corp/your-project/target
[INFO] Deleting directory ~/corp/your-project/target/classes
[INFO] Deleting directory ~/corp/your-project/target/test-classes
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESSFUL
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1 second
[INFO] Finished at: Wed Nov 08 11:46:26 CST 2006
[INFO] Final Memory: 2M/5M
[INFO] ------------------------------------------------------------------------

En plus de configurer Maven pour exécuter un goal lors de la phase pre-clean, vous pouvez personnaliser le plugin Clean pour effacer des dossiers en plus du répertoire contenant le build. Vous pouvez configurer le plugin pour supprimer une liste de fichier en lui spécifiant un fileSet. L'exemple ci-dessous configure le plugin Clean pour supprimer tous les fichiers du répertoire target-other/ en utilisant des wildcards standard Ant : * et **.

<project>
  <modelVersion>4.0.0</modelVersion>
  ...
  <build>
    <plugins>
      <plugin>
        <artifactId>maven-clean-plugin</artifactId>
        <configuration>
          <filesets>
            <fileset>
              <directory>target-other</directory>
              <includes>
                <include>*.class</include>
              </includes>
            </fileset>
          </filesets>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

La plupart des utilisateurs Maven sont familiers avec le cycle de vie par défaut. C'est un modèle général de processus de build pour une application. Ce cycle de vie commence par la phase validate et se termine avec la phase deploy. Les phases du cycle de vie Maven par défaut sont présentées dans le Tableau 4.1, « Phases du cycle de vie Maven ».

Maven fait plus que construire des artefacts, il peut également produire de la documentation et différents rapports d'un ou plusieurs projets. La documentation du projet et la génération du site web ont un cycle de vie séparé. Celui-ci contient quatre phases :

Les goals suivants sont rattachés par défaut à ce cycle de vie :

Le type de packaging n'a aucune influence sur ce cycle de vie. Les types de packaging influent sur la création des artefacts, pas sur le type de site généré. Le plugin Site lance l'exécution de la production d'un document Doxia et de différents plugins permettant de générer des rapports. Vous pouvez générer un site à partir d'un projet Maven en exécutant la commande suivante :

$ mvn site

Pour plus d'informations à propos de la génération de site Maven, consultez le Chapitre 10, Génération du Site.