Maven笔记之Profile

Maven属性

（1）内置属性：主要有两个常用内置属性

• ${basedir}：表示项目根目录，即包含pom.xml文件的目录
• ${version}：表示项目版本

（2）POM属性：用户可以使用该类属性引用POM文件中对应元素的值。常用的POM属性：

• ${project.build.sourceDirectory}：项目的主源码目录，默认为src/main/java/
• ${project.build.testSourceDirectory}：项目的测试源码目录，默认为src/test/java/
• ${project.build.directory}：项目构建输出目录，默认为target/
• ${project.outputDirectory}：项目主代码编译输出目录，默认为target/classes/
• ${project.testOutputDirectory}：项目测试代码编译输出目录，默认为target/test/classes/
• ${project.groupId}：项目的groupId
• ${project.artifactId}：项目的artifactId
• ${project.version}：项目版本
• ${project.build.finalName}：项目打包输出文件名称，默认为${project.artifactId}-${project.version}

（3）自定义属性：用户可以在POM的<properties>元素下自定义Maven属性

<project>
<!-- 省略多余代码 -->
    <properties>
        <spring.version>1.4.3</spring.version>
    </properties>
<!-- 省略多余代码 -->
</project>

然后在POM中其它地方使用${spring.version}的时候会被替换成1.4.3

（4）Settings属性：与POM原理相同，用户使用以setting. 开头的属性引用settings.xml文件中XML元素的值。常用配置：

• ${settings.localRepository}：指向用户本地仓库地址

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

（6）环境变量属性：所有环境变量都可以使用以env. 开头的Maven属性引用。例如${env.JAVA_HOME}指代了JAVA_HOME环境变量的值。用户可以使用mvn help:system查看所有的环境变量

资源过滤

把不同环境需要变化的部分提取出来，如下面数据库配置文件：

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

这里的命名都是任意的。既然这里使用了Maven属性，就应该在某个地方定义它们。这里使用的是一个额外的profile将其包裹，如下：

<profiles>
    <profile>
        <id>dev</id>
        <properties>
            <db.driver>com.mysql.jdbc.Driver</db.driver>
            <db.url>jdbc:mysql://127.0.0.1:3306/mysql</db.url>
            <db.username>dev</db.username>
            <db.password>dwvpass</db.password>
        </properties>
    </profile>
</profiles>

上面的Maven属性定义与直接在POM的properties元素下定义并没有什么区别，这里只是使用了一个id为dev的profile，其目的是将开发环境下的配置与其他环境的配置区别开。

现在配置文件还不能使用里面的变量，因为Maven属性默认只有在POM中才会被解析。也就是说，${db.username}放到POM中会变成dev，但是如果放到src/main/resources/目录下的文件中，构建的时候它仍然还是${da.username}。因此，需要让Maven解析资源文件中的Maven属性

资源文件的处理其实是maven-resources-plugin做的事情，它默认的行为只是将项目主资源文件复制到主代码编译输出目录中，将测试资源文件复制到测试代码编译输出目录中。不过只要通过一些简单的POM配置，该插件就能解析资源文件中的Maven属性，即开启资源过滤。

Maven默认的主资源目录和测试资源目录就定义在超级POM中。要为资源目录开启过滤，只要在此基础上添加一行filtering配置即可。

<resources>
    <resource>
        <directory>${project.basedir}/src/main/resources</directory>
        <filtering>true</filtering>
    </resource>
</resources>

Maven允许配置多个资源目录，并且为每个资源目录提供不同的过滤配置。

一切配置完毕，我们只需要在构建的时候运行如下指令：

$mvn clean install -P dev

-P参数表示激活一个profile，这里的dev为配置profile的id

 

Maven Profile

为了能够让构建在各个环境下方便地移植，Maven引入了Profile概念。用户可以使用很多种方式期货profile，以实现构建在不同环境下的移植。

激活profile

（1）命令行激活：用户可以使用 mvn命令行参数-P加上profile的id来激活profile，多个id之间用逗号分隔，例如我们要同时激活dev1和dev2

$mvn clean install -P dev1,dev2

（2）setting文件显式激活：如果用户想让某个profile默认一直处于激活状态，就可以配置setting.xml文件中的active-Profiles元素，表示其配置的profile对于所有项目都处于激活状态，如下：

<settings>
<!--省略多余代码-->
    <activeProfiles>
        <activeProfile>dev</activeProfile>
    </activeProfiles>
<!--省略多余代码-->
</settings>

（3）系统属性激活：用户可以配置当某系统属性存在的时候，自动激活profile。

<profiles>
    <profile>
        <activation>
            <property>
               <name>test</name> 
            </property>
        </activation>
        <!-- 属性配置省略 -->
    </profile>
</profiles>

（4）操作系统环境激活：Profile还可以自动根据操作系统环境激活，如果构建在不同的操作系统有差异，用户完全可以将这些差异写进profile，然后配置他们自动基于操作系统环境激活。

<profiles>
    <profile>
        <os>
            <name>Windows XP</name>
            <family>Windows</family>
            <arch>x86</arch>
            <version>5.2.120000</version>
        </os>
        <!-- 属性配置省略 -->
    </profile>
</profiles>

（5）文件存在与否激活：根据项目中某个文件存在与否来决定是否激活profile。

<profiles>
    <profile>
        <activation>
            <file>
                <missing>a.properties</missing>
                <exists>b.properties</exists>
            </file>
        </activation>
        <!-- 省略属性配置 -->
    </profile>
</profiles>

（6）默认激活：可以在定义profile的时候指定其默认激活

<profiles>
    <profile>
        <id>dev</id>
        <activation>
            <activeByDefault>true</activeByDefault>
        </activation>
        <!-- 省略属性配置 -->
    </profile>
</profiles>

使用activeByDefault元素用户可以指定profile自动激活。不过需要注意，如果POM中有任何一个profile通过以上其它任意一种方式被激活了，所有的默认激活都会失效。

查看当前被激活的profile：mvn help:active-profiles

列出所有profile：mvn help:all-profiles

 

WEB资源过滤

在web项目中，资源文件同样位于src/mian/resources/目录下，他们经处理后会位于WAR包的WEB-INF/classes目录下，这也是java代码编译打包后的目录。也就是说，这类资源打包后会位于应用程序的classpath中。

web项目中还有另外一类资源，默认他们的源码位于src/main/webapp/目录，经打包后位于WAR包的根目录。例如，一个web项目的css源码文件在/src/main/webapp/css/目录，项目打包后可以在WAR包的css/目录下找到对应的css文件。这一类资源文件称作web资源文件，它们在打包后不位于应用程序的classpath中。

与一般资源文件一样，web资源默认不会被过滤。开启一般资源文件的过滤也不会影响到web文件。

有时候，我们可能希望在构建项目的时候，为不同的客户使用不一样的资源文件（例如客户的logo图片不同，或者css主题不同）。这是可以在web资源文件中使用Maven属性，例如${client.logo}表示用户的logo。然后使用profile分别定义这些Maven属性的值，如下：

<profiles>
    <profile>
        <id>client-a</id>
        <properties>
            <client.logo>a.jpg</client.logo>
            <client.css>a.css</clicent.css>
        </properties>
    </profile>
    <profile>
        <id>client-b</id>
        <properties>
            <client.logo>b.jpg</client.logo>
            <client.css>b.css</clicent.css>
        </properties>
    </profile>
</profiles>

最后配置maven-war-plugin对src/main/wabapp/这一web资源目录开启过滤，如下：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-war-plugin</artifactId>
    <version>2.1-beta-1</version>
    <configuration>
        <webResources>
            <resource>
                <filtering>true</filtering>
                <directory>src/main/webapp</directory>
                <includes>
                    <include>**/*.jpg</include>
                    <include>**/*.css</include>
                </includes>
            </resource>
        </webResources>
    </configuration>
</plugin>