首页 > 代码库 > maven auto-config 多环境自动打包

maven auto-config 多环境自动打包

maven有许多优秀的插件,最近在研究打包中替换多重环境的配置,同事介绍使用阿里的auto-config,使用了一下确实不错。

auto-config其实和ant时代的字符替换差不多太多,只是ant需要自己写脚本完成这些事情,但是auto-config通过配置就可以了。

auto-config的核心技术我个人认为是volicty的模板技术,包括里面的占位符oplacehold都是以${}volicty的语法定义的。

auto-config主要涉及的文件有以下部分:auto-config.xml,template.vm,antx.property.

auto-config.xml主要定义那些字符需要替换,他们的默认值是什么,那  些文件需要替换占位符,以及输出的文件。

template.vm 主要定义模板文件,其实就是我们需要的配置文件,只不过这里需要替换的符号都以占位符的形 式输出。

antx.property 定义了占位符中 的具体的值用于替换占位符的值。

如果使用auto-config:

1.安装maven

2.使用auto-config的插件,需要在pom.xml中plugin中插入,后续会详细介绍,这里有必要说一下大陆的长城防火墙,太厉害了,maven中央仓库下载一个jar包需要半个小时,这里可以再maven的setting文件的mirrors增加如下配置:、

<mirror>
  <id>nexus-osc</id>
  <mirrorOf>external:*</mirrorOf>
  <name>Nexus osc</name>
  <url>http://maven.oschina.net/content/groups/public/</url>
</mirror>
  </mirrors>

表示从oschina这个站下载所有的maven文件。

pom.xml增加auto-config的配置

<build>
<finalName>json</finalName>
<plugins>
<plugin>
<groupId>com.alibaba.citrus.tool</groupId>
<artifactId>autoconfig-maven-plugin</artifactId>
<version>1.2</version>
<configuration>
<userProperties>${user.dir}/${autoconfig.properties}</userProperties>
</configuration>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>autoconfig</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>

这里的配置也是网络上download下来的,我手动添加了一个配置

<configuration>
<userProperties>${user.dir}/${autoconfig.properties}</userProperties>
</configuration>
这个用来干嘛的呢?用于自定义antx.property的文件位置,为什么要自定义文件位置?原因是方便在多环境中指定参数来修改配置。

这里user.dir是当前工程的路径,autoconfig默认的文件位置是在user.home目录下的。


这里说了,在多环境需要修改配置,所以需要在pom.xml中配置多个环境的profile

<profiles>
<profile>
<id>dev</id>
<properties>
<autoconfig.properties>antx-dev.properties</autoconfig.properties>
</properties>
</profile>
<profile>
<id>deploy</id>
<properties>
<autoconfig.properties>antx-pro.properties</autoconfig.properties>
</properties>
</profile>
</profiles>

<profiles>
<profile>
<id>dev</id>
<properties>
<autoconfig.properties>antx-dev.properties</autoconfig.properties>
</properties>
</profile>
<profile>
<id>pro</id>
<properties>
<autoconfig.properties>antx-pro.properties</autoconfig.properties>
</properties>
</profile>
</profiles>

在实际的编译过程中只需要 mavn package -P dev或者 mavn package -P pro就可以打包生产或者开发下的包了

pom.xml定义好了之后,需要在WEB-INF目录下面增加一个META-INF的文件夹以及在该文件夹下新增autoconf文件夹

在autoconf文件夹下放置auto-config.xml以及所有的模板文件,注意模板文件必须放在这里,我目前没有找到放到其他位置的配置。


auto-config的具体配置:

<?xml version="1.0" encoding="UTF-8"?>
<config>
<group>
<property name="petstore.work" description="应用程序的工作目录" />
<property name="petstore.loggingRoot" defaultValue=http://www.mamicode.com/"${petstore.work}/logs"
description="日志文件目录" required="true"/>
<property name="petstore.upload" defaultValue=http://www.mamicode.com/"${petstore.work}/upload"
description="上传文件的目录" />
<property name="petstore.loggingLevel" defaultValue=http://www.mamicode.com/"warn"
description="日志文件级别">
</property>
</group>
<script>
<generate template="web.vm" destfile="WEB-INF/classes/spring-web.xml" charset="UTF-8"/>
</script>
</config>

这里property定义的名字都是占位符的名字,defaultvalue是默认值

script下面定义的具体的模板,以及输出的文件。


web.vm是模板文件定义了,也就是我们的配置文件,变量通过占位符分割

<?xml version="1.0" encoding="UTF-8"?>
<config>
<property name=${petstore.work}></property>
<property name=${petstore.loggingRoot}></property>
<property name=${petstore.upload}></property>
<property name=${petstore.loggingLevel}></property>
</config>

antx.property是具体配置的落地,可以有多个,通过mvn -p 制定具体的配置文件

petstore.work=1
petstore.loggingRoot=2
petstore.upload=3
petstore.loggingLevel=4

如果没有在pom。xml 通过configuration配置默认的antx.properties是在项目的根目录下,或者在user.home下的,如果没有autoconfig需要你创建。


通过修改四个文件基本上就可以使用auto-config了,打包后的文件已经将占位符修改成我们需要的值了,这个是多环境打包的神器。


maven auto-config 多环境自动打包