1 简介

本文将详情基于 Apache Maven 3 的项目构建的基本概念和方法。
Maven 是一套标准的项目构建和管理工具，使用统一规范的脚本进行项目构建，简单易用，摒弃了 Ant 中繁琐的构建元素，并具备较高的可重用性。
读完本文，你将理解 Maven 的基本概念和使用它进行项目构建的基本方法。

2 什么是 Maven

Maven 是 Apache 组织下的一个跨平台的项目管理工具，它主要用来帮助实现项目的构建、测试、打包和部署。
Maven 提供了标准的软件生命周期模型和构建模型，通过配置就能对项目进行全面的管理。
它的跨平台性保证了在不同的操作系统上可以使用相同的命令来完成相应的任务。
Maven 将构建的过程笼统成一个个的生命周期过程，在不同的阶段使用不同的已实现插件来完成相应的实际工作，这种设计方法极大的避免了设计和脚本编码的重复，极大的实现了复用。

3 Maven vs Ant

Ant 也是 Apache 组织下的一个跨平台的项目构建工具，它是一个基于任务和依赖的构建系统，是过程式的。开发者需要显示的指定每一个任务，每个任务包含一组由 XML 编码的指令，必需在指令中明确告诉 Ant 源码在哪里，结果字节码存储在哪里，如何将这些字节码打包成 JAR 文件。Ant 没有生命周期，你必需定义任务和任务之间的依赖，还需要手工定义任务的执行序列和逻辑关系。这就无形中造成了大量的代码重复。

Maven 不仅是一个项目构建工具还是一个项目管理工具。它有商定的目录结构（表 1）和生命周期，项目构建的各阶段各任务都由插件实现，开发者只要遵照商定的目录结构创立项目，再配置文件中生命项目的基本元素，Maven 就会按照顺序完成整个构建过程。Maven 的这些特性在肯定程度上大大减少了代码的重复。

表 1. Maven 目录结构

4 项目对象模型 POM-Maven 的灵魂

POM 即 Project Object Module，项目对象模型，在 pom.xml 文件中定义了项目的基本信息、源代码、配置文件、开发者的信息和角色、问题追踪系统、组织信息、项目受权、项目的 url、以及构建项目所用的插件，依赖继承关系。开发人员需按照 maven 定义的规则进行 POM 文件的编写，清单 1 为一个 POM 文件示例。

清单 1. POM 文件示例

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0                      http://maven.apache.org/maven-v4_0_0.xsd">  <modelVersion>4.0.0</modelVersion>  <! – The Basics – >  <groupId> … </groupId>  <artifactId> … </artifactId>  <version> … </version>  <packaging> … </packaging>  <dependencies> … </dependencies>  <parent> … </parent>  <dependencyManagement> … </dependencyManagement>  <modules> … </modules>  <properties> … </properties>  <! – Build Settings – >  <build> … </build>  <reporting> … </reporting>  <! – More Project Information – >  <name> … </name>  <description> … </description>  <url> … </url>  <inceptionYear> … </inceptionYear>  <licenses> … </licenses>  <organization> … </organization>  <developers> … </developers>  <contributors> … </contributors>  <! – Environment Settings – >  <issueManagement> … </issueManagement>  <ciManagement> … </ciManagement>  <mailingLists> … </mailingLists>  <scm> … </scm>  <prerequisites> … </prerequisites>  <repositories> … </repositories>  <pluginRepositories> … </pluginRepositories>  <distributionManagement> … </distributionManagement>  <profiles> … </profiles> </project>

在每个 POM 文件中都含有的元素是该 project 的坐标，它包含三个基本元素。

groupId 定义了项目属于哪个组，这有助于在大的范围上区别项目。artifactId 定义了这个项目在组中唯一的 ID。name 是一个客户友好的项目名称。

除了项目坐标外，modelVersion 指定 POM 模型的版本，version 指明当前项目的版本，packaging 指定了项目发布时的打包类型。

在下文中提及的插件，依赖，生命周期等也都有相应的 POM 元素在文件中有所表现。

5 Maven 插件和仓库

Maven 本质上是一个插件框架，它的核心并不执行任何具体的构建任务，仅仅定义了笼统的生命周期，所有这些任务都交给插件来完成的。每个插件都能完成至少一个任务，每个任务即是一个功能，将这些功能应用在构建过程的不同生命周期中。这样既能保证拿来即可使用，又能保证 maven 本身的繁杂和冗余。

将生命周期的阶段与插件目标相互绑定，即可以在特定的阶段完成具体的构建任务。例如清单 2 中的代码就是要在 validate 这个阶段执行 maven-antrun-plugin 的 run 目标，具体的任务在 <target></target> 元素中定义。

清单 2. 插件

<plugins>     <plugin>         <groupId>org.apache.maven.plugins</groupId>         <artifactId>maven-antrun-plugin</artifactId>         <version>1.6</version> <executions> <execution>     <id>version</id>    <phase>validate</phase>    <configuration> <target>    具体任务</target> </configuration> <goals> <goal>  run  </goal>     </goals> </execution>     </executions>     </plugin> </plugins>

Maven 项目中的插件，依赖和项目构建的输出都可以由 Maven 的坐标进行唯一的区分，基于这种机制，Maven 将所有项目的构件文件放置在一个统一的位置，也就是 Maven 仓库。所有 Maven 项目可以从同一个 Maven 仓库中获取自己所需要的依赖 JAR，这节省了磁盘资源。实际的 Maven 项目中不需要存储依赖的文件，只要要在 POM 文件中生成依赖关系，在构建的时候 Maven 就会自动去仓库中下载。

在安装了 Maven 的机器上，会生成一个 ~.m2\repository 目录，这个目录被称为本地仓库，当 Maven 查找需要的依赖时，首先会在本地查找，假如本地仓库中存在，则直接使用，否则 Maven 会去远程仓库查找，查找到后下载到本地进行使用。
当然还有少量镜像仓库可供使用,如阿里云镜像

当个人所在的网络无法访问公共的 Maven 仓库时，可以在 settings.xml 中设置代理商服务器。打开 ~.m2\settings.xml，假如没有则复制 $Maven_HOME/conf/settings.xml 到此路径下，加入清单 3 中的代码：

清单 3. 代理商

<proxies>   <proxy>      <active>true</active>      <protocol>http</protocol>      <host> 代理商地址 </host>      <port>8080</port>      <username> 客户名 </username>      <password> 密码 </password>    </proxy> </proxies>

6 依赖、聚合和继承

• 依赖

我们项目中依赖的 Jar 包可以通过依赖的方式引入，通过在 dependencies 元素下增加 dependency 子元素，可以公告一个或者多个依赖。通过控制依赖的范围，可以指定该依赖在什么阶段有效。Maven 的几种依赖范围：

表 2. 依赖范围

清单 4 中表示引入对 Junit 的依赖 , 这个依赖关系产生作用的阶段是 <scope>test</scope>。

清单 4. 依赖

<dependency>    <groupId> </groupId>     <artifactId> </artifactId>     <version> </version>     <optional>true<optional>  </dependency>

依赖是具备传递性的，例如 Project A 依赖于 Project B，B 依赖于 C，那么 B 对 C 的依赖关系也会传递给 A，假如我们不需要这种传递性依赖，也可以用 <optional> 去除这种依赖的传递，如清单 5。

清单 5. 选择性依赖

<dependency> <groupId>commons-logging</groupId> <artifactId>commons-logging</artifactId> <version>1.1.1</version> <optional>true<optional> </dependency>

假设第三方的 jar 包中没有使用 <optional> 来去除某些依赖的传递性，那么可以在当前的 POM 文件中使用 <exclusions> 元素公告排除依赖，exclusions 可以包含一个或者者多个 exclusion 子元素，因而可以排除一个或者者多个传递性依赖。如清单 6。

清单 6. 排除依赖

<dependency>         <groupId>org.springframework</groupId>       <artifactId>spring-core</artifactId>       <exclusions>             <exclusion>                      <groupId>commons-logging</groupId>                          <artifactId>commons-logging</artifactId>             </exclusion>       </exclusions>  </dependency>

• 聚合

现实中一个项目往往是由多个 project 构成的，在进行构建时，我们当然不想针对多个 project 分别执行屡次构建命令，这样极容易产生遗漏也会大大降低效率。Maven 的聚合功能可以通过一个父板块将所有的要构建板块整合起来，将父板块的打包类型公告为 POM，通过 <modules> 将各板块集中到父 POM 中。如清单 7，其中 <module></module> 中间的内容为子板块工程名的相对路径。

清单 7. 聚合

<modules>    <module>../com.dugeng.project1</module> <module>../com.dugeng.project2</module> </modules>

父类型的板块，不需要有源代码和资源文件，也就是说，没有 src/main/java 和 src/test/java 目录。Maven 会首先解析聚合板块的 POM 文件，分析要构建的板块，并通过各板块的依赖关系计算出板块的执行顺序，根据这个潜在的关系依次构建板块。将各子板块聚合到父板块中后，我们即可以对父板块进行一次构建命令来完成一律板块的构建。

• 继承

在面向对象的编程中我们学会了继承的概念，继承是可重用行即消除重复编码的行为。Maven 中继承的意图和面向对象编程中是一致的。与聚合的实现相似，我们通过构建父板块将子板块共用的依赖，插件等进行统一公告，在聚合和继承同时使用时，我们可以用同一个父板块来完成这两个功能。

例如将 com.dugeng.parent 这个板块公告为 project1 和 project2 的父板块，那么我们在 project1 和 2 中用如下代码公告父子关系，如清单 8：

清单 8. 继承

<parent>  <groupId>com.dugeng.mavenproject</groupId>  <artifactId>com.dugeng.parent</artifactId>  <version>0.0.1-SNAPSHOT</version>  <relativePath>../com.dugeng.parent/pom.xml</relativePath> </parent>

因为父板块只是用来公告少量可共用的配置和插件信息，所以它也像聚合板块一样只要要包括一个 POM 文件，其它的项目文件如 src/main/java 是不需要的。

聚合和继承存在少量共性和潜在的联络，在实际的应用中，经常将聚合板块的父板块和继承的父板块定义为同一个。

并不是所有的 POM 元素都可以被继承，表 3 是一个可继承的元素列表。

表 3. 可继承元素列表

7 Maven 属性

在 POM 文件中常常需要引用已定义的属性以降低代码的冗余，提高代码的可重用性，这样不仅能降低代码更新的工作量也能提高代码的正确率。有些属性是客户自己设置的，有些属性是可以直接引用的已定义变量。

Maven 的可用属性类型可分为 5 种，它们分别是：

1. 内置属性。这种属性跟 Maven Project 自身有关，比方要引入当前 Project 的版本信 息，那么只要要在使用的位置引用 ${version} 就行了。
2. Setting 属性。上文中已经提到 Maven 自身有一个 settings.xml 配置文件，它里面含有包括仓库，代理商服务器等少量配置信息，利用 ${settings.somename} 即可以得到文件里相应元素的值。
3. POM 属性。这种属性对应 POM 文件中对应元素的值，例如 {project.artifactId} 对应了 <artifactId> </ artifactId > 中的值。
4. 系统环境变量。可以使用 env.{env.JAVA_HOME} 得到的就是 JAVA_HOME 的环境变量值。
5. 客户自己设置变量。这种类型的变量是使用最频繁和广泛的变量，完全由客户自己定义。在 POM 文件中加入 <properties> 元素并将自己设置属性作为其子元素。格式如清单 9。

清单 9. 自己设置属性

<properties>  <path>../../sourcecode</path></properties>

8 Maven 3 的新特性

Maven 3 在性能和灵活性方面都比 Maven2 有了很大提升，它的新特性总结起来有以下几点：

1. 兼容低版本 Maven，也就是向后兼容，因而客户可以将 Maven2 的项目移植到 Maven3 上来。

2. 性能优化。CPU 利用率更高，内存消耗更小，经过优化的 Maven3 比 Maven2 构建速度快出 50% 以上，这对于构建大型项目的开发者来说无疑会节省大量的时间。

3. 在早先的版本中，开发者必需在子板块中指定父版本，当进行代码的迁移或者更新时，这会带来额外的维护工作，Maven3.1 将会消除在子板块上指定父版本的需要。

4.Maven3 改善了错误报告，它会在错误报告中提供指向 Maven Wiki 页面的链接，这样开发者可以方便的查看更全面的错误形容和可能的起因。

5. 添加了 Maven Shell，通常我们可以在系统自带的 console 里执行 Maven 命令，但是通过自安装的 Maven Shell 可以提高生成速度，它是一个是 Maven 的命令行接口工具，可以缓存解析过的 POM，避免了重复调用 Maven 的启动成本。Maven Shell 不属于 Maven 发行包的一部分，需要单独下载。

6. M2Eclipse 实现了 Maven 和 Eclipse 的集成，与一个使用更广泛的 IDE 进行集成从而为开发者带来的便利是不言而喻的。

9 结束语

Maven 有着许多实用的特点，它使用了标准的目录结构和部署。这就使得开发人员能够适应不同的项目，并且不用学习任何结构方面新的东西，也不用掌握特殊的指令来构建结构。当然，Maven 的使用还不够普及，相信随着时间的推移，它的功能会更完善，使用的人群也会越来越广泛。