红帽全球峰会第 32 章 后向和转发兼容性
JBoss EAP 支持与将 HornetQ 用作消息传递代理（如 JBoss EAP 6）的传统 JBoss EAP 版本向后兼容。这两种兼容性模式由 JBoss EAP 内置消息传递服务器 ActiveMQ Artemis 提供，其支持 HornetQ 的核心协议。
32.1. forward Compatibility
向前兼容性不需要对旧版 JBoss EAP 6 Jakarta 消息传递客户端的代码更改。JBoss EAP messaging-activemq 子系统及其资源提供支持。为了支持向前兼容性，需要对 JBoss EAP 7 服务器的配置进行以下更改：每个步骤都提供了单机服务器的管理 CLI 命令示例：
创建
socket-binding，侦听远程传统客户端的端口 4447。/socket-binding-group=standard-sockets/socket-binding=legacy-remoting:add(port=4447)创建一个传统的
remote-connector，它将使用上一步中创建的socket-binding。JNDI 查找需要此项。/subsystem=remoting/connector=legacy-remoting-connector:add(socket-binding=legacy-remoting)设置一个传统的消息传递
套接字绑定，侦听端口 5445。/socket-binding-group=standard-sockets/socket-binding=legacy-messaging:add(port=5445)在
messaging，该子系统使用上一步中的绑定。-activemq 子系统中设置acceptorremote-connector和 remote-/subsystem=messaging-activemq/server=default/remote-connector=legacy-messaging-connector:add(socket-binding=legacy-messaging) /subsystem=messaging-activemq/server=default/remote-acceptor=legacy-messaging-acceptor:add(socket-binding=legacy-messaging)在 messaging-
activemq子系统的legacy-connection-factory元素中创建传统的 HornetQ Jakarta Messaging ConnectionFactory。/subsystem=messaging-activemq/server=default/legacy-connection-factory=legacy-discovery:add(entries=[java:jboss/exported/jms/LegacyRemoteConnectionFactory], connectors=[legacy-messaging-connector])创建传统的 HornetQ Jakarta 消息目的地，并将
legacy-entries属性包含在jms-queue或jms-topic资源。jms-queue add --queue-address=myQueue --entries=[java:jboss/exported/jms/myQueue-new] --legacy-entries=[java:jboss/exported/jms/myQueue] jms-topic add --topic-address=myTopic --entries=[java:jboss/exported/jms/myTopic-new] --legacy-entries=[java:jboss/exported/jms/myTopic]您可以按照以下示例所示，在现有队列或主题中添加
legacy-entries。/subsystem=messaging-activemq/server=default/jms-queue=myQueue:write-attribute(name=legacy-entries,value=[java:jboss/exported/jms/myQueue])虽然这些
条目属性由 JBoss EAP 消息 Jakarta 消息传递客户端使用，但legacy-entries供旧版 HornetQ Jakarta 消息传递客户端使用。旧版 Jakarta 消息传递客户端查找此传统的 Jakarta 消息传递资源，以便与 JBoss EAP 7 通信。注意为避免旧版 Jakarta 消息传递客户端中任何代码更改，
messaging-activemq子系统中配置的旧 JNDI 条目必须与传统的 Jakarta 消息传递客户端预期的查找相匹配。
管理 CLI 迁移操作
当您运行管理 CLI 迁移 操作以更新 消息传递 子系统配置时，如果布尔值参数 add-legacy-entries 设为 true，delay -activemq 子系统会创建 legacy-connection-factory 资源，并将 legacy-entries 添加到 jms-queue 和 jms-topic 资源。迁移的 messaging-activemq 子系统中的传统条目将与传统 消息传递 子系统中指定的条目对应，而常规条目则使用 -new 后缀创建。
如果在运行 迁移 操作时将布尔值参数 add-legacy-entries 设置为 false，则 messaging-activemq 子系统中不会创建传统资源，并且传统的 Jakarta 消息传递客户端将无法与 JBoss EAP 7 服务器通信。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}