跳到主要内容

支持的环境

PubSub+ 消息 API for JMS 与处于活动支持状态且具有安全更新支持的任何版本的 Oracle JDK 或 OpenJDK 兼容。有关支持版本的信息，请参阅 Oracle Java SE 支持路线图。

从 10.20 版本开始，PubSub+ 消息 API for JMS 依赖于 JMS 2.0。要了解：

  • JMS 2.0 依赖对 PubSub+ JMS API 的影响，请参阅 PubSub+ 消息 API for JMS 和 JMS 规范 2.0。

  • 如何支持需要与 Geronimo JMS 1.1 向后兼容或无法使用 JMS 2.0 的应用程序，请参阅对 Geronimo JMS 1.1 的支持。

  • 如何使用带有 jakarta.jms 命名空间的 PubSub+ JMS API，请参阅 PubSub+ 消息 API for Jakarta Messaging。

PubSub+消息API for JMS和JMS规范2.0​

从 10.20 版本开始，PubSub+ 消息 API for JMS 依赖于 JMS 2.0。这种依赖关系使得与当前及未来的 JMS 版本兼容成为可能。Solace 目前尚未为 JMS 2.0 中引入的任何方法或接口提供实现。您必须继续在应用程序中使用 JMS 1.1 的方法和接口。如果您在构建应用程序时使用 Maven 或 Gradle，它会自动下载 Geronimo JMS 2.0 jar 文件，您无需进行任何其他更改。如果您不使用具有依赖项管理功能的构建工具，则需要手动将 Geronimo JMS 2.0 jar 文件添加到您的项目中。您可以从 Maven Central 的 Apache Geronimo JMS 规范 2.0 处下载该文件。

如果您使用 Karaf 框架版本 4.1 及更早版本使用 PubSub+ JMS API，则必须将 geronimo-jms_2.0_spec-1.0-alpha-2.jar 文件放入您的 deploy 文件夹中以加载 JMS API。如果您使用 Karaf 框架（版本 4.2 及更高版本），则无需在您的 deploy 文件夹中进行更改，因为它包含 JMS 2.0。

对Geronimo JMS 1.1的支持​

对于 10.20 及更高版本，您需要使用 Solace JMS 兼容层，以便与必须包含 Geronimo JMS 1.1 依赖项（geronimo-jms_1.1_spec）的应用程序或无法使用 JMS 2.0 的应用程序实现向后兼容。如果您使用 Maven 构建项目，则必须添加依赖项，详情请参阅使用 Maven 构建 JMS 项目。如果您不使用 Maven，请将 Solace JMS 兼容层（sol-jms-compat-1.1）添加到项目的 CLASSPATH 中，您可以从我们的 Maven Central 仓库的 PubSub+ 兼容层 For Apache Geronimo JMS 规范 1.1 处下载。

PubSub+消息API for Jakarta Messaging​

版本 10.26 的 PubSub+ 消息 API for Jakarta Messaging 支持 jakarta.jms API 命名空间。这使得您的应用程序能够利用 Spring 6.0 版本的功能。有关 Spring 6.0 版本的信息，请参阅他们的文档页面 Spring Framework Documentation。

要使用 PubSub+ 消息 API for Jakarta Messaging：

  1. 在您的 Maven 项目的依赖项中包含 sol-jms-jakarta 工件 ID。这将自动使用 Jakarta JMS API 的 3.1.0 版本。您也可以从 Maven Central 仓库的 SolacePubSub+ 消息 API For Jakarta Messaging 处下载该工件。

  2. 在您的应用程序代码中，您需要将所有使用 javax.jms.* 的 import 语句替换为 jakarta.jms.*。

    • 例如，将错误的语句：

      import javax.jms.Message;

    • 替换为适用于 Jakarta JMS 命名空间的正确 import 语句：

      import jakarta.jms.Message;

  3. （可选）要将您的应用程序升级为使用 Spring Boot 3.0 及更高版本，您还需要将 Solace Spring Boot Starter 作为依赖项添加到您的应用程序中。添加此依赖项会自动导入 sol-jms-jakarta，您可以在 Solace Spring Boot Starter JMS 处下载该工件。有关升级到 Spring Boot 3.0 版本的信息，请参阅 Preparing for Spring Boot 3.0。有关如何使用 Spring Boot 自动配置与 PubSub+ JMS API，请参阅 Solace GitHub 页面上的 Spring Boot 自动配置 for Solace JMS。

PubSub+ 消息 API for Jakarta Messaging 不能与低于 6.0.0（或其候选版本）的 Spring 版本以及低于 3.0.0（或其候选版本）的 Spring Boot 版本一起使用。