灵活的构建

最新推荐文章于 2021-10-18 11:18:20 发布

依然爱笑的薰衣草

最新推荐文章于 2021-10-18 11:18:20 发布

阅读量111

点赞数

分类专栏： Maven

本文链接：https://blog.csdn.net/qq_22314145/article/details/81199733

版权

Maven 专栏收录该内容

9 篇文章 0 订阅

订阅专栏

灵活的构建

基础概念

灵活的构建能够解决项目构建过程中一个常常需要面对的问题，就是不同的平台环境差异，这可能是操作系统的差异、平台开发和测试平台的差异、不同客户之间的差异。为了应对这些差异，Maven提供了属性、资源过滤以及profile三大特性。

Maven属性

内置属性：主要有两个常用内置属性，${basedir}表示项目根目录，即包含pom.xml文件的目录，${version}表示项目版本。

POM属性：用户可以使用该类属性引用POM文件中对应元素的值。例如${project.artifactId}就对应了元素的值，常用的POM属性包括：

${project.build.sourceDirectory}：项目的主源码目录，默认为src/main/java/
${project.build.testSourceDirectory}：项目的测试源码目录，默认为src/main/test/java/
${project.build.directory}：项目构建输出目录，默认为target/
${project.outputDirectory}：项目主代码编译目录，默认为src/test/java/
${project.testOutputDirectory}：项目测试代码编译输出目录，默认为target/classes/

这些属性都对应了一个POM元素，它们中一些属性的默认值都是在超级POM中定义的，更多POM元素也可以在超级POM中查看。

自定义属性，用户可以在POM的元素下自定义Maven属性。例如：

<properties>
  <my.prop>hello</my.prop>
</properties>

然后在POM中其它地方使用${my.prop}的时候会被替换成hello。

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

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

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

资源过滤

开启资源过滤只需要超级POM中，只需要在默认资源文件配置中，加入一行filtering配置即可，如代码清单：

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

我们将数据库配置的变化部分提取成了Maven属性，在POM的profile中定义了这些属性的值，再通过命令行激活profile，Maven就能够在构建项目的时候使用profile中属性值替换数据库配置文件中的属性引用，运行命令如下：

$mvn clean install-Pdev

mvn的-P参数表示在命令行激活一个profile，当然可以同时激活几个，以‘,’隔开。

激活profile的方法

命令行激活：用户可以使用mvn命令行参数-P加上profile的id来激活profile。

$ mvn clean install -Pdev,dev-y

settings文件显式激活：如果用户希望某个profile默认一直处于激活状态，就可以配置settings.xml文件的activeProfiles元素，表示其配置的profile对于所有项目都处于激活状态

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

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

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

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

<profile>
  <activation>
    <oa>
      <name>Windows XP</name>
      <family>Windows</family>
      <arch>x86</arch>
      <version>5.1.2600</version>
    </oa>
  </activation>
</profile>

这里family的值包括Windows、UNIX和MAac等，而其它几项name、arch、version，用户可以通过查看环境中的系统属性os.name、os.arch、os.version获得。

文件存在与否激活

Maven能够根据项目中某个文件存在与否来决定是否激活profile

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

默认激活：用户可以在定义profile的时候指定其默认激活，不过如果POM中有任何一个profile通过以上其他任意一种方式被激活了，所有的默认激活配置都会失效。

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

补充：maven-help-plugin提供了一个目标帮助用户了解当前激活的profile，$ mvn help:active-profiles；它还有另一个目标用来列出当前所有的profile，$ mvn help:all-profiles

profile的种类

pom.xml：很显然，pom.xml声明的profile只对当前项目有效
用户settings.xml：用户目录下.m2/settings.xml中的profile对本机上该用户所有的Maven项目有效
全局settings.xml：Maven安装目录下conf/settings.xml对本机上所有的Maven项目有效
profiles.xml：和pom.xml声明在同一目录下，基本不用不做介绍

为了保证该profile伴随某个特定的pom.xml文件一起存在，profile大部分都是声明在pom.xml文件中的，它可以修改或者增加很多POM元素的。Maven不允许用户在settings.xml的profile中声明依赖或者插件，事实上，在pom.xml外部的profile只能够声明如下的几个元素：

<project>
  <repositories></repositories>
  <pluginRepositories></pluginRepositories>
  <properties></properties>
</project>

现在不用担心POM外部的profile会对项目产生太大的影响了，事实上这样的profile仅仅能用来影响到项目的仓库和Maven属性。

profile的使用

Web资源过滤：Web项目中除了上述我们提到的src/main/resource/文件下的资源文件，还有另外一类资源文件，默认他们的源码位于src/main/webapp/目录，经打包后位于项目的WAR包的根目录。如css、js文件中的资源，如果需要针对不同用户使用不同的css，只需要配置不同的profile，在maven-war-plugin对src/main/webapp这一Web资源目录开启过滤，按用户需要的css文件选择对应的profile进行激活即可。

在Profile激活集成测试：可以配置Maven默认只会执行单元测试，如果想要执行集成测试，就需要激活对应的profile文件才行。由此可见，profile不仅可以用来应对不同的构建环境以保持构建的可移植性，还可以用来分离构建的一些较耗时或者耗资源的行为，并给予更合适的构建频率。