设置 JMS 传输的环境
因为与 InterChange Server 相互接发文档涉及 JMS 队列和 Adapter for JMS,所以您必须执行表 53中所描述的安装和配置任务。有关如何配置 WebSphere Partner Gateway 以便通过 JMS 与 InterChange
Server 一起使用的信息,请参阅为 InterChange Server 配置 WebSphere Partner Gateway。
注: 如果文档中包含附件,您还必须安装和配置附件数据处理程序。要了解更多信息,请参阅处理带附件的文档。
配置 JMS 队列
为了和 InterChange Server 一起使用 JMS 传输协议,必须安装 WebSphere MQ 提供的 JMS 系统。InterChange Server 受支持的版本使用 WebSphere MQ V5.3 作为 JMS 提供程序。您可以使用中心配置指南中的步骤来设置 JMS 传输协议机制。
请注意: 中心配置指南中的步骤必须在 WebSphere Partner Gateway 驻留的计算机上执行。 本指南假定
Adapter for JMS 和 InterChange Server 所需的 JMS 传输机制已经作为 InterChange Server 安装的一部分被安装。
当创建供 WebSphere Partner Gateway 和 InterChange Server 之间使用的 JMS 队列时,请考虑以下几点:
- InterChange Server 安装过程包含了 WebSphere MQ 队列管理器的创建。您可以将该队列管理器与 WebSphere Partner Gateway 一起使用。
- 当创建 JMS 队列别名时,您可能希望将它们命名为能指明 WebSphere Partner Gateway 和 InterChange Server 之间流方向的名称。例如,如果创建表 54 的 原始队列名 列中列出的队列,可以将这些队列重命名,以表明 InterChange Server 的方向流,就如同 表 54 的 方向队列名 列中显示的一样。
表 54. 命名为 JMS 队列以反映 InterChange Server 方向性
初始队列名称 |
定向队列名称 |
inQ |
ICS2HUB |
outQ |
HUB2ICS |
配置 Adapter for JMS
Adapter for JMS 允许 WebSphere Partner Gateway 以 JMS 消息的格式与 InterChange Server 交换文档。它支持与 InterChange Server 进行下列交互:
- 对于请求处理,它接收来自InterChange Server 的业务对象,然后将其转换为 JMS
消息(使用数据处理程序),并将该 JMS 消息放入 JMS
队列(请参阅图 23),然后 WebSphere Partner Gateway 可以在该队列上获取该消息。
- 对于事件通知,它轮询 JMS 队列以查找来自 WebSphere Partner Gateway 的 JMS 消息。当它找到一个 JMS 消息时,
就把它转换成事件业务对象(使用数据处理程序)并把它发送给 InterChange Server。
请注意: WebSphere Partner Gateway 不包括 WebSphere Business Integration Adapter
for JMS。 您必须单独获取该产品,并根据其 Adapter for JMS 用户指南中的指示说明来安装它。请阅读本指南中描述的步骤以正确地安装和配置 Adapter for JMS,这一点非常重要。
当您配置了 Adapter for JMS,使之可以与 InterChange Server 进行通信时,请执行本部分中的步骤来配置这个适配器,以接受来自 WebSphere Partner Gateway 的 JMS 消息。
指定有效内容数据处理程序
如图 23 所示,Adapter for JMS
使用数据处理程序将接收来自 InterChange Server 的业务对象转换成相应的 JMS 消息。
注: Adapter for JMS 调用的数据处理程序转换文档的有效内容。如果您的文档包装在 XML
传输封包(该封包包含附件或者“封包标志”是“是”),将附件数据处理程序配置成有效内容数据处理程序。要了解更多信息,请参阅处理带附件的文档。
要指出使用哪种数据处理程序来转换有效内容,必须采取业务对象变换中列出的步骤。另外,必须配置 Adapter for JMS 以使用该有效内容数据处理程序。在“连接器配置器”中,请采取以下步骤:
- 设置下列连接器配置属性以标识有效内容数据处理程序:
- 用顶级数据处理程序元对象和受支持的 MIME 类型的名称分别设置 DataHandlerConfigMO 和 DataHandlerMimeType 属性。
- 使用数据处理程序类的名称来设置 DataHandlerClassName 属性,以进行实例化。
注: 可以设置 DataHandlerConfigMO 与 DataHandlerMimeType 属性,也可以设置 DataHandlerClassName 属性。
- 在受支持的业务对象列表中包含了顶级数据处理程序元对象。
您也可以在静态或动态元对象里指定要使用的数据处理程序。在这些元对象里,相同的特性(DataHandlerMimeType,DataHandlerConfigMO 和 DataHandlerClassName)可作为属性使用。有关完整的描述,请参阅 Adapter for JMS 用户指南。
标识 JMS 队列
当 Adapter for JMS 接收到来自 InterChange
Server 的文档时,它将该消息放在 WebSphere Partner Gateway“接收器”正轮询的出站队列中。类似地,当 WebSphere Partner Gateway 向 InterChange Server 发送文档时,它将文档放到它的出站队列里,该队列也就是
Adapter for JMS 要轮询的队列。
表 55 总结了如何配置 Adapter for JMS 用来接收和发送文档的 JMS 队列。
注: 有关如何配置 JMS 队列的完整描述,请参阅 Adapter for JMS 用户指南。
表 55. JMS 队列
JMS 队列 |
配置设置 |
输入队列 |
将InputDestination 连接器配置属性设置为 JMS 队列名,Adapter for JMS 将轮询该队列以查找入站消息。
请确保该队列的名称和 WebSphere Partner Gateway 用作 JMS 出站队列的名称一样。如果没有在 InputDestination 中指定该队列,Adapter for JMS 将不轮询该队列。
注: InputDestination 属性包含一个用逗号分隔的输入队列列表。
如果 Adapter for JMS 轮询多个队列,那么请确保该列表包含 WebSphere Partner Gateway 用作 JMS 出站队列的 JMS 队列名。 |
输出队列 |
在运行时,协作可以将动态元对象中的 OutputQueue 属性动态地设置成 JMS 队列名,Adapter for
JMS 使用该队列发送出站消息。 |
您必须确保配置了静态或动态元对象,从而可以将它们写到 WebSphere
Partner Gateway 目标正在侦听的队列。
