Maven: The Definitive Guide

第一个你将感兴趣的生命周期是Maven中最简单的生命周期。运行mvn clean将调用清理生命周期，它包含了三个生命周期阶段：

在清理生命周期中最有意思的阶段是clean阶段。Clean插件的clean目标（clean:clean）被绑定到清理生命周期中的clean阶段。目标clean:clean通过删除构建目录删除整个构建的输出。如果你没有自定义构建目录位置，那么构建目录就是定义在超级POM中的/data/hudson-temporal-data/hudson-orchestrator-home/workspace/Book-To-Production/content-zh/target。当你运行clean:clean目标的时候你并不是直接运行mvn clean:clean，你可以通过执行清理生命周期的clean阶段运行该目标。运行clean阶段能让Maven有机会执行其它可能被绑定到pre-clean阶段的目标。

例如，假设你想要在pre-clean的时候触发一个antrun:run目标任务来输出一个通知，或者需要在项目构建目录被删除之前将其归档。简单的运行clean:clean目标不会完整的执行该生命周期，但是指定clean阶段就能使用clean生命周期，并且逐个的经过生命周期阶段，直到到达clean阶段。Example 10.1, “在pre-clean阶段触发一个目标”展示了一个样例，在它的构建配置中，绑定了antrun:run至pre-clean阶段，输出一个警告告诉用户项目构件即将被删除。该例中，antrun:run目标被用来执行一些随意的Ant命令来检查项目的构件。如果项目的构件将要被删除，它会打印该信息至屏幕。

<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="/data/hudson-temporal-data/hudson-orchestrator-home/workspace/Book-To-Production/content-zh/target/book.jar"
              property="file.exists" value="true" />

            <if>
              <not>
                <isset property="file.exists" />
              </not>
              <then>
                <echo>No
                  book.jar to
                  delete</echo>
              </then>
              <else>
                <echo>Deleting
                  book.jar</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] ------------------------------------------------------------------------

除了在pre-clean阶段配置Maven去运行一个目标，你也可以自定义Clean插件去删除构建输出目录以外的文件。你可以配置该插件去删除那些在fileSet中指定的文件。下面的样例配置了Clean插件，使用标准的Ant文件通配符：*和**，删除所有target-other/目录中的.class文件。

<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>

大部分Maven用户将会对默认生命周期十分熟悉。它是一个软件应用程序构建过程的总体模型。第一个阶段是validate，最后一个阶段是deploy。这些默认Maven生命周期的阶段如Table 10.1, “Maven默认生命周期阶段”所示：

Maven不仅仅能从一个项目构建软件构件，它还能为一个或者一组项目生成项目文档和报告。项目文档和站点生成有一个专有的生命周期，它包含了四个阶段：

默认绑定到站点生命周期的目标是：

打包类型通常不更改此生命周期，因为打包类型主要和构件创建有关，和站点生成没有太大的关系。Site插件触发Doxia执行文档生成，以及执行其它报告生成插件。你可以通过运行如下命令从一个Maven项目生成一个站点：

$ mvn site

有关更多的Maven站点生成信息，查看Chapter 15, 站点生成。