maven多个web模块进行合并

主要参考了:
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个部分来介绍：

1. maven多模块项目。
2. maven多web合并项目。
3. 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合并了，只是用的过程中需要注意以下几点：

1. 被合并的子web项目packaging属性必须是war
2. 被合并的子web项目，必须在主项目中添加依赖关系。
3. 被合并的子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文件夹就够了，其他都是用户根据自己的环境来做的。

1. 打开eclipse，修改本地maven仓库地址，导入maven项目，等待构建结束。
2. 创建server,打开window-prefrences-server-runTime Environment-new ....选择tomcat路径，jdk信息，这一步和原来完全一样。
3. 打开server视图，new server，这里选中刚才创建的tomcat，点击next,这步只需要主web项目添加进来即可。
4. 双击创建的server，选择将项目发布到tomcat的webapps目录下，点击pushlish，完成。

       再去tomcat目录，发现已经将合并后的web发布到对应目录下了。 引用的其他Java项目已经被打包成jar发布到lib下了，不过你可以打个断点试试，依然可以调试，修改一段代码，发现热部署也是可以的，这样就和原来的开发习惯完全一样了。