Maven pom.xml 元素配置说明(一)

部分来源：

Maven中 dependencies 节点和 dependencyManagement 节点的区别

dependencies与dependencyManagement的区别

maven profile的使用

properties

假如一种场景：比如说spring的jar包版本，由于jar包较多，如果要修改，需要挨个修改，工作量巨大，因此可以使用

<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-tx</artifactId>
<version>4.3.5</version>
</dependency>

转变为

<properties>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<spring.version>4.3.5</spring.version>
</properties>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-tx</artifactId>
<version>${spring.version}</version>
</dependency>

dependencyManagement 与 dependencies

Itoo-base(pom.xml) 继承于 Itoo-base-parent(pom.xml)

示例如下：

Itoo-base-parent(pom.xml)

<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.eclipse.persistence</groupId>
<artifactId>org.eclipse.persistence.jpa</artifactId>
<version>${org.eclipse.persistence.jpa.version}</version>
<scope>provided</scope>
</dependency>

<dependency>
<groupId>javax</groupId>
<artifactId>javaee-api</artifactId>
<version>${javaee-api.version}</version>
</dependency>
</dependencies>
</dependencyManagement>

Itoo-base(pom.xml)

<!--继承父类-->
<parent>
<artifactId>itoo-base-parent</artifactId>
<groupId>com.tgb</groupId>

<version>0.0.1-SNAPSHOT</version>
<relativePath>../itoo-base-parent/pom.xml</relativePath>
</parent>
<modelVersion>4.0.0</modelVersion>
<artifactId>itoo-base</artifactId>
<packaging>ejb</packaging>

<!--依赖关系-->
<dependencies>
<dependency>
<groupId>javax</groupId>
<artifactId>javaee-api</artifactId>
</dependency>

<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
</dependency>

<dependency>
<groupId>org.eclipse.persistence</groupId>
<artifactId>org.eclipse.persistence.jpa</artifactId>
<scope>provided</scope>
</dependency>
</dependencies>

请注意：

子类中没有指明依赖项的版本信息，在顶层 pom 中的 dependencyManagement 中javaee-api表明其优选的版本是 ${javaee-api.version} ，版本信息会注入其中。

只有当 外层的dependencies 元素中没有指明版本信息时， dependencyManagement 中的 dependencies 元素才起作用。

这样做的好处：

统一管理项目的版本号，确保应用的各个项目的依赖和版本一致，才能保证测试的和发布的是相同的成果，因此，在顶层pom中定义共同的依赖关系。同时可以避免在每个使用的子项目中都声明一个版本号，这样想升级或者切换到另一个版本时，只需要在父类容器里更新，不需要任何一个子项目的修改；如果某个子项目需要另外一个版本号时，只需要在dependencies中声明一个版本号即可。子类就会使用子类声明的版本号，不继承于父类版本号。

顶层 pom 中的 dependencies 与 dependencyManagement 中的 dependencies 元素有一个重要的区别：

dependencyManagement 中的 dependencies 元素只表明依赖项版本的优先选择，并不影响项目的依赖项；而 dependencies 元素则影响项目的依赖项。

Profile

使用maven来实现多环境的构建可移植性，需要借助maven提供的profile功能，通过不同的环境激活不同的profile来达到构建的可移植性。

一、POM中profile的配置

首先是profile配置，在pom.xml中添加如下profile的配置：

<profiles>
<profile>
<id>dev</id>
<properties>
<profiles.active>dev</profiles.active>
</properties>
<activation>
<activeByDefault>true</activeByDefault>
</activation>
</profile>
<profile>
<id>test</id>
<properties>
<profiles.active>test</profiles.active>
</properties>
</profile>
</profiles>

这里定义了三个环境，dev（开发环境）、test（测试环境），其中开发环境是默认激活的（activeByDefault为true），这样如果在不指定profile时默认是开发环境。

同时每个profile还定义了两个属性，其中profiles.active表示被激活的profile的配置文件的目录。

二、工程目录

针对不同的环境，我们定义不同的配置文件，而这些配置文件都做为资源文件放到maven工程的文件目录下（已将src/main/resources改为config），即config目录下，且各个环境的配置分别放到相应的目录下，而所有环境都公用的配置，直接放到config目录下即可。目录结构如下所示：

src/main/resources
spring.xml
spring-mvc.xml
properties
dev
dev.properties
test
test.properties

如上所示，开发环境、测试环境的配置文件分别放到config目录下的dev、test三个子目录中，剩余公共的配置文件放于config目录下。

三、POM文件中build配置

在pom中的build节点下，配置资源文件的位置，如下所示：

<resources>
<resource>
<directory>config</directory>
<excludes>
<exclude>properties/dev/*</exclude>
<exclude>properties/test/*</exclude>
</excludes>
</resource>
<resource>
<directory>config/properties/${profiles.active}</directory>
</resource>
</resources>

首先第一个资源文件位置config需要排队提各个环境的配置文件，各个环境的配置我们在第三个节点中通过前面在profile中配置的profiles.active属性来指定。即config/properties/${profiles.active}。这样在激活指定的profile时，会加载指定目录下的配置文件，如当前激活的是dev profile，那么这个资源目录就是config/properties/dev。这样就达到了不同环境加载不同配置的目的。

四、项目编译生成

所有需要的配置就完成了，通过在运行maven命令时指定不同的profile即可构建不同环境需要的war包或发布到不同的环境了 。如：

mvn clean package -Ptest 即构建出生产环境需要的war包

war包解压后，文件结构如下：

WEB-INF
classes
spring.xml
spring-mvc.xml
test.properties

由于默认的profile是dev，所以如果我们不指定profile，那么加载就是开发环境dev下的配置文件了。即我们在本地开发测试时，不用关心profile的问题。