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

部分来源：

properties

假如一种场景：比如说spring的jar包版本，由于jar包较多，如果要修改，需要挨个修改，工作量巨大，因此可以使用 <properties>标签，赋值之后，可以统一使用，统一修改。

<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

dependencies即使在子项目中不写该依赖项，那么子项目仍然会从父项目中继承该依赖项（全部继承）

dependencyManagement里只是声明依赖，并不实现引入，因此子项目需要显示的声明需要用的依赖。如果不在子项目中声明依赖，是不会从父项目中继承下来的；只有在子项目中写了该依赖项，并且没有指定具体版本，才会从父项目中继承该项，并且version和scope都读取自父pom;另外如果子项目中指定了版本号，那么会使用子项目中指定的jar版本。

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的问题。