Maven快速入门（四）Maven中的pom.xml文件详解

上一章，我们讲了Maven的坐标和仓库的概念，介绍了Maven是怎么通过坐标找到依赖的jar包的。同时也介绍了Maven的中央仓库、本地仓库、私服等概念及其作用。这些东西都是Maven最基本、最核心的概念，大家一定要搞明白。所谓工欲善其事必先利其器，这些基础的东西一定要掌握。其实，Maven项目中还有一个最核心的文件：pom.xml 文件。pom.xml 文件是Maven项目中的核心项目管理文件，用于项目描述、依赖管理、构建信息管理、组织信息管理等。pom.xml 文件中包含了许多标签。接下来介绍一些Maven常用的标签。

 

一、pom.xml 常用元素

1、坐标信息

pom.xml中最重要的就是项目的坐标信息，主要包含之前介绍的：<groupId>、<artifactId>、<version>、<packaging>等标签。

（1）<groupId>：定义当前 Maven 项目所属的实际项目，跟 Java 包名类似，通常与域名反向一一对应。
（2）<artifactId>：定义当前 Maven 项目的一个模块名，默认情况下，Maven 生成的构件，其文件名会以 artifactId 开头，如 hibernate-core-3.6.5.Final.jar。
（3）<version>：定义项目版本，通常是0.0.1.snapshot，分为snapshot（快照），alpha（内部测试），beta（公测），Release （稳定版），GA （正式版）等。
（4）<packaging>：定义项目打包方式，如 jar，war，pom，zip ……，默认为 jar。

项目中pom.xml 文件中定义：

 

2、依赖列表

依赖列表包含<dependancies>和<dependancy> 标签

<dependancy> 是pom.xml 文件中非常重要的标签。声明项目依赖哪些 jar 包以及 所依赖jar 的坐标等信息。

<dependency>
　　<groupId></groupId>
　　<artifactId></artifactId>
　　<version></version>
　　<scope></scope>
　　<optional></optional>
　　<exclusions></exclusions>
</dependency>

如上面中示例中：

（1）<groupId>和<artifactId>  为jar包的坐标信息，确定依赖的jar包的位置。

（2）<version>  为jar 包对应的版本。

（3）<scope>  指依赖的范围，主要包含：            

　　　　compile（编译范围）：默认的scope，运行期有效，需要打入包中
　　　　provided：编译期有效，运行期不需要提供，不会打入包中
　　　　runtime：编译不需要，在运行期有效，需要导入包中。（接口与实现分离）
　　　　test：测试需要，不会打入包中
　　　　system：非本地仓库引入、存在系统的某个路径下的jar。（一般不使用）

 

　　<scope> 非常重要，也非常难懂接下来我会专门讲maven的依赖范围。

（4）<optional>  设置依赖是否可选，有true和false，默认是false。

（5）<exclusions> 排除依赖传递列表。

 

3、依赖管理

依赖管理 <dependencyManagement> 主要作用是管理子项目的公共的依赖。

假如某个的模块很多，一些公共的jar包，每个模块都需要引用一遍很麻烦。为了项目的正确运行，必须让所有的子项目使用依赖项的统一版本，必须确保应用的各个项目的依赖项和版本一致，才能保证测试的和发布的是相同的结果。所以如果抽象出一个父工程来管理子项目的公共的依赖。

在我们项目顶层的POM文件中，我们会看到dependencyManagement元素。通过它元素来管理jar包的版本，让子项目中引用一个依赖而不用显示的列出版本号。Maven会沿着父子层次向上走，直到找到一个拥有dependencyManagement元素的项目，然后它就会使用在这个dependencyManagement元素中指定的版本号。

这样， 就能统一管理项目的版本号，确保应用的各个项目的依赖和版本一致，保证测试的和发布的是相同的程序。

 

4、<parent> 和 <modules>

（1）<parent> 通常用于子模块中，对父模块中pom的继承。类似上面提到的，一般我们会将一些公共的jar包定义在父工程，然后子模块则通过<parent>标签基础相关的pom依赖。

假如一个项目有三个模块，它们都需要用到同一个jar包：common.jar。我们分别在三个项目的pom.xml 文件中定义各自对common.jar的依赖，那么当common.jar的版本发生变化时，三个项目的pom文件都要改，项目模块越多要改的地方就越多。这时候就需要用到<parent> 标签, 我们创建一个parent项目，打包类型为pom，parent项目中不存放任何代码，只是管理多个项目之间公共的依赖。在parent项目的pom文件中定义对common.jar的依赖，ABC三个子项目中只需要定义<parent></parent>，parent标签中写上parent项目的pom坐标就可以引用到common.jar了。

 

（2）<modules> 用来聚合多个maven 模块，假如我们项目中有多个模块，那么通过<modules> 标签将这些子模块聚合，统一编译。

假如我们的项目分成了好几个模块，那么我们构建的时候是不是有几个模块就需要构建几次了（到每个模块的目录下执行mvn命令）？当然，你逐个构建没问题，但是非要这么麻烦的一个一个的构建吗，那么简单的做法就是使用聚合，一次构建全部模块。

<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/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>com.youzhibing.account</groupId>
  <artifactId>account-aggregator</artifactId>
  <version>1.0.0-SNAPSHOT</version>
  <packaging>pom</packaging>

  <name>Account Aggrregator</name>
  <url>http://maven.apache.org</url>
  
  <modules>
　　　 <!-- 模块都写在此处 -->
      <module>account-register</module>      <module>account-login</module>
  </modules>

</project>

 

最后

以上，就把Maven项目中的pom文件的常用标签介绍完。磨刀不误砍柴工，pom.xml 文件虽然简单，但是还是必须牢牢掌握。接下来会讲Maven 中最重要，也是最麻烦的依赖关系。