从Jboss5迁移到Jboss7

关注

转载最新推荐文章于 2026-05-15 09:18:39 发布 1.5k 阅读 AI 写同款· GEO 优化 ›

学习了解jboss7 1. 什么是J2EE? J2EE是Java 2enterprise edition，是Java的一种企业版，用于企业级的应用服务开发。 J2SE是Java 2standard edition，是Java的标准版，用于标准的应用开发。 J2ME是Java 2Micro Edition，是Java的微型版，常用于手机上的开发。 J2EE,J2SE,J2ME是java 阅读详情

1. Jboss7新特性

1.1 构建在Modular Service Container上，充分地利用了多核处理器的能力，并发、按需启动服务，启动速度更快、占用内存更小。

1.2 全面兼容Java EE6

1.3 支持JDK6/7

1.4 统一的配置和管理

1.5 兼容OSGI 4.2，支持OSGI和Java EE组件模型集成。

1.6容易测试：利用Arquillian测试平台—一种集成测试组件模型，更易于测试，改变-编译-测试的周期更短。

1.7 两种模式

Standalone模式（使用standalone.bat启动）相当于以前的3、4、5、6版本。配置文件、发布内容等放在standalone目录下。

Domain模式（使用domain.bat启动）是Jboss7的一个新特征，可以在一个控制点管理多个服务器。

1.8 类加载

类加载基于Jboss Module，取代了层次类加载环境，避免了当类存在多个版本时，导致类加载错误。由于类加载是基于模块的，必须显示的定义模块依赖。部署也是模块化的，如果没有显示的定义类依赖则不能访问应用服务器jar中的类。

2. 迁移步骤

在Jboss7部署项目与在jboss5上有很大区别，最主要原因是由于类的加载模式改变了。Jboss5部署相对简单，只需将相应的包部署到lib和deploy目录即可，类加载器会按层次自动加载，不用配置依赖关系。而jboss7完全不一样，jboss7是按模块化加载，不同模块由不同类加载器加载，其他模块的jar包，对其是不可见的，这时需要手动配置包之间依赖关系，否则会报ClassNotFoundException等错误。另外对于数据源和JNDI的配置也发生了变化，所以把项目从Jboss5往Jboss7迁移时可以大概分为下述3个步骤：

2.1 依赖关系的配置

在Jboss7中，模块之间的依赖关系分为隐式依赖和显式依赖。

2.1.1隐式依赖

尽管Jboss7中模块默认是隔离的，在部署过程中，一些由应用服务器定义的模块依赖会自动装配。例如，如部署一个Java EE应用，将自动添加Java EE API依赖，这也称为隐式模块依赖。

2.1.2显式依赖

对于显式依赖，必须在MANIFEST.MF文件的“Dependencies:”或“Class-Path:”项或在Jboss7特有的部署文件jboss-deployment-structure.xml中显式定义。对于已有的项目，手动去查找各个模块之间的依赖关系是费时又费力的，可以通过Tattletale工具来分析，在分析报告的OUTPUT_DIRECTORY/index.html文件中点击"JBoss A7"则可以得到部分依赖关系，另外的依赖关系可以在“Depends On”中得到。

在Jboss7中类的加载优先级（从高到低）：

（1）系统依赖 - 服务器自动加载的模块依赖，包括Java EE api。

（2）用户依赖 - 在jboss-deployment-structure.xml（在ear的META-INF内，war的META-INF或WEB-INF内）或Dependencies: 项内配置的依赖。

（3）本地资源 - 发布目录下的类文件，如war包下的WEB-INF/classes或WEB-INF/lib。

（4）部署间依赖 - 在ear内的其他部署依赖。包括ear lib 目录内的类，或其他ejb包内的类。

在部署时，War包被认为是一个单独的模块，WEB-INF/lib和WEB-INF/classes内的类是相同的，都由同一类加载器加载。Ear包是多模块的部署。这意味着不是ear内的所有类都能访问ear内所有其他类，除非指定明确的依赖。默认情况下，EAR/lib目录是一个单独的模块，每个WAR或EJB jar是一个单独的模块。子部署(war和ejb-jar)总是依赖父模块，可以访问EAR/lib内的类，然而它们彼此间不总是有自动依赖。可以通过修改如下配置控制这个行为：

<ear-subdeployments-isolated>false</ear-subdeployments-isolated>

</subsystem>

ear-subdeployments-isolated默认值为false，允许子部署访问其他子部署的类。在一个Ear包中，war可以访问jar包里的类，jar包之间也可以相互访问，但是jar包不能访问war包中的类，不管ear-subdeployments-isolated的值为true还是false。

2.1.3全局模块

可以把一些模块设置为全局模块，则所有的部署都可以访问该模块，在做项目迁移时，可以使用这种方法来解决模块依赖问题。格式如下:

<global-modules>

</global-modules>

2.2 数据源配置

在Jboss5中，数据源的配置文件为*-ds.xml文件，该文件放在服务器的deploy目录下，其相应的JDBC驱动则放在服务器的lib目录或应用程序的WEB-INF/lib目录下。而在Jboss7中这些都不需要，配置文件为Jboss7_home/standalone/configuration/standalone.xml或者是Jboss7_home/domain/configuration/domaion.xml。可以使用IronJacamar工具把原来的*-ds.xml文件转变为Jboss7中所需要的格式。

2.2.1 安装JDBC驱动

安装JDBC驱动分为两种方式：（1）作为一个部署（推荐的做法）（2）作为一个模块

2.2.1.1 作为一个部署

直接把JDBC驱动作为一个普通的jar包放在deployment目录下，该JDBC驱动应该是一个兼容JDBC4（Jdbc 4兼容的driver在jar包内含有META-INF/services/java.sql.Driver文件，其中指定了驱动类名称。）的驱动。若JDBC驱动包含不止一个jar包，则应作为一个模块来部署。

2.2.1.2 作为一个模块

需要在modules目录下创建一个目录结构，其内包含驱动jar包和module.xml文件。下面以安装mysql驱动为例，首先在modules目录下建立com/mysql/main文件夹，且把mysql驱动和module.xml文件放在main文件夹中。module.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>

<resource-root path="mysql-connector-java-5.1.15.jar"/>

</resources>

</dependencies>

</module>

需要注意的是name应与建立的文件夹同名且module.xml文件的开头不能有空格，否则会产生“New missing/unsatisfied dependencies”错误。

2.2.2 注册JDBC驱动

2.2.2.1 作为模块的JDBC驱动注册

<connection-url>jdbc:mysql://localhost:3306/YourApplicationURL</connection-url>

<driver> mysql-connector-java-5.1.15.jar </driver>

<transaction-isolation> TRANSACTION_READ_COMMITTED </transaction-isolation>

<pool>

<min-pool-size>100</min-pool-size>

<max-pool-size>200</max-pool-size>

</pool>

<user-name> USERID </user-name>

<password> PASSWORD</password>

</security>

<prepared-statement-cache-size>100</prepared-statement-cache-size>

<share-prepared-statements/>

</statement>

</datasource>

2.2.2.2 作为部署的JDBC驱动注册

<connection-url>jdbc:mysql://localhost:3306/gg</connection-url>

<driver>mysql</driver>

<pool>

<min-pool-size>20</min-pool-size>

<max-pool-size>20</max-pool-size>

</pool>

<user-name>root</user-name>

</security>

<driver-class>com.mysql.jdbc.Driver</driver-class>

</driver>

</datasources>

2.3 JNDI

2.3.1 JNDI命名规则

jboss7使用了更为严格的JNDI命名规则，其基本规则如下：

（1）相对命名如“ExampleDS”或“jdbc/ExampleDS”应该修改为相对于具体环境，如“java:comp/env”,“java:jboss/env”，“java:module/env”等。

（2）绝对命名如“/jdbc/ExampleDS”应该修改为相对命名如“java:jboss/root”。

（3）如“java:/jdbc/ExampleDS”的绝对命名也应如（2）修改。

（4）“java:jboss”命名在整个jboss服务器中时共享的。

（5）任何以“java:”开头的命名必须结合“comp”，“module”，“app”，“global”，“jboss”中的一个，否则会报错。

2.3.2 Local JNDI

name	scope	properties
java:comp	current component	standard namespaces
java:module	current module
java:app	current application
java:global	application server
java:jboss	global	jboss7 提供的全局命名
java:/	global
java:jboss/exported	global