maven学习笔记（八）属性、Profile、资源过滤

1属性

通过maven属性，可在pom中方便地引用项目环境和构建环境各种有用的值。

为主资源

（1）内置属性

主要有两个常用的内置属性：

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

${version}表示项目版本

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

常用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}：项目的version，与${version}等价

${project.build.finalName}：项目打包输出文件的名称，默认为${project.artifactId}-${project.version}

这些属性都对应了一个pom元素，它们中的一些属性的默认值都是在超级pom中定义的。

（3）自定义属性

用户在pom的<properties>元素下自定义maven属性。

（4）Settings属性

与pom属性同理，用户使用以setting.开头的属性引用setting.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查看所有的环境变量。

（7）注意：maven属性默认只有在pom中才会解析。

需要为要解析maven属性的目录开启资源过滤。

例如：a在主资源目录的property.xml文件中使用maven属性

database.jdbc.driverClass=${db.driver}

database.jdbc.connectionURL=${db.url}

database.jdbc.username=${db.username}

database.jdbc.password=${db.password}

b定义maven属性

  <profiles>
  	<profile>
  		<id>dev</id>
  		<properties>
  			<db.driver>com.mysql.jdbc.Driver</db.driver>
  		</properties>
  	</profile>
  </profiles>

c为主资源目录开启资源过滤以解析maven属性

<resources>

 <resource>

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

  <filtering>true</filtering>

 </resource>

</resources>

d为测试资源目录据开启资源过滤

<testResources>

 <testResource>

  <directory>${project.basedir}/src/test/resources</directory>

  <filtering>true</filtering>

 </testResource>

</testResources>

e命令行激活profile，使maven能够在构建项目的时候使用profile中属性值替换数据库配置文件中的属性引用。

运行命令如下：

$mvn clean install-Pdev

-P参数表示在命令行激活一个profile，这里激活了id为dev的profile。

2maven profile

不同环境的构建可能不同，典型的情况如数据库的配置，profile作用使构建不做修改就能在任何环境下运行。

（1）使用见上个示例

（2）激活方式

a命令行激活：$mvn clean install -Pdev-x,dev-y

bsettings文件显示激活

配置setting.xml文件的activeProfiles元素，表示其配置的profile对于所有项目都处于激活状态。

  <settings>
      ...
      <activeProfiles>
          <activeProfile>dev-x</activeProfile>
      </activeProfiles>
      ...
  </settings>

c系统属性激活

配置当某系统属性存在的时候，自动激活profile

  <profiles>
      <profile>
          <activation>
              <property>
                  <name>test</name>
              </property>
          </activation>
          ...
      </profile>
  </profiles>

配置当某系统属性test存在，且值等于x的时候激活profile

  <profiles>
      <profile>
          <activation>
              <property>
                  <name>test</name>
                  <value>x</value>
              </property>
          </activation>
          ...
      </profile>
  </profiles>

不要忘了，用户可以在命令行声明系统属性，例如：

$mvn clean install -Dtest=x

因此，这其实也是一种从命令行激活profile的方法，而且多个profile完全可以使用同一个系统属性来激活。

d操作系统环境来激活

  <profiles>
      <profile>
          <activation>
              <os>
                  <name>Windows XP</name>
                  <family>Windows</family>
                  <arch>x86</arch>
                  <version>5.1.2600</version>
              </os>
          </activation>
          ...
      </profile>
  </profiles>

e文件存在与否激活

  <profiles>
      <profile>
          <activation>
              <file>
                  <missing>x.properties</missing>
                  <exists>y.properties</exists>
              </file>
          </activation>
          ...
      </profile>
  </profiles>

f默认激活

用户可以在定义profile的时候指定其默认激活。

  <profiles>
      <profile>
          <id>dev</id>
          <activation>
              <activeByDefault>true</activeByDefault>
          </activation>
          ...
      </profile>
  </profiles>

（3）列出当前激活的profile

$mvn help:active-profiles

列出当前所有的profile

$mvn help:all-profiles

（4）profile的种类：pom.xml，用户settings.xml，全局setting.xml，profiles.xml(maven2)

a pom中profile可使用的元素：修改或添加仓库、插件仓库以及部署仓库地址；修改或添加项目依赖；修改聚合项目的聚合配置；添加或修改maven属性；添加或修改项目报告配置；pom profile还可以添加或修改插件配置、项目资源目录和测试资源目录以及项目构建的默认名称。

b pom外部的profile可使用的元素

repositories

pluginRepositories

properties

（5）web资源过滤