在一个大项目中拆分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