Maven 属性、资源过滤和profile

为了构建的灵活性，　Maven支持属性、资源过滤和Profile。

 

一、属性
1.属性的引用
属性的引用很简单，如：${属性名}

 

2.属性的分类
(1)内置属性：
常用的内置属性有:
${basedir} 表示项目根目录 
${version} 表示项目版本

(2)POM属性
用户可使用该类属性引用POM文件中的对应元素的值。如：${project.artifacctId}就对应了<project><artifactId>元素的值。

(3)自定义属性
用户可在<properties>元素下自定义Maven属性，如：

 

 

 

Xml代码  

1. <span style="font-size: medium;"><project>  
2.     ...  
3.     <properties>  
4.         <my.prop>hello</my.prop>  
5.     </properties>  
6.     ...  
7. </project></span>  

 

(4)Settings属性：
与POM属性类似，用户可使用settings开头的属性引用settings.xml中XML元素的值。如${settings.localRepository}

 

(5)Java系统属性：
所有Java系统属性都可使用Maven属性来引用，例如${user.home}指向用户目录。可使用mvn help:system 查看所有的Java系统属性。

(6)环境变量属性：
所有环境变量都可使用env开头的Maven属性引用。如：${env.JAVA_HOME}表示JAVA_HOME环境变量的值。用户可使用mvn help:system查看所有的环境变量 。

 

 

 

二、资源过滤
1.资源过滤
　　不同的环境中需要的构件可能会有区别，如开发环境、测试环境以及正式环境的数据库配置不同。Maven推荐针对不同的环境生成不同的构件。
为了对应环境的变化，首先要使用Maven属性将这些将会发生变化的部分提取出来。如数据库配置可写成：

database.jdbc.driver = ${db.driver}
database.jdbc.url=${db.url}
database.jdbc.username = ${db.username}
database.jdbc.passwrd = ${db.password}

 

　　这里用到了四个Maven自定义属性。我们可在profile元素中定义这些属性。详见下节。

　　默认情况下，Maven只会解析POM.XML中的属性引用。也就是说如果上面的数据库配置放在resources目录下，Maven默认不会解析。
　　资源文件的处理实际是maven-resources-plugin负责，它的默认行为只是将项目主资源文件复制到主代码编译输出目录中，将测试资源文件复制到测试代码编译输出目录。可通过配置，使该插件解析资源文件中的Maven属性，即开启资源过滤，如：

Xml代码  

1. <span style="font-size: medium;"><project>  
2.     ...  
3.     <build>  
4.         <resources>  
5.             <resource>  
6.                 <directory>src/main</directory>  
7.                 <filtering>true</filtering>  
8.             </resource>  
9.             <resource>  
10.                 <directory>src/main/sql</directory>  
11.                 <filtering>false</filtering>  
12.             </resource>  
13.         </resources>  
14.         <testResources>  
15.             <testResource>  
16.                 <directory>...</directory>  
17.                 <filtering>...</filtering>  
18.             </testResource>  
19.         </testResources>  
20.     </build>  
21.     ...  
22. </project></span>  

 

　　在运行时指定激活的Profile，即可使用指定的属性引用。如：mvn clean install -Pdev

 

2.web资源过滤
　　在web项目中有两类资源，一类是构建后放置到WEB-INF/classes目录下，另一类则放到war包的根目录，如css文件。第二类资源由maven-war-plugin插件控制。可以配置方式不同，如：

 

Xml代码  

1. <span style="font-size: medium;"><plugin>  
2.     <groupId>org.apache.maven.plugins</groupId>  
3.     <artifactId>maven-war-plugins</artifactId>  
4.     <version>2.1-beta-1</version>  
5.     <configuration>  
6.         <webResources>  
7.             <resource>  
8.                 <filtering>true</filtering>  
9.                 <directory>src/main/webapp</directory>  
10.                 <includes>  
11.                     <include>* */*.css</include>  
12.                     <include>* */*.js</include>  
13.                 </includes>  
14.             </resource>  
15.         </webResources>  
16.     </configuration>  
17. </plugin></span>  

 

 

 

三、Profile
　　不同的环境需要的配置可能不相同，为了让构建适合各种不同的环境，Maven引入了Profile概念。

1.定义profile
　　可在pom.xml、用户settings.xml、全局settings.xml，profiles.xml（Maven3不支持）中定义profile。如：

Html代码  

1. <span style="font-size: medium;"><project>  
2.     ...  
3.     <profiles>  
4.         <profile>  
5.             <id>dev</id>  
6.             <properties>  
7.                 <db.driver>...</db.driver>  
8.                 <db.url>...</db.url>  
9.                 <db.username>...</db.username>  
10.                 <db.password>...</db.password>  
11.             </properties>  
12.         </profile>  
13.         <profile>  
14.             <id>test</id>  
15.             <properties>  
16.                 <db.driver>...</db.driver>  
17.                 <db.url>...</db.url>  
18.                 <db.username>...</db.username>  
19.                 <db.password>...</db.password>  
20.             </properties>  
21.         </profile>  
22.     </profiles>  
23.     ...  
24. </project>  
25. </span>  

 

 

 

2.激活profile
(1)命令行激活
　　使用-P参数,可同时激活多个profile。如：mvn clean install -Pdev-x,dev-y

 

(2)settings文件显示激活
　　如果用户希望某个profile一直处于激活状态，可在settings.xml中使用activeProfiles元素，表示其配置的profile对于所有项目都处于激活状态，如：

Xml代码  

1. <span style="font-size: medium;"><settings>  
2.     ...  
3.         <activeProfiles>  
4.             <activeProfile>  
5.                 dev-x  
6.             </activeProfile>  
7.         </activeProfiles>  
8.     ...  
9. </settings></span>  

 

 

(3)系统属性激活
　　用户可以配置当某个系统属性存在时，自动激活profile，如：

Xml代码  

1. <span style="font-size: medium;">   <activation>  
2.         <property>  
3.             <name>test</name>  
4.         </property>  
5.     </activation>  
6.     <id>dev</id>  
7.     <properties>  
8.         <db.driver>...</db.driver>  
9.         <db.url>...</db.url>  
10.         <db.username>...</db.username>  
11.         <db.password>...</db.password>  
12.     </properties>  
13. </profile></span>  

 

 

　　也可以配置成当某个系统属性存在，并且为指定值时，自动激活profile。如：

Xml代码  

1. <span style="font-size: medium;"><profile>  
2.     <activation>  
3.         <property>  
4.             <name>test</name>  
5.             <value>x</value>  
6.         </property>  
7.     </activation>  
8.     <id>dev</id>  
9.     <properties>  
10.         <db.driver>...</db.driver>  
11.         <db.url>...</db.url>  
12.         <db.username>...</db.username>  
13.         <db.password>...</db.password>  
14.     </properties>  
15. </profile></span>  

 

 

　　系统属性可在命令行中指定，如：mvn clean install -Dtest=x

 

(4)操作系统环境激活
　　profile可根据操作系统环境自动激活。如：

Xml代码  

1. <span style="font-size: medium;"><profile>  
2.     <activation>  
3.         <os>  
4.             <name>Windows XP</name>  
5.             <family>Windows</family>  
6.             <arch>x86</arch>  
7.             <version>5.1.2600</version>  
8.         </os>  
9.     </activation>  
10.     <id>dev</id>  
11.     <properties>  
12.         <db.driver>...</db.driver>  
13.         <db.url>...</db.url>  
14.         <db.username>...</db.username>  
15.         <db.password>...</db.password>  
16.     </properties>  
17. </profile>  
18. </span>  

 

 

(5)根据文件存在与否激活
　　可根据项目中是否存在某个文件来激活profile，如：

Xml代码  

1. <span style="font-size: medium;"><activation>  
2.     <file>  
3.         <missing>x.properties</missing>  
4.         <exists>y.properties</exists>  
5.     </file>  
6. </activation></span>  

 

 

(6)默认激活
　　可在定义profile时指定为默认激活，如：

Xml代码  

1. <span style="font-size: medium;"><activation>  
2.     <activeByDefault>true</activeByDefault>  
3. </activation></span>  

 

　　注意：但有profile通过其他方式激活时，默认激活失效。