Maven 属性、资源过滤和profile

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

 

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

 

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

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

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

 

 

 

<span style="font-size: medium;"><project>
    ...
    <properties>
        <my.prop>hello</my.prop>
    </properties>
    ...
</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属性，即开启资源过滤，如：

<span style="font-size: medium;"><project>
    ...
    <build>
        <resources>
            <resource>
                <directory>src/main</directory>
                <filtering>true</filtering>
            </resource>
            <resource>
                <directory>src/main/sql</directory>
                <filtering>false</filtering>
            </resource>
        </resources>
        <testResources>
            <testResource>
                <directory>...</directory>
                <filtering>...</filtering>
            </testResource>
        </testResources>
    </build>
    ...
</project></span>

 

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

 

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

 

<span style="font-size: medium;"><plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugins</artifactId>
    <version>2.1-beta-1</version>
    <configuration>
        <webResources>
            <resource>
                <filtering>true</filtering>
                <directory>src/main/webapp</directory>
                <includes>
                    <include>* */*.css</include>
                    <include>* */*.js</include>
                </includes>
            </resource>
        </webResources>
    </configuration>
</plugin></span>

 

 

 

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

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

<span style="font-size: medium;"><project>
    ...
    <profiles>
        <profile>
            <id>dev</id>
            <properties>
                <db.driver>...</db.driver>
                <db.url>...</db.url>
                <db.username>...</db.username>
                <db.password>...</db.password>
            </properties>
        </profile>
        <profile>
            <id>test</id>
            <properties>
                <db.driver>...</db.driver>
                <db.url>...</db.url>
                <db.username>...</db.username>
                <db.password>...</db.password>
            </properties>
        </profile>
    </profiles>
    ...
</project>
</span>

 

 

 

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

 

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

<span style="font-size: medium;"><settings>
    ...
        <activeProfiles>
            <activeProfile>
                dev-x
            </activeProfile>
        </activeProfiles>
    ...
</settings></span>

 

 

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

<span style="font-size: medium;">   <activation>
        <property>
            <name>test</name>
        </property>
    </activation>
    <id>dev</id>
    <properties>
        <db.driver>...</db.driver>
        <db.url>...</db.url>
        <db.username>...</db.username>
        <db.password>...</db.password>
    </properties>
</profile></span>

 

 

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

<span style="font-size: medium;"><profile>
    <activation>
        <property>
            <name>test</name>
            <value>x</value>
        </property>
    </activation>
    <id>dev</id>
    <properties>
        <db.driver>...</db.driver>
        <db.url>...</db.url>
        <db.username>...</db.username>
        <db.password>...</db.password>
    </properties>
</profile></span>

 

 

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

 

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

<span style="font-size: medium;"><profile>
    <activation>
        <os>
            <name>Windows XP</name>
            <family>Windows</family>
            <arch>x86</arch>
            <version>5.1.2600</version>
        </os>
    </activation>
    <id>dev</id>
    <properties>
        <db.driver>...</db.driver>
        <db.url>...</db.url>
        <db.username>...</db.username>
        <db.password>...</db.password>
    </properties>
</profile>
</span>

 

 

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

<span style="font-size: medium;"><activation>
    <file>
        <missing>x.properties</missing>
        <exists>y.properties</exists>
    </file>
</activation></span>

 

 

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

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

 

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