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资源过滤