Maven的六类属性

Maven 属性的使用,这里其实应该不陌生。比如 SpringPOM 工程中的 pom.xml 有如下代码。
<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <project.build.spring.version>4.2.7.RELEASE
    </project.build.spring.version>
</properties>

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-core</artifactId>
        <version>${project.build.spring.version}</version>
    </dependency>

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-aop</artifactId>
        <version>${project.build.spring.version}</version>
    </dependency>
    ...
</dependencies>
在上面的代码中,就在 properties 中定义了 project.build.spring.version 属性,描述了 Spring 的 4.2.7.RELEASE 版本信息,然后在依赖的 version 中使用${project.build.spring.version},从而统一 Spring 所有相关构件的版本。

这样不仅能降低错误的发生概率,而且还能减少升级版本的工作量(不用每个构件都去修改版本,只要修改属性描述的版本就行)。

前面只是 Maven 属性中的一种体现形式。在 Maven 中一共有六类属性。

1)内置属性

在 Maven 中主要有两个常用的内置属性,它们分别是${basedir}${version} 属性。${basedir}表示项目的根目录,也就是包含 pom.xml 文件的目录;${version} 表示项目的版本。

2)POM 属性

用户可以通过 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/testclasses。
  • ${project.groupId}:项目的 groupId。
  • ${project.artifactId}:项目的 artifactId。
  • ${project.version}:项目的版本。
  • ${project.build.finalName}:项目输出的文件名称,默认为“${project.artifactId}-${project.version}”。

这些属性都在 pom 中有对应的元素。它们中一些属性的默认值都在超级 pom 中有定义,详细情况可以参考超级 pom.xml。

Maven 的超级 pom 文件在“$MAVEN_HOME/lib/maven-model-builder-x.x.x.jar”中的“org/apache/maven/model”目录下,文件名为 pom-4.0.0.xml。

3)自定义属性

用户可以在 pom 的 properties 中定义自己的 Maven 属性,然后在后面重复使用,同在前面提到的 SpringPOM 的 pom.xml 中定义的 Spring 的版本信息一样。

4)Settings 属性

Settings 属性同 POM 属性是一样的,可以用以“settings.”开头的属性引用 settings.xml 文件中 XML 元素的值。如使用“${settings.localRepository}”指向用户本地仓库的地址。

5)Java 系统属性

所有的 Java 系统属性都可以通过 Maven 属性引用,比如“${user.home}”指向的就是用户目录。用户可以通过使用“mvn help:system”命令查看所有的 Java 系统属性,例如:

PROGRAMW6432=C:\Program Files
COMMONPROGRAMW6432=C:\Program Files\Common Files
WINDOWS_TRACING_LOGFILE=C:\BVTBin\Tests\installpackage\csilogfile.log
PROCESSOR_ARCHITECTURE=AMD64
VISUALSVN_SERVER=C:\Program Files (x86)\VisualSVN Server\
CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher
PROGRAMDATA=C:\ProgramData
...

6)环境变量属性

所有的环境变量都可以用以“evn.”开头的 Maven 属性引用。比如,“${evn.JAVA_HOME}”就指向引用了 JAVA_HOME 环境变量的值。同查看 Java 系统属性一样,用户可以使用命令“mvn help:system”查看到所有的环境变量。

在 Maven 项目中,适当地使用这些 Maven 属性可以简化 pom 的配置和维护工作,而且能将公共的信息很好地统一起来,避免不必要的错误。