8.4. JBoss EAP 5 组件升级参考

应用程序打包和类加载

在 JBoss EAP 6 中，以前的分层类加载结构被替换为基于 JBoss 模块的模块架构。由于新的模块化类加载结构，应用程序打包也会改变。此架构仍在 JBoss EAP 7 中使用。有关新模块化架构的详情，请参考 JBoss EAP 7.4 开发指南中的以下章节：

有关如何为新的模块化架构更新并重新打包应用程序的详情，请参考 JBoss EAP 6 迁移指南中的以下内容。

应用程序配置文件

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

缓存和 Infinispan

JBoss 缓存被 Infinispan 替代，供服务器在 JBoss EAP 6 中供服务器使用。如需了解如何在应用程序代码中替换 JBoss Cache 的信息，请参阅 JBoss EAP 6 迁移指南 中的以下部分。

JBoss EAP 7 的 JBoss EAP 7 的缓存策略和配置更改记录在本指南的以下部分。

数据源和资源适配器

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

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

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

Enterprise Bean

您的应用程序代码必须使用 enterprise Bean 3.x API 和 Jakarta Persistence。有关运行 Enterprise Beans 2.1 所需的已弃用的功能和更改的详情，请参考 JBoss EAP 6 迁移指南中的以下章节 ：

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

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

JBoss EAP 7 不支持 Enterprise bean 实体 Bean。有关如何将实体 Bean 迁移到 Jakarta Persistence 的信息，请参阅本指南的以下部分。

Hibernate 和 Jakarta Persistence

JBoss EAP 7.4 实施 Jakarta Persistence 2.2 并包括 Hibernate 5.3。它还包括 Hibernate Search 版本 5.10。其他变更包括删除 Jakarta Enterprise Beans 实体 Beans 实体 Bean 以及 Jakarta Persistence 属性的其他更新。有关这些更改对应用程序如何影响的详情，请参考本指南中的以下部分。

jakarta RESTful Web 服务和 RESTEasy

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

JBoss AOP

JBoss AOP(Aspect Oriented programming)已在 JBoss EAP 6 中删除。有关如何重构使用 JBoss AOP 的应用的详情，请参考 JBoss EAP 6 迁移指南中的以下章节。

JGroups 和集群

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

在 JBoss EAP 7 中，JGroups 现在默认使用私有网络接口而不是公共网络接口，同时也向 jgroups 子系统引入 & lt;channel > 元素。JBoss EAP 7 还包括 Undertow mod_cluster 实施，它引入了一个新的 API，用于构建单例服务和其他新的集群功能。这些更改记录在本指南的以下部分。

Java 命名和目录接口

JBoss EAP 6 实施了新的标准化全局 Java 命名和目录接口命名空间和一系列相关命名空间，它们映射到应用程序的各种范围。有关使用新 Java 命名和目录接口命名空间规则所需的应用程序更改的信息，请参阅 JBoss EAP 6 迁移指南的以下部分。

jakarta Server Faces

在 JBoss EAP 6.4 上，您可以将您的应用程序配置为使用较旧版本。JBoss EAP 7.4 中无法再做到这一点，它现在包含 Jakarta Server Faces 2.3。如需更多信息，请参阅本指南中的以下部分。

日志记录

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

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

消息传递和 Jakarta Messaging

在 JBoss EAP 7 中，ActiveMQ(0)被取代 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.4 配置指南中的以下小节 来应用您当前的 ORB 配置更改。

远程调用

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

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

Seam 2.x

虽然 JBoss EAP 6 中丢弃了对 Seam 2.2 应用程序的官方支持，但仍可以配置 Seam 2.2 应用程序的依赖项，以便在该版本上运行。JBoss EAP 7.4（现在包含 Jakarta Server Faces 2.3 和 Hibernate 5.3）由于 Red Hat JBoss Web Framework Kit 的生命周期结束，所以不支持 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 集成更改的详情，请参考本指南中的以下部分。

Transactions

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

JBoss EAP 6 中的 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。如需所需更新，请参见本指南中的以下部分。