maven常用配置信息和常量

Posted 2020-11-03 代码的搬运工

 

1.   通过 <properties> 元素用户可以自定义一个或多个属性，然后在 POM 的其他地方使用 ${ 属性名称 } 的方式引用属性，这种做法的最大意义在于消除重复。

 

2.   Maven 共有六类属性：

  1） 内置属性： ${basedir} 表示项目根目录，即 pom.xml 文件的目录。 ${version} 表示项目版本。

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

    a)  ${project.build.sourceDirectory} ：项目的主源码目录，默认为 src/main/java

    b)  ${project.build.testSourceDirectory} ：项目的测试源码目录，默认为 src/test/java

    c)  ${project.build.directory} ：项目构建输出目录，默认为 target/

    d)  ${project.outputDirectory} ：项目主代码编译输出目录，默认为 target/classes

    e)  ${project.testOutputDirector} ：项目测试代码编译输出目录，默认为 target/test-classes/

    f)   ${project.groupId} ：项目的 groupId

    g)  ${project.artifactId} ：项目的 artifactId

    h)  ${project.version} ：项目的 version ，与 ${version} 等价

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

它们的默认值是在超级 POM 中定义的。

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

  4） Settings 属性：与 POM 属性同理，用户以 settings. 开头的属性引用 settings.xml 文件中 XML 元素的值。如${settings.localRepository} 指向本地仓库的位置

  5） Java 系统属性：所有 Java 系统属性都可以使用 Maven 属性引用。如 ${user.home} 指向用户目录。可以用 mvn help:system 查看所有 Java 系统属性 ( 包含 -D 参数设置的属性 ) 。

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

 

3.   POM 的 <build> 元素下可以使 用 <resources> 和 <testResources> 定义多个资源目录和测试资源目录。 在<resource> 和 <testResource> 下定义 <filtering> 元素来告 诉 Maven 是否要解析资源文件中的 Maven 属性，如：

<resources>

<resource>

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

<filtering>true</filtering>

</resource>

</resources>

4.   mvn 的 -P 参数表示在命令行激活一个 profile 。如：

    mvn clean install –Pdev

    表示激活 ID 为 dev 的 profile 。我们可以在 id 为 dev 的 profile 中定义 dev 环境下的数据库连接等配置的 Maven 属性，从而用上述命令构建一个 dev 环境下的构件。

 

5.   Maven profile 能够在构建的时候修改 POM 的一个子集，或者添加额外的配置元素。用户可以使用很多方式激活 profile，以实现构建在不同环境下的移植。

 

6.   Maven 激活 profile 的方式有 :

  1)   命令行激活：通过 mvn 命令行的 –P 参数可以激活一个或多个 profile ，多个 id 之间用逗号分隔。如： mvn clean install –Pdev-x,dev-y

  2)   settings 文件显示激活： settings.xml 文件的 activeProfiles 元素可以配置一个或多个 profile 对于所有项目都是处于激活状态，如：

<settings>

…

<activeProfiles>

<activeProfile>dev-x</activeProfile>

<activeProfile>dev-y</activeProfile>

</activeProfiles>

…

</settings>

3)   系统属性激活：用户可以配置当某系统属性存在的时候激活 profile （不配置 <value> 属性），进而可以设置当某系统属性存在并等某值的时候激活。如 :

<profiles>

<profile>

<activation>

<property>

<name>test</name>

<value>x</value>

</property>

</activation>

</profile>

</profiles>

4) 操 作系统环境激活：

<profiles>

<profile>

<activation>

<os>

<name>Windows XP</name>

<family>Windows</family>

<arch>x86</arch>

<version>5.1.2600</version>

</os>

</activation>

</profile>

</profiles>

    这里 family 的值包括 Windows 、 UNIX 和 Mac 等。 name 、 arch 、 version 可以通过查看环境中的系统属性 os.name、 os.arch 和 os.version 获得。

  5） 文件存在与否激活：

<profiles>

<profile>

<activation>

<file>

<missing>x.properties</missing>

<exists>y.properties</exists>

</file>

</activation>

</profile>

</profiles>

6） 默认激活：

<profiles>

<profile>

<activation>

<activeByDefault>true</activeByDefault>

</activation>

</profile>

</profiles>

    但如果 POM 中有任何一个 profile 通过以上其他任意一种方式被激活了，所有的默认激活配置都会失效。

    激活的多个 profile 中的冲突属性如何解决？

7.   可以用 mvn help:active-profiles 查看当前项目所有被激活的 profile 。可以用 mvn help:all-profiles 查看当前项目目的所有的 profile 。

8.   profile 可以在如下位置声明：

  1）p om.xml ：只对当前项目有效

  2） ~/.m2/settings.xml ：对该用户所有 Maven 项目有效

  3） M2_HOME/conf/settings.xml ：对本机上所有 Maven 项目有效

  4） profiles.xml ：可以在项目根目录下使用一个额外的 profiles.xml 文件，只对项目有效。该文件默认不会被安装和部署。 Maven 3 已经不支持这种形式。

    在 POM 中定义的 profile 可以修改以下项目属性：

<profile>

<repositories/>

<pluginRepositories/>

<distributionManagement/>

<dependencies/>

<dependencyManagement/>

<modules/>

<properties/>

<reporting/>

<build>

<plugins/>

<defaultGoal/>

<resources/>

<testResources/>

<finalName/>

</build>

</profile>

    但在其他地方定义的 profile 由于无法保证它们能随着特定的 pom.xml 一起被分发，因此只允许修改以下属性：

<profile>

<repositories/>

<pluginRepositories/>

<properties/>

</profile>

9.   Web 资源文件默认位于 src/main/webapp/ 目录，打包后位于 WAR 包的根目录。开启一般资源文件的过滤（替换 Maven 属性）也不会影响到 web 资源文件。可以在 POM 中配置 maven-war-plugin 配置 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>**/*.css</include>

<include>**/*.js</include>

</includes>

</resource>

</webResources>

</configuration>

</plugin>

10.   可以用标注将 Unit Test 和 Integration Test 进行分组，从而可以在 profile 中配置 maven-surefire-Plugin 定义执行不同的 Test ：

<configuration>

<groups>group-name</groups>

</configuration>