通过 JMS 传输的文档所需的组件

为使 WebSphere Partner Gateway 能通过 JMS 传输协议与 InterChange Server 通信,必须配置一些组件以使用 JMS。表 51 总结了这些配置步骤。

表 51. 配置使用 JMS 传输协议的 WebSphere Partner Gateway 和 InterChange Server
组件 版本 了解更多信息
WebSphere Partner Gateway 6.0

通过 JMS 传输协议将文档发送到 ICS 的配置

通过 JMS 传输协议从 ICS 接收文档的配置

WebSphere InterChange Server 4.2.2, 4.3 创建 JMS 的 ICS 构件

另外,要在 WebSphere Partner Gateway 和 InterChange Server 之间通过 JMS 传输协议发送或接收文档,还要使用表 52中列出的组件。

表 52. 通过 JMS 与 InterChange Server 传输文档所需的组件
组件 描述 注意事项和限制

WebSphere Business Integration Adapter for JMS

(JMS 适配器)

该适配器允许 InterChange Server 与发送或接收 JMS 消息形式数据的应用程序交换业务对象。Adapter for JMS 和 WebSphere Partner Gateway 通过 JMS 队列通信。

请确保使用 Adapter for JMS V2.7.0(或更高版本),它提供了对定制头属性的支持。请参阅该适配器的文档,以确保适配器版本与正在使用的 InterChange Server 版本相兼容。

有效内容数据处理程序 该数据处理程序在文档有效内容的文档格式及其业务对象表示之间进行转换。 要了解更多信息,请参阅指定有效内容数据处理程序
附件数据处理程序

该数据处理程序把带有附件的文档转换成业务对象。

当文档包括附件时,才需要该数据处理程序。要了解更多信息,请参阅处理带附件的文档

下面几部分描述了表 52中的组件是如何协作以通过 JMS 传输协议在 WebSphere Partner Gateway 和 InterChange Server 之间收发文档。

如何通过 JMS 传输发送文档

要使 WebSphere Partner Gateway 使用 JMS 传输协议将文档发送给 InterChange Server,请使用 Adapter for JMS 检索 WebSphere Partner Gateway 放入 JMS 队列中的消息。然后,适配器会将消息路由至 InterChange Server。图 22提供了 WebSphere Partner Gateway 如何通过 JMS 传输协议将文档发送到 InterChange Server 的概述。

图 22. 通过 JMS 传输协议从 WebSphere Partner Gateway 到协作的消息流
本图显示了一个文档被如何发送到 WebSphere Partner Gateway,WebSphere Partner Gateway 如何将 JMS 消息发送到 Adapter for JMS 的入站队列,Adapter for JMS 如何调用有效内容数据处理程序,以及 Adapter for JMS 如何将产生的业务对象发送到协作。

下列步骤描述了 WebSphere Partner Gateway 如何通过 JMS 传输协议将文档发送到 InterChange Server 内的协作,来参与事件通知。

  1. WebSphere Partner Gateway 将消息发布到 JMS 出站队列信息。

    如果文档的封装类型是后端集成,那么 WebSphere Partner Gateway 已在该消息中提供了定制属性。用有效内容的内容类型设置 JMS 消息头 JMSType。

    注: 在 WebSphere Partner Gateway 中,您必须配置 一个网关,该网关标识 WebSphere Partner Gateway 发送消息的目标 JMS 队列,Adapter for JMS 也将在该队列上进行轮询。
  2. 当 Adapter for JMS 在其任何一个输入队列上看到消息时,它就检索该消息。

    WebSphere Partner Gateway 用作出站队列的 JMS 队列就是 Adapter for JMS 使用的输入队列。 有关如何创建这个队列的信息,请参阅配置 JMS 队列。有关 Adapter for JMS 处理的详细信息,请参阅 Adapter for JMS 用户指南

  3. Adapter for JMS 将消息移到其正在处理的队列中。
  4. Adapter for JMS 抽取 JMS 消息的主体,并根据该消息主体调用数据处理程序。 该数据处理程序将 JMS 消息主体转换成业务对象。
    注: 如果消息有附件,则安装附件数据处理程序,然后配置 Adapter for JMS 使之能调用该数据处理程序,以便将 JMS 信息的主体转换成业务对象。要了解更多信息,请参阅处理带附件的文档

    当“后端集成”是封装类型且文档包含附件时,已配置的数据处理程序负责处理有效内容和附件。

  5. 数据处理程序将业务对象返回给 Adapter for JMS。
    注: 如果使用附件数据处理程序,则这个业务对象包含有效内容和附件。
  6. 如果 Adapter for JMS 找到子代动态元对象(使用特定于应用程序的业务对象级信息的 cw_mo_conn 指定),那么该适配器用 JMS 消息中的头填充业务对象中用户定义的 JMS 头。
  7. Adapter for JMS 将业务对象传递给 InterChange Server,将其作为预订传递的一部分。

如何通过 JMS 传输接收文档

要使 WebSphere Partner Gateway 能使用 JMS 传输协议从 InterChange Server 接收文档,请使用 Adapter for JMS,它把从 InterChange Server 收到的消息放置在 WebSphere Partner Gateway 的 JMS 队列中以供检索。图 23提供了 WebSphere Partner Gateway 如何通过 JMS 传输协议从 InterChange Server 接收文档的概述。

图 23. 通过 JMS 传输协议从协作到 WebSphere Partner Gateway 的消息流
本图显示了如何将一个业务对象从协作发送到 Adapter for JMS,Adapter for JMS 如何调用有效内容数据处理程序,以及 Adapter for JMS 如何将结果 JMS 消息发送到出站队列(WebSphere Partner Gateway 从该出站队列检索获取 JMS 信息)。

下列步骤描述了 WebSphere Partner Gateway 如何通过使用 JMS 传输协议接收来自 InterChange Server 中协作的文档,来参与请求处理。

  1. InterChange Server 内的协作对 Adapter for JMS 进行服务调用,向它发送请求业务对象。

    请求业务对象包含了特定于应用程序的信息,该信息指向包含 JMS 传输级头信息(该信息是 WebSphere Partner Gateway 所需的)的动态元对象。

  2. Adapter for JMS 使用数据处理程序将由协作发送的业务对象转换成 JMS 消息。

    该适配器读取 DataHandlerMimeTypeDataHandlerConfigMO 属性以确定要使用的数据处理程序。要了解更多信息,请参阅指定有效内容数据处理程序

    注: 如果文档有附件,则安装附件数据处理程序,然后配置 Adapter for JMS 使之能调用该数据处理程序,以便将请求业务对象转换成带附件的文档。要了解更多信息,请参阅处理带附件的文档
  3. 数据处理程序将业务对象转换成字符串,然后将它返回给 Adapter for JMS。
  4. Adapter for JMS 根据请求业务对象确定定制 JMS 属性的动态元对象的名称。

    适配器在请求业务对象的特定于应用程序信息中搜索 cw_mo_conn 标记,该标记标识包含动态元对象的属性。 如果您对文档使用后端集成封装方式,那么可以在这个动态元对象中指定传输级头信息。

  5. Adapter for JMS 搜索动态元对象以查找 JMSProperties 属性。

    如果已填入该属性,那么适配器在请求文档中设置传输级的头。在 JMSProperties 属性内,还可以指定 content-type 标准 JMS 头。要了解更多信息,请参阅创建 JMS 头信息

  6. Adapter for JMS 通过使用由数据处理程序返回的字符串来创建 JMS 消息。 它还设置动态元对象中所定义的任何定制属性。
  7. Adapter for JMS 将产生的请求消息发送给输出队列。

    可以在静态元对象或动态元对象中指定队列。 有关指定队列的信息,请参阅标识 JMS 队列。WebSphere Partner Gateway 侦听该 JMS 队列,该队列被配置成 WebSphere Partner Gateway 目标定义中的入站队列。

  8. WebSphere Partner Gateway 从它的 JMS 入站队列接收该消息,正如其目标中配置的。

注: WebSphere Partner Gateway 只支持通过 JMS 与 InterChange Server 进行异步交互。因此,可能不需要等待响应。来自社区参与者或 WebSphere Partner Gateway 的响应可以来自不同队列。可以配置 Adapter for JMS 来轮询该队列。可以将来自队列的响应作为事件传递的一部分传递到 InterChange Server。

Copyright IBM Corp. 2003, 2005