用overlays合并多个war

转自http://kyfxbl.iteye.com/blog/1678121

在一个大项目中拆分maven工程时，很有可能会把js、css、jsp等文件放在不同的工程里（根据业务模块划分）。因为如果都集中在一个maven webapp里，那么这个maven webapp会太大，而且在业务上也比较分散。但是这些持有js、css、jsp的maven工程，如果packaging设置为jar是不合适的，因为外围要读取内部的这些文件就会很困难。在这种场景下，一个很自然的想法就是打成war包，然后用某种方式将多个war包归并起来，得到最终的war包 

这就是overlays发挥作用的地方

以下举一个例子：

这里有2个web工程，一个是task-sla-web，一个是task-web-dist，packaging类型都是war，目录结构如下：

 
 
下面是task-sla-web的pom文件：

    <modelVersion>4.0.0</modelVersion>
    <groupId>com.huawei.inoc.wfm.task</groupId>
    <artifactId>task-sla-web</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>task-sla-web</name>

该工程就是打成一个war包，但是这个war是无法运行的，而是稍后用来合并的。（其中放了 一个空的web.xml，因为maven-war-plugin的package goal有强制要求）
下面是task-web-dist的pom文件：

    <modelVersion>4.0.0</modelVersion>
    <groupId>com.huawei.inoc.wfm.task</groupId>
    <artifactId>task-web-dist</artifactId>
    <packaging>war</packaging>
    <version>0.0.1-SNAPSHOT</version>
    <name>task-web-dist</name>
    <!-- 合并多个war -->
     <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-war-plugin</artifactId>
                <version>2.1.1</version>
                <configuration>
                    <overlays>
                        <overlay>
                            <groupId>com.huawei.inoc.wfm.task</groupId>
                            <artifactId>task-sla-web</artifactId>
                        </overlay>
                    </overlays>
                </configuration>
     </plugin>
     <!-- 配置依赖 -->
     <dependencies>
        <dependency>
            <groupId>com.huawei.inoc.wfm.task</groupId>
            <artifactId>task-sla-web</artifactId>
            <version>0.0.1-SNAPSHOT</version>
            <type>war</type>
        </dependency>
    </dependencies>

以上片段主要要注意几点：

1、task-web-dist自身的packaging类型也是war

2、在<overlay>中配置要归并的webapp的groupId和artifactId，注意的是，该pom所在的webapp工程是主工程，会覆盖掉所有待归并工程的同名文件，包括web.xml

3、要归并的webapp，必须声明为依赖

归并后的最终war包如下：
 
其中的文件和.class都是由2个war包归并得到的，task-web-dist是主war包，如果多个war包中存在重名文件，则会被task-web-dist的文件覆盖，比如web.xml

 参考链接

http://maven.apache.org/plugins/maven-war-plugin/overlays.html