8.4. JBoss EAP 5 组件升级参考

应用程序打包和类加载

在 JBoss EAP 6 中，之前分层类加载结构被基于 JBoss 模块的模块化架构取代。应用打包也因为新的模块化类加载结构而改变。JBoss EAP 7 中仍然使用此架构。有关新的模块化架构的信息，请参见 JBoss EAP 7.3 开发指南中的以下章节。

有关如何为新模块化架构更新和重新打包应用的详情，请参考 JBoss EAP 6 迁移指南中的以下章节 ：

应用程序配置文件

由于 JBoss EAP 6 中的更改以使用模块化类加载，您可能需要创建或修改一个或多个应用配置文件，以添加依赖项或防止自动加载依赖项。这在 JBoss EAP 7 中没有改变。详情请查看 JBoss EAP 6 迁移指南中的以下章节。

缓存和 Infinispan

JBoss 缓存被 Infinispan 取代，仅供服务器在 JBoss EAP 6 中使用。如需有关如何在应用程序代码中替换 JBoss 缓存的信息，请参见 JBoss EAP 6 迁移指南中的以下章节。

本指南的以下小节中记录了 JBoss EAP 7 的 Infinispan 缓存策略和配置更改。

数据源和资源适配器

JBoss EAP 6 将数据源和资源适配器配置整合到一个文件中，JBoss EAP 7 中也是如此。如需更多信息，请参见 JBoss EAP 6 迁移指南中的以下章节。

目录结构、脚本和部署配置

在 JBoss EAP 6 中，目录结构、脚本和部署配置已更改。这些更改在 JBoss EAP 7 中仍然有效。如需更多信息，请参见 JBoss EAP 6 迁移指南中的以下章节。

EJB

Java EE 7 规范使 EJB 2.x 及更早的功能为可选，因此强烈建议您重新编写应用代码以使用 EJB 3.x 规范和 JPA。有关运行 EJB 2.x 所需的弃用功能和更改的信息，请参见 JBoss EAP 6 迁移指南中的以下章节 ：

在 JBoss EAP 6 中，服务器配置文件的 ejb3 子系统中配置有状态 EJB 缓存和无状态会话 Bean 池大小。jboss-ejb3.xml 部署 描述符取代了 jboss.xml 部署 描述符文件。有关这些更改的更多信息，请参见 JBoss EAP 6 迁移指南中的以下章节 ：

JBoss EAP 7 中的默认远程连接器和端口已更改。有关此变化和服务器配置更改的更多信息，请参阅本指南中的以下部分。

JBoss EAP 7 不支持 EJB 实体 bean。有关如何将实体 Bean 迁移到 JPA 的详情，请参考本指南的以下章节。

Hibernate 和 JPA

在 JBoss EAP 6 中，Hibernate 从版本 3 更新至版本 4。此版本的 JBoss EAP 还实施了 JPA 2.0 规范，并对 JPA 持久性属性进行了更改。有关如何为这些更改修改应用的详情，请参考 JBoss EAP 6 迁移指南中的以下章节。

JBoss EAP 7.3 实施 JPA 2.2，包括 Hibernate 5.3。它还包括 Hibernate Search 版本 5.10。其他更改包括删除对 EJB 实体 Bean 的支持，以及对 JPA 持久性属性的其他更新。有关这些更改如何影响应用程序的详情，请查看本指南中的以下部分。

JAX-RS 和 RESTEasy

JBoss EAP 6 捆绑了 RESTEasy 2，它会自动配置 RESTEasy，需要对应用程序配置进行更改。如需更多信息，请参见 JBoss EAP 6 迁移指南中的以下章节。

JBoss EAP 7 包括 RESTEasy 3，许多课程已被弃用。Jackson 的版本从 1.9.9 版变为 2.6.3 或更高版本。有关这些更改的详情，请查看本指南的以下部分。

JBoss AOP

JBoss AOP（面向规格的编程）已在 JBoss EAP 6 中移除。有关如何使用 JBoss AOP 重构应用的详情，请参考 JBoss EAP 6 迁移指南中的以下章节 ：

JGroups 和集群

您启用群集和指定 JBoss EAP 6 中更改的绑定地址的方式.如需更多信息，请参见 JBoss EAP 6 迁移指南中的以下章节。

在 JBoss EAP 7 中，JGroups 现在默认为使用专用网络接口而不是公共网络接口，并在 jgroups 子系统中引入 <channel> 元素。JBoss EAP 7 还包含 Undertow mod_cluster 实施，引入了用于构建单例服务的新 API 和其他新的集群功能。这些更改记录在本指南的以下小节中。

JNDI

JBoss EAP 6 实施了新的标准化全局 JNDI 命名空间和一系列相关命名空间，它们映射到 Java EE 应用的不同范围。如需有关使用新 JNDI 命名空间规则所需的应用更改的信息，请参见 JBoss EAP 6 迁移指南中的以下章节。

JSF

JBoss EAP 6.4 包含 JSF 1.2 和 JSF 2.1，允许您配置应用以使用较旧版本。这在 JBoss EAP 7.3 中不再可能，现在包括 JSF 2.3。如需更多信息，请参阅本指南中的以下部分。

日志记录

JBoss EAP 6 引入了新的 JBoss 日志框架，仍在 JBoss EAP 7 中使用。使用第三方日志记录框架的应用可能会受到模块化类加载更改的影响。参阅 JBoss EAP 6 迁移指南中的以下章节，以了解有关这些更改的信息。

在 JBoss EAP 7 中，org.jboss.logging 软件包中的注解现已弃用，这将影响源代码和 Maven GAVs(groupId:artifactId:version)。所有日志消息的前缀也已更改。有关这些更改的详情，请查看本指南中的以下部分。

消息传递和 JMS

在 JBoss EAP 6 中，HornetQ 取代了 JBoss Messaging 作为默认的 JMS 实施。在 JBoss EAP 7 中，ActiveMQ Artemis 取代了 HornetQ 作为内置消息传递提供程序。

迁移消息传递配置的最佳方法是从 JBoss EAP 7 默认服务器配置开始，使用以下指南应用您当前的消息传递配置更改：

如果您想了解从 JBoss Messaging 转移到 HornetQ 所需的更改，请查看 JBoss EAP 6 迁移指南中的以下章节 ：

然后查阅以下有关如何迁移本指南中 HornetQ 配置和相关消息传递数据的信息。

ORB

在 JBoss EAP 6 中，JacORB 配置从 EAP_HOME/server/production/conf/jacorb.properties 文件中移到服务器配置文件中。JBoss EAP 7 随后将 JacORB IIOP 实施替换为 OpenJDK ORB 的下游分支。

迁移 ORB 配置的最佳方法是从 JBoss EAP 7 默认服务器配置开始，并使用 JBoss EAP 7.3 配置指南中的以下小节来应用您当前的 ORB 配置更改。

远程调用

JBoss EAP 6 中引入了一个新的 EJB 客户端 API 用于远程调用；但是，如果您不希望重新编写应用代码以使用新的 API，您可以修改现有代码以使用 ejb:BEAN_REFERENCE 远程访问 EJB。如需更多信息，请参见 JBoss EAP 6 迁移指南中的以下章节。

在 JBoss EAP 7 中，默认的连接器和默认远程连接端口已更改。如需更多信息，请参阅本指南中的以下部分。

Seam 2.x

尽管 JBoss EAP 6 中不再提供对 Seam 2.2 应用程序的官方支持，但仍然可以配置 JSF 1.2 和 Hibernate 3 的依赖关系，以允许 Seam 2.2 应用程序在该版本上运行。JBoss EAP 7.3 现已包括 JSF 2.3 和 Hibernate 5.3，由于红帽 JBoss Web 框架工具包生命周期已结束，不支持 Seam 2.2 或 Seam 2.3。建议您使用 Weld CDI Bean 重写 Seam 组件。

安全性

JBoss EAP 6 的安全更新包括对安全域名的更改，以及对如何配置基本身份验证安全性的更改。LDAP 安全域配置已移到服务器配置文件中。如需更多信息，请参阅 JBoss EAP 6 迁移指南中的以下章节。

影响 JBoss EAP 7 安全性的更新包括服务器配置更改和应用更改。信息可在本指南的以下各节中找到。

Spring 应用程序

Spring 4.2.x 是 JBoss EAP 7 支持的最早稳定 Spring 版本。有关 Apache CXF Spring Web 服务和 Spring RESTEasy 集成更改的详情，请查看本指南中的以下章节：

事务

JBoss EAP 6 整合了事务配置，并将其移入服务器配置文件。其他更新包括对 JTA 节点标识符设置的更改以及如何启用 JTS。详情请查看 JBoss EAP 6 迁移指南中的以下章节。

JBoss EAP 7 中的 transaction 子系统中提供的一些 交易 管理器配置属性在 JBoss EAP 7 中有所变化。如需更多信息，请参阅本指南中的以下部分。

valves

Undertow 在 JBoss EAP 7 中取代 JBoss Web，不再支持 valves。请参阅本指南中的以下部分。

Web 服务

JBoss EAP 6 包括 JBossWS 4。有关此版本更新所需更改的信息，请参见 JBoss EAP 6 迁移指南中的以下章节。

JBoss EAP 7 引入了 JBossWS 5.如需所需的更新，请参阅本指南中的以下部分。