maven maven-war-plugin 的配置

maven maven-war-plugin 的配置

文章分类:综合技术

     在公司使用ANTX作为构建工具，一直以来感觉ANTX的auto-config功能很实用，它很好的将不同环境的打包方式通过properties文件分离了开来，且ANTX的这部分功能的实现应该是采用Velocity实现，故可以实现非简单的变量填充的功能，在配置中还可以写简单VM的语法。后来构建工具转型到MAVEN之后一直在寻找一种与ANTX 的autoconfig功能类似的插件，以解决不同环境打包的动态参数设置问题。经过google后发现了此插件，此处记录一下该插件----maven-war-plugin 。

 

基本配置 ：（包括排除 不想打进war包的jar 的配置）

 

<build>
    <filters>
        <!-- 过滤文件,通常是一个属性文件（名值对的形式） -->
        <filter>src/main/webapp/META-INF/auto-config.properties</filter>
        <!--
            <filter>${user.home}/antx.properties</filter>
        -->
    </filters>
    <finalName>communitytag</finalName>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-war-plugin</artifactId>
            <version>2.1-alpha-1</version>
            <configuration>
                <!--
                    打包之前过滤掉不想要被打进 .war包的jar,注意：这个地方，本来路径应该是
                    WEB-INF/lib/anaalyzer-2.0.4.jar,但是经过多次试验,不能这样，至于咋回事儿，搞不清楚。。经多方查证均无结果
                    暂且这样吧，虽然显得很丑陋，但是总能解决问题吧
                -->
                <warSourceExcludes>*/lib/analyzer-2.0.4.jar</warSourceExcludes>
                <webResources>
                    <resource>
                        <!-- 元配置文件的目录，相对于pom.xml文件的路径 -->
                        <directory>src/main/webapp/WEB-INF</directory>

                        <!-- 是否过滤文件，也就是是否启动auto-config的功能 -->
                        <filtering>true</filtering>

                        <!-- 目标路径 -->
                        <targetPath>WEB-INF</targetPath>
                    </resource>
                </webResources>
            </configuration>
        </plugin>
    </plugins>
</build>

 

 

如上配置及到web项目的pom文件中，且配置中路径相关的信息均以pom作为路径。

 

应用举例：

 

为了能更好的理解这个配置是怎么回事儿，我们来看看达到了什么样的效果，如下：

在应用的配置文件路径为 src/main/webapp/WEB-INF/biz/a.xml 有如下配置

 

<?xml version="1.0" encoding="GBK"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans default-autowire="byName">
    <bean id="tagEntityManagementAO" class="com.taobao.communitytag.biz.ao.impl.DefaultTagEntityManagementAO">
        <property name="namespace" value="${communitytag.biz.tair.namespace}"/>
    </bean>
</beans>

 

上面的配置中有如下需要动态植入的变量

${communitytag.biz.tair.namespace}

故我们将此变量对应的值配置到属性文件src/main/webapp/META-INF/auto-config.properties(pom.xml文件中filter的配置)，如下

 

communitytag.biz.tair.namespace=242

 

至此，执行命令mvn install,我们看看目标文件targe下的a.xml内容已经动态产生了，如下

 

<?xml version="1.0" encoding="GBK"?>
<!DOCTYPE beans PUBLIC "-//SPRING//DTD BEAN//EN" "http://www.springframework.org/dtd/spring-beans.dtd">
<beans default-autowire="byName">
    <bean id="tagEntityManagementAO" class="com.taobao.communitytag.biz.ao.impl.DefaultTagEntityManagementAO">
        <property name="namespace" value="242"/>
    </bean>
</beans>

 

结果已经很形象了。。。虽然不能支持像antx那样对velocity语法的支持，但是此插件对于大多数环境打包来说，已经足够了。至于这个plugin的深度的功能研究，待以后有需求的时候继续研究，记录在此以便查阅。