创建 JMS 侦听器

本节介绍如何创建基于 Java 消息服务 (JMS) 的侦听器。

假设

假设下述条件成立：

  • JMS 侦听器可以支持以下 JMS 服务器：
    • IBM WebSphere Application Server (WAS) 6.0 或更新版本
      • WAS 管理员已经创建了服务集成总线 (SIB) 和一个或多个 SIB 队列。
    • IBM WebSphere MQ 6.0 或更新版本
      • WebSphere MQ 管理员已经配置了一个或多个 WebSphereMQ 队列。
    • SAP NetWeaver Application Server 7.1
      • 应用程序服务器管理员已经配置了多个队列之一。
  • 已检查有关 Enabling SAP JMS NetWeaver support（启用 SAP JMS NetWeaver 支持）的信息，并且所需的 SAP JMS NetWeaver 支持 jar 文件已添加至暂存浏览器 /system/jars 文件夹中。
  • 常规 JMS 配置主题：
    • 可使用完全限定的域名（WebSphere - SIB Direct 或 WebSphere - WMQ 无需此名称）在网络上访问 JMS 服务器。
    • 将该节点配置为访问有效的域名解析服务器以解析主机名。对于某些产品，使用节点的操作系统工具定义域名解析服务器。对于其他产品，使用 System Administration（系统管理）> Network Configuration（网络配置）选项卡定义域名解析服务器（访问 WebSphere - SIB Direct 或 WebSphere - WMQ 无需此项）。
    • 管理员已创建 JMS 队列连接工厂、用于请求的 JMS 队列以及一个可选的用于答复的 JMS 队列。
    • 管理员已在服务器的 JNDI 命名空间中注册了队列连接工厂和队列，并在适用的情况下为您提供了这些注册名称。

可用性

由于平台限制，以下企业网关产品不支持指示的 JMS 服务器。

  • MESInterface IT
    • NetWeaver
  • 用于 Siemens ERPC 的 deviceWISE 企业网关
    • WebSphere - SIB
    • NetWeaver

流程

要创建 JMS 侦听器，请按照以下步骤操作：

  1. 在工作台左侧窗格中，展开要将侦听器添加到的节点。
  2. 展开 Enterprise（企业），右键单击 Listeners（侦听器）图标以显示其弹出菜单，然后单击 New（新建）。
    随即显示 Listener（侦听器）窗口。
  3. 使用 Name（名称）框，键入侦听器的唯一名称。名称长度最多为 64 个字符，可以包括字母、数字和下划线字符。不允许使用空格。
  4. 单击 Listener Type（侦听器类型）向下箭头，然后选择 JMS。

参数选项卡

更改 Parameters（参数）选项卡以适应 JMS SIB 侦听器的参数。预计您将从 WebSphere Application Server (WAS) 管理员那里获取信息，以便正确填写参数值。下面介绍创建 JMS SIB 侦听器的连接参数。

参数 描述
JMS Provider（JMS 提供商） 单击向下箭头以指定 JMS 提供商。

WebSphere - SIB：此项将要求您分别在 Queue Factory（队列工厂）和 Queue Name（队列名称）字段中指定队列连接工厂 (QCF) 和队列的 JNDI 注册名称。还必须指定 SIB 消息接入点。
WebSphere - SIB Direct：此项将要求您指定 Bus Name（总线名称）和 Queue Name（队列名称）参数以及 SIB 消息接入点的值。直接访问目标队列，而无需执行 JNDI 查找。
以下选项无需指定 SIB 平台接入点的规范，因此如果选择 Endpoint Information（平台接入点信息）字段，它们将被隐藏：
NetWeaver：此项将要求您分别在 Queue Factory（队列工厂）和 Queue Name（队列名称）字段中指定队列连接工厂 (QCF) 和队列的 JNDI 注册名称。
WebSphere - WMQ：使用此项访问作为 JMS 目标的 WebSphere WMQ 队列。此项要求您指定目标 WebSphere MQ 队列的队列名称。
Host（主机） 指定 JMS 服务器的主机名或 IP 地址。此信息将由您的应用服务器管理员提供。
Port（端口） 指定已配置 JMS 服务器 JNDI 服务（如果适用）或 JMS 服务器侦听的 TCP/IP 端口标识符。此信息将由您的应用服务器管理员提供。
Queue Factory（队列工厂） 指定队列连接工厂的 JNDI 注册名称。此信息将由您的应用服务器管理员提供。
Bus Name（总线名称） 仅适用于 WebSphere - SIBDirect。此项为 WAS 管理员已配置为来自节点的 SIB 请求的平台接入点的 WebSphere SIB 总线名称。此信息将由您的 WAS 管理员提供。
Queue Name（队列名称） 指定命令队列的 JNDI 注册名称。侦听器将从此队列中读取请求。命令队列信息将由您的应用服务器管理员提供。
Manager（管理器） 仅适用于 WebSphere - WMQ。此项为 WebSphere MQ 管理器名称。此项将由您的 WebSphere MQ 管理员提供。
Channel（信道） 仅适用于 WebSphere - WMQ。此项为 WebSphere MQ 信道名称。此项将由您的 WebSphere MQ 管理员提供。
User（用户） 指定将用于访问 JMS 服务器的用户 ID。此信息将由您的应用服务器管理员提供。"WebSphere - MQ" 所必需。
Password（密码） 指定与上一字段中指定的用户 ID 相关联的密码。此信息将由您的应用服务器管理员提供。"WebSphere - MQ" 所必需。
Correlation ID（关联 ID） 关联 ID 值使您可以从队列中获取特定消息。侦听器将仅接受包含关联 ID 值的消息。
Extended Attributes（扩展静态属性） 单击此按钮以显示 JMS Header Properties（JMS 标头测量值）参数。该参数将替代一些默认的 JMS 标头静态属性，例如回复消息上的持久性、优先级和过期时间。通常，将这些静态属性设置为 JMS 请求标头中收到的值。有关更多信息，请参见 JMS 侦听器的扩展静态属性。
Endpoints（平台接入点） 仅当您选择 WebSphere - SIB 或 WebSphere - SIB Direct 作为 JMS 提供商时，此字段集才可见。
Host（主机） 此项为 WebSphere SIB 安装的主机名或 IP 地址。此信息将由您的 WAS 管理员提供。
Port（端口） 此项为 WebSphere SIB 平台接入点服务正在侦听的 TCP/IP 端口标识符。此信息将由您的 WAS 管理员提供。
Defined Hosts（定义的主机） 此项成为建立连接的平台接入点。您可以根据需要添加任意数量的连接接入点。
输入主机名或 IP 地址和端口号后，单击 Add（添加）。平台接入点主机和端口的组合随即添加至 Defined Hosts（定义的主机）框中。例如：sib-node01.acme.com:7276
Controlled Listener（受控侦听器） 选中此复选框，可使侦听器受获取来自受控侦听器的消息动作的控制。

获取来自受控侦听器的消息动作确定侦听器何时应从远程队列获取下一个请求。Controlled Listener（受控侦听器）复选框与 Delay (seconds)（延迟（秒））参数（下一个）结合使用。
Delay (seconds)（延迟（秒）） 与 Controlled Listener（受控侦听器）参数（上一个）配合使用。
侦听器接收到来自获取来自受控侦听器的消息动作的请求后，检查远程队列中是否有下一个请求。如果没有可用的请求，则侦听器将等待 Delay (seconds)（延迟（秒））中指定的秒数。如果请求失败，则向获取来自受控侦听器的消息动作返回一个值，指示超时。有关更多信息，请参见创建受控侦听器。
Reply（回复） 选中复选框以指示回复队列。

节点将所有响应加入此队列中。但是，如果企业应用程序指定不同的回复队列，则回复队列将替代此处指定的回复队列。回复队列信息将由您的 WAS 管理员提供。
相关主题

侦听器有效负载选项卡

侦听器映射日志选项卡

JMS 侦听器的扩展静态属性