http://blog.csdn.net/xiaokui008/article/details/8592811
http://www.tuicool.com/articles/ArE3iaA
http://blog.csdn.net/xlxxcc/article/details/52356503
在一个大项目中拆分maven工程时,通常会根据业务模块进行拆分。无论怎么划分,往往每个模块又需要集成权限管理orm或者说依赖 静态资源web公共模块。而为了避免资源的浪费,或者是希望一次登录,可以访问多个模块, 也就是希望合并多个web打包部署。
实际当中,在开发的时候,为了方便,开发人员希望每个业务模块都可单独部署。而发布的时候,发布人员希望合并部署。
因此,在实际应用中,我们需要考虑如下问题:
- 1、war项目C和war项目B都依赖war项目A和JAR项目X. 项目A中保存了B和C项目通用的web资源,比如通用的javascript,CSS,jsp等.项目X中保存了B和C项目中都依赖的一些class
- 2、开发人员希望每次都只面对一个项目,即Team A 开发项目A, Team B开发项目B, Team C开发项目C….以此类推
- 3、每个Team在开发自己项目时,都希望能直接进行调试,例如war项目A可以直接部署到TOMCAT上运行测试
- 4、实际交付给客户的却只有2个项目: B和C .也就是说,最后要打包B和C,而在B和C的war包中都要包含A中的web资源和X中的class
-
5、最后如果war项目A是一个加载公共缓存资源, 而且希望可以手动更新缓存, 并同时对war项目C和war项目B产生作用,而B和C是希望通过class去调用,而不是希望通过写一个a的接口去调用。
如何解决上诉问题?
首先看一下web工程test部署后的目录视图:
test (webapp)
- - META-INF
- - MANIFEST.MF
- - WEB-INF
- - classes (src/main/Java编译后的类)
- - lib (第三方架包)
- - web.xml
- - … (src/main/resources下的配置文件)
- - … (webapp目录下的其他的静态资源)假如有两个web, test1和test2,如果手动操作合并打包,我们需要按照一下介个步骤。
1、 先创建一个test.war,
2、 将test1和test2的.class文件打包到 test/WEB-INF/classes目录
3、 将test1和test2的lib文件打包到 test/WEB-INF/lib目录下
4.、将test1和test2的web.xml文件内容合并,并且放到 test/WEB-INF/目录下
5、 将test1和test2的src/main/resources下的配置文件,复制到 test/WEB-INF/目录下, 如果存在同名文件,要么合并,要么改名
6、 将test1和test2的webapp的目录静态资源,复制到 test/WEB-INF/目录下。
从上诉步骤来看,我们需要注意下面三个事情:
1、web.xml配置文件在合并打包的时候,需要将其内容合并,相对麻烦
2、 src/main/resources下的配置文件, 同名配置文件内容不同时,需要保证名字不一样或者将配置内容合并, 容易出错
3、同样,webapp的目录静态资源,同名配置文件内容不同时,也需要保证名字不一样,无法合并,很容易出错因此在开发各模块的时候,我们需要做到:
1、各模块之间尽可能的保证不存在同名文件
2、不能不存在的同名文件,如web.xml,尽可能保证内容一致。或者创建一个父工程,把所有模块之间的web.xml融合进去。如spring-mvc.xml,尽可能把相同的配置放在父工程。然后把特性的配置放在特有的模块之中,如bean.xml配置文件,注意保证该bean.xml不存在重复的。那么在maven中是怎样合并打包部署呢?没错,就是使用overlays。overlays就是将上述所说的操作步骤自动化了。在overlay标签中,可以过滤到重复的配置文件等等。
我们看一下在父工程test中怎样配置,使得能合并打包test1和test2。使用overlay标签,也得注意我们上面所说的注意事项。避免同名重复配置文件等导致部署失败。好了,废话不多说,直接上配置文件代码吧。
pom.xml
<dependencies>
<!-- 如果test的中有对test1和test2的依赖,这个配置是不可少的-->
<dependency>
<groupId>cn.com.xlxxcc</groupId>
<artifactId>test1</artifactId>
<version>1.0.0</version>
</dependency>
<dependency>
<groupId>cn.com.xlxxcc</groupId>
<artifactId>test2</artifactId>
<version>1.0.0</version>
</dependency>
<!-- 下面的这个配置,在集成其他war的时候,是必不可少的 -->
<dependency>
<groupId>cn.com.xlxxcc</groupId>
<artifactId>test1</artifactId>
<version>1.0.0</version>
<type>war</type>
</dependency>
<dependency>
<groupId>cn.com.xlxxcc</groupId>
<artifactId>test2</artifactId>
<version>1.0.0</version>
<type>war</type>
</dependency>
</dependencies>
<build>
<finalName>test</finalName>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<version>2.6</version>
<configuration>
<packagingExcludes>WEB-INF/web.xml</packagingExcludes>
<overlays>
<!-- 合并test1 -->
<overlay>
<groupId>cn.com.xlxxc</groupId>
<artifactId>test1</artifactId>
<!-- 过滤test1中相同的配置文件 -->
<excludes>
<exclude>**/*-context.xml</exclude>
<exclude>**/*-ds.xml</exclude>
</excludes>
</overlay>
<!-- 合并test2 -->
<overlay>
<groupId>cn.com.xlxxcc</groupId>
<artifactId>test2</artifactId>
<!-- 过滤test2中相同的配置文件 -->
<excludes>
<exclude>**/*-context.xml</exclude>
<exclude>**/*-ds.xml</exclude>
</excludes>
</overlay>
</overlays>
</configuration>
</plugin>
</plugins>
</build>
至于overlay标签的配置详解,大家可以查一下api.
这篇文章,我准备分3个部分来介绍:
- maven多模块项目。
- maven多web合并项目。
- maven多web合并项目在eclipse+tomcat环境下部署和调试。
maven多模块项目
maven多模块项目需要一个父工程来聚合各个子模块,不过其实就是需要一个父pom.xml,主要作用是声明子模块,代码如下:
<modules>
<module>modules/fixflow-core</module>
<module>modules/fixflow-expand</module>
<module>modules/fixflow-common-api</module>
<module>modules/fixflow-common-servlet</module>
<module>modules/fixflow-manage-servlet</module>
<module>modules/fixflow-webapp-common</module>
<module>modules/fixflow-webapp-taskcenter</module>
<module>modules/fixflow-webapp-managecenter</module>
<module>modules/fixflow-webapp-explorer</module>
<module>modules/fixflow-converter</module>
<module>modules/fixflow-webapp-editor</module>
</modules>
然后在子模块中,声明父工程,子模块中代码如下:
<parent>
<groupId>com.founder.fix.fixflow</groupId>
<artifactId>fixflow-root</artifactId>
<version>5.0</version>
<relativePath>../..</relativePath>
</parent>
关于多模块的文章,网上有很多,也都很详细,这里不再多说。
maven多web合并项目
多web项目合并,主要是我在网上找到的资料都不是我最终想要的效果,所以这里就介绍下我最终使用的方案,网上有很多方案都是介绍用caro插件,我到现在也不明白为什么要使用这个插件。
maven的多web模块maven-war-plugin插件的overlays属性来处理,最终主web项目pom.xml代码如下
<build>
<finalName>bpmcenter</finalName>
<plugins>
<!-- 合并多个war -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-war-plugin</artifactId>
<configuration>
<packagingExcludes>WEB-INF/web.xml</packagingExcludes>
<overlays>
<overlay>
<groupId>com.founder.fix.fixflow</groupId>
<artifactId>fixflow-webapp-taskcenter</artifactId>
</overlay>
</overlays>
</configuration>
</plugin>
</plugins>
</build>
这里使用到了maven-war-plugin,用overlay属性已经足够将多web合并了,只是用的过程中需要注意以下几点:
- 被合并的子web项目packaging属性必须是war
- 被合并的子web项目,必须在主项目中添加依赖关系。
- 被合并的子web项目中,如果没有web.xml,则需要在pom.xml中声明
<build> <finalName>fixflow-webapp-editor</finalName> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-war-plugin</artifactId> <configuration> <failOnMissingWebXml>false</failOnMissingWebXml> </configuration> </plugin> </plugins> </build>
做完以上几点,多web项目合并就基本上做完了,运行mvn install就会发现打出的war包中已经存在了其他子模块的项目。
多web项目在eclipse+tomcat环境下部署调试
在eclipse里面使用,其实更简单,只是网上的说法太复杂了而已,对于习惯了tomcat开发的用户来说。
对于maven项目,一个环境到另一个环境应该只有pom.xml文件和src文件夹就够了,其他都是用户根据自己的环境来做的。
- 打开eclipse,修改本地maven仓库地址,导入maven项目,等待构建结束。
- 创建server,打开window-prefrences-server-runTime Environment-new ....选择tomcat路径,jdk信息,这一步和原来完全一样。
- 打开server视图,new server,这里选中刚才创建的tomcat,点击next,这步只需要主web项目添加进来即可。
- 双击创建的server,选择将项目发布到tomcat的webapps目录下,点击pushlish,完成。
再去tomcat目录,发现已经将合并后的web发布到对应目录下了。 引用的其他Java项目已经被打包成jar发布到lib下了,不过你可以打个断点试试,依然可以调试,修改一段代码,发现热部署也是可以的,这样就和原来的开发习惯完全一样了。