如何让jboss eap 6.2+ 的多个war应用共享 jar 包?

时间:2022-04-22
本文章向大家介绍如何让jboss eap 6.2+ 的多个war应用共享 jar 包?,主要内容包括其使用实例、应用技巧、基本知识点总结和需要注意事项,具有一定的参考价值,需要的朋友可以参考一下。

weblogic有一个很贴心的功能,允许把多个war应用共同依赖的jar包,打包一个单独的war,以libary方式部署,然后各应用在weblogic.xml里声明引用该libary即可,这样可大大减少打包后的war文件尺寸,可以加快部署的上传进度,对web server而言,这类共用jar包只加载一次,也节省资源。

但是jboss下想达到类似的功能就要复杂很多了,先来一个简单的示例:

一、基础篇

1.1 假如我们先开发了一个工具库,打包后生成的mylib.jar ,为了减少各种依赖项的干扰,这个工程不依赖任何其它第三方库,只有一个测试方法:

package yjmyzz.test;

public class TestUtils {

    public String sayHello(String msg) {
        return "Hello ," + msg + " !";
    }
}

1.2 再建一个spring mvc的web项目,为了简单起见,也只有一个空页面,啥功能也没有,pom.xml里引用刚才的mylib工程

1 <dependency>
2     <groupId>yjmyzz</groupId>
3     <artifactId>mylib</artifactId>
4     <version>1.0</version>
5     <scope>compile</scope>
6 </dependency>

Controller里,调用mylib中的sayHello方法

@RequestMapping("/index")
public String index() {
	TestUtils utils = new TestUtils();
	System.out.println(utils.sayHello("hello"));
	return "index";
}

然后打包,默认情况下mylib.jar会打进myweb项目的WEB-INF/lib下  

前面这些都是准备工作而已,不用太在意具体细节,下面才是正经开始.

现在我们要把这个mylib-1.0.jar给弄到jboss里,让它成为jboss的默认模块,最终目的是myweb.war的WEB-INF/lib目录下,不再需要这个jar。

1.3 折腾 jboss EAP

a. $JBOSS_HOME/modules 目录下,创建 mylib/main 目录,即要保证$JBOSS_HOME/modules/mylib/main目录存在

b. 把mylib-1.0.jar复制到$JBOSS_HOME/modules/mylib/main中

c. 在$JBOSS_HOME/modules/mylib/main中创建一个名为module.xml的文件,内容如下:

1 <?xml version="1.0" encoding="UTF-8"?>
2 <module xmlns="urn:jboss:module:1.1" name="mylib">
3     <resources>
4         <resource-root path="mylib-1.0.jar" />        
5     </resources>
6 </module>

注意:第2行中的name="xxx"这里的name一定要跟/modules/下的子目录名一致,如果子目录是多层结构,比如 /modules/mycompany/mylib/main,则这里的name应该是"mycompany.mylib"

1.4 应用新增加的module

module加好以后,myweb在启动时并不知道jboss新增了这个module,有3种方法可以处理:

a) 修改myweb.war中META-INF/MANIFEST.MF清单文件

Manifest-Version: 1.0
Dependencies: mylib
Built-By: jimmy
Build-Jdk: 1.7.0_79
Created-By: Apache Maven 3.3.3
Archiver-Version: Plexus Archiver

注意第2行, Dependencies: mylib 把这行加上后,就表示myweb.war在启动时,要依赖mylib这个module,如果我们自己开发的module不止一个,多个module之间要英文逗号隔开,比如:module1,module2

当然,这一行如果要人工手动添加,未免太不讲究,有maven-plugin可以帮我们搞定:

 1 <plugin>
 2     <groupId>org.apache.maven.plugins</groupId>
 3     <artifactId>maven-war-plugin</artifactId>
 4     <configuration>
 5         <archive>
 6             <manifestEntries>
 7                 <Dependencies>mylib</Dependencies>
 8             </manifestEntries>
 9         </archive>
10     </configuration>
11 </plugin>

b) 还有第2种方式,在WEB-INF下添加文件jboss-deployment-structure.xml,内容如下:

1 <jboss-deployment-structure>
2     <deployment>
3         <dependencies>
4             <module name="mylib"/>
5         </dependencies>
6     </deployment>
7 </jboss-deployment-structure>

c) 上面二种方式,都是由应用本身来控制加载哪些模块,也是我个人推荐的方式,还有一种一劳永逸的暴力方法,直接修改$JBOSS_HOME/standalone/configuration/standalone.xml文件(注:如果是domain模式,则相应修改domain.xml文件),内容如下:

1 <subsystem xmlns="urn:jboss:domain:ee:1.1">
2     <global-modules>
3         <module name="mylib" slot="main"/>
4     </global-modules>
5     <spec-descriptor-property-replacement>false</spec-descriptor-property-replacement>
6     <jboss-descriptor-property-replacement>true</jboss-descriptor-property-replacement>
7 </subsystem>

根据关键字":ee:1.1"找到这段, 添加第2-4行即可,这样jboss在启动时,会把这个当成全局module,默认加载。

注:这种方式虽然简单,但是不推荐,原因是如果jboss部署了多个应用,其它应用不知道有这个全局module,在自己的项目中再重复打包这些jar包,极容易在启动时造成冲突,最终启动失败,各种报错。

只有一种情况,比较适合这种方式:数据库驱动jar,比如:ojdbc6.jar这类,不过对于数据库驱动jar包而言,有一种更简单的方式,直接将驱动jar包当成普通应用来部署就行了,所以这种改standalone.xml的方式,仍然体现不出优越性。

1.5 修改pom.xml ,不打包公用jar包

既然mylib这个公用jar已经移动jboss中了,那么myweb这个项目打包里就不必再打包它了,修改pom.xml中的相关部分:

1 <dependency>
2     <groupId>yjmyzz</groupId>
3     <artifactId>mylib</artifactId>
4     <version>1.0</version>
5     <scope>provided</scope>
6 </dependency>

注意:第5行,改成provided表示该依赖项,运行时由jboss容器提供,因此打包时该项被忽略。

二、进阶篇

根据前面的步骤,好象并不难弄,但是实际应用中,如果想把一些知名的开源jar包,比如:spring, mybatis, hibernate , jackson这些全都以module的形式弄到jboss里,却并不容易,原因在于:这些开源项目本身又依赖其它开源项目,而其它开源项目,还有依赖,一层一层分析下来,关系十分复杂。更要命的的jboss本身也默认集成了一些知名的开源项目,比如:commons-logging之类,所以相互之间极容易冲突。就拿spring来说,最低层的是spring-core,它是依赖项最少的,如果要放到jboss的module中,module.xml内容为:

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 
 3 <module xmlns="urn:jboss:module:1.1" name="mylib.spring-core">
 4 
 5     <resources>
 6         <resource-root path="spring-core-4.1.1.RELEASE.jar" />        
 7     </resources>
 8 
 9     <dependencies>
10         <module name="org.apache.commons.logging"/>
11         <module name="javax.api" export="true"/>
12         <module name="org.jboss.vfs"/>
13     </dependencies>
14 
15 </module>

注意:9-13行,这里表示spring-core依赖了哪些更底层次的module,一个也都不能少,否则启动时就会有一堆其名其妙的错误。所以,分析众多开源项目和jboss内置module的依赖关系,将是一个极大的挑战。

spring 4.1.1-RELEASE整套jar包,全部以module方式融合进jboss的话,步骤如下: a) modules目录下先创建子目录org/springframework/spring/main

b) 将spring的一堆jar包复制进来,文件列表如下: spring-aop-4.1.1.RELEASE.jar               
 spring-aspects-4.1.1.RELEASE.jar          
 spring-beans-4.1.1.RELEASE.jar spring-context-4.1.1.RELEASE.jar           
 spring-context-support-4.1.1.RELEASE.jar   
 spring-core-4.1.1.RELEASE.jar              
 spring-expression-4.1.1.RELEASE.jar        
 spring-instrument-4.1.1.RELEASE.jar        
 spring-instrument-tomcat-4.1.1.RELEASE.jar spring-jdbc-4.1.1.RELEASE.jar spring-jms-4.1.1.RELEASE.jar spring-messaging-4.1.1.RELEASE.jar spring-orm-4.1.1.RELEASE.jar spring-oxm-4.1.1.RELEASE.jar spring-test-4.1.1.RELEASE.jar spring-tx-4.1.1.RELEASE.jar spring-web-4.1.1.RELEASE.jar spring-webmvc-4.1.1.RELEASE.jar spring-webmvc-portlet-4.1.1.RELEASE.jar spring-websocket-4.1.1.RELEASE.jar

c) module.xml内容如下:

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <module xmlns="urn:jboss:module:1.1" name="org.springframework.spring">
 3     <resources>
 4         <resource-root path="spring-aop-4.1.1.RELEASE.jar"/>
 5         <resource-root path="spring-aspects-4.1.1.RELEASE.jar"/>
 6         <resource-root path="spring-beans-4.1.1.RELEASE.jar"/>
 7         <resource-root path="spring-context-4.1.1.RELEASE.jar"/>
 8         <resource-root path="spring-context-support-4.1.1.RELEASE.jar"/>
 9         <resource-root path="spring-core-4.1.1.RELEASE.jar"/>
10         <resource-root path="spring-expression-4.1.1.RELEASE.jar"/>
11         <resource-root path="spring-instrument-4.1.1.RELEASE.jar"/>
12         <resource-root path="spring-instrument-tomcat-4.1.1.RELEASE.jar"/>
13         <resource-root path="spring-jdbc-4.1.1.RELEASE.jar"/>
14         <resource-root path="spring-jms-4.1.1.RELEASE.jar"/>
15         <resource-root path="spring-messaging-4.1.1.RELEASE.jar"/>
16         <resource-root path="spring-orm-4.1.1.RELEASE.jar"/>
17         <resource-root path="spring-oxm-4.1.1.RELEASE.jar"/>
18         <resource-root path="spring-test-4.1.1.RELEASE.jar"/>
19         <resource-root path="spring-tx-4.1.1.RELEASE.jar"/>
20         <resource-root path="spring-web-4.1.1.RELEASE.jar"/>
21         <resource-root path="spring-webmvc-4.1.1.RELEASE.jar"/>
22         <resource-root path="spring-webmvc-portlet-4.1.1.RELEASE.jar"/>
23         <resource-root path="spring-websocket-4.1.1.RELEASE.jar"/>
24     </resources>
25     <dependencies>
26         <module name="org.apache.commons.logging"/>
27         <module name="javax.api" export="true"/>
28         <module name="javaee.api" export="true"/>
29         <module name="org.jboss.vfs"/>
30     </dependencies>
31 </module>%

d) 应用中jboss-deployment-structure.xml的内容如下:

1 <?xml version="1.0" encoding="UTF-8"?>
2 <jboss-deployment-structure>
3     <deployment>
4         <dependencies>
5             <module name="org.springframework.spring" export="true" meta-inf="export"/>
6         </dependencies>
7     </deployment>
8 </jboss-deployment-structure> 

三、实战篇

下面就以一个Spring MVC 4.1.1 RELEASE + mybatis 3.2.8 + mysql + druid 的实例来说明,如何定制共享jar包: 这是打包后WEB-INF/lib下的所有依赖jar包:

aopalliance-1.0.jar commons-dbcp-1.4.jar commons-logging-1.1.3.jar commons-pool-1.5.4.jar mybatis-3.2.8.jar mybatis-spring-1.2.2.jar mysql-connector-java-5.1.25.jar spring-aop-4.1.1.RELEASE.jar spring-beans-4.1.1.RELEASE.jar spring-context-4.1.1.RELEASE.jar spring-core-4.1.1.RELEASE.jar spring-expression-4.1.1.RELEASE.jar spring-jdbc-4.1.1.RELEASE.jar spring-tx-4.1.1.RELEASE.jar spring-web-4.1.1.RELEASE.jar spring-webmvc-4.1.1.RELEASE.jar 整个应用打包后,war包的尺寸约为6.7M(注:druid数据源是用在jboss创建jndi datasource的,所以不需要打包在war中)。根据前面的介绍,一步一步来精减发布包:

1. %JBOSS_HOME/modules/mylib/main 先创建该目录,把lib下的这些jar文件,全复制进去

2. 然后创建module.xml

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <module xmlns="urn:jboss:module:1.1" name="mylib">
 3     <resources>
 4         <resource-root path="standard-1.1.2.jar"/>
 5         <resource-root path="jstl-1.2.jar"/>
 6         <resource-root path="aopalliance-1.0.jar"/>
 7         <resource-root path="mybatis-3.2.8.jar"/>
 8         <resource-root path="mybatis-spring-1.2.2.jar"/>
 9         <resource-root path="mysql-connector-java-5.1.25.jar"/>
10         <resource-root path="spring-aop-4.1.1.RELEASE.jar"/>
11         <resource-root path="spring-beans-4.1.1.RELEASE.jar"/>
12         <resource-root path="spring-context-4.1.1.RELEASE.jar"/>
13         <resource-root path="spring-core-4.1.1.RELEASE.jar"/>
14         <resource-root path="spring-expression-4.1.1.RELEASE.jar"/>
15         <resource-root path="spring-jdbc-4.1.1.RELEASE.jar"/>
16         <resource-root path="spring-tx-4.1.1.RELEASE.jar"/>
17         <resource-root path="spring-web-4.1.1.RELEASE.jar"/>
18         <resource-root path="spring-webmvc-4.1.1.RELEASE.jar"/>
19         <resource-root path="druid-1.0.15.jar"/>
20     </resources>
21     <dependencies>
22         <module name="org.apache.commons.logging"/>
23         <module name="javax.api" export="true"/>
24         <module name="javaee.api" export="true"/>
25         <module name="javax.transaction.api" export="true"/>
26         <module name="javax.servlet.api" optional="true"/>
27         <module name="org.jboss.vfs"/>
28     </dependencies>
29 </module>

3. 应用中的jboss-deployment-structure.xml

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <jboss-deployment-structure>
 3     <deployment>
 4         <exclusions>
 5            
 6         </exclusions>
 7         <dependencies>
 8             <module name="mylib"/>
 9         </dependencies>
10     </deployment>
11 </jboss-deployment-structure>

4. META-INF的特殊处理

因为spring的相关jar全放到jboss中了,这样会给应用本身运行带来问题,spring程序在启动时,会解析bean.xml配置文件,这个过程会加载spring.handers等文件,原来spring打包在应用本身中时,这些文件内嵌在sping的jar中,所以不会有问题,现在这些文件没有了,解析过程就会报错,因此需要手动把这些文件放到META-INF下,如图:

图中的这些文件,在spring里都可以找到,如果你的应用还使用了struts2,jstl,standard这些jar包,这些jar包里META-INF下的tld等文件也要复制到自己项目的META-INF下,根据我实际测试的结果,如果出现问题

spring-webmvc-xxx.jar

struts2-core-xxx.jar

这二个jar最好还是打包到应用中

最后别忘记了修改pom.xml文件,把所有依赖项的scope改成provided。

这样处理后,war包的尺寸从6.7M直接降到19K。