WebSphere Business Integration Connect 可以通过 HTTP 传输协议向 V4.2.2 WebSphere InterChange Server(ICS)发送文档和从其接收文档。
注:
本节提供了有关如何配置 V4.2.2 InterChange Server 和相关兼容 ICS 的组件以与通过 HTTP 传输文档的 Business Integration Connect 一起使用的下列信息:
要使 Business Integration Connect能使用 HTTP 传输协议与 V4.2.2 InterChange Server 进行通信,需要配置这两个组件。表 60 中概括了这些配置步骤。
表 60. 配置 Business Integration Connect 和 InterChange Server
组件 | 版本 | 了解更多信息 |
---|---|---|
WebSphere Business Integration Connect | 4.2.2 |
|
WebSphere InterChange Server | 4.2.2 | 创建用于 HTTP 的 V4.2.2 ICS 构件 |
另外,为了使用 HTTP 传输协议在 Business Integration Connect 和 V4.2.2 InterChange Server 之间收发文档,您可以使用表 61 中列出的兼容 ICS 的组件。
表 61. 通过 HTTP 使用 V4.2.2 InterChange Server 传送文档所需的组件
下面几节描述了表 61 中的组件是如何协作以通过 HTTP 传输协议在 Business Integration Connect 和 V4.2.2 InterChange Server 之间发送和接收文档。
要使 Business Integration Connect 能使用 HTTP 传输协议将文档发送到 V4.2.2 InterChange Server,可以使用 Adapter for HTTP 检索 Business Integration Connect 以 HTTP 流发送的文档。 该适配器然后将文档路由到 InterChange Server。图 16 概述了 Business Integration Connect 如何通过 HTTP 传输协议将文档发送到 V4.2.2 InterChange Server。
图 16. 通过 HTTP 传输协议从 Business Integration Connect 到协作的消息流
要使 Business Integration Connect 使用 HTTP 传输协议接收来自 V4.2.2 InterChange Server 的文档。使用 Adapter for HTTP,它以 HTTP 流的形式发送和接收自 InterChange Server 的消息,以供 Business Integration Connect 检索。图 17 概述了 Business Integration Connect 如何使用 HTTP 传输协议接收来自 V4.2.2 InterChange Server 的文档。
图 17. 通过 HTTP 传输协议从协作到 Business Integration Connect 的消息流
因为无论是将文档发送到 InterChange Server 还是接收来自 InterChange Server 的文档都要使用兼容 ICS 的组件,所以您必须对 Adapter for HTTP 执行设置和配置任务。有关如何配置 Business Integration Connect 以与通过 HTTP 传递文档的 InterChange Server 一起使用的信息,请参阅为 InterChange Server 配置 Business Integration Connect。
Adapter for HTTP 是兼容 ICS 的组件,该组件允许 Business Integration Connect 与 InterChange Server 以 HTTP 消息的格式进行文档交换。 它支持与 InterChange Server 进行下列交互:
当您已配置好用以与 InterChange Server 通信的 Adapter for HTTP 时,请遵循下面几节中的步骤来配置该适配器,以侦听来自 Business Integration Connect 的 HTTP 消息:
如图 17 所示,Adapter for HTTP 使用数据处理程序将接收自 InterChange Server 的业务对象转换成相应的 HTTP 流。
要指出使用哪个数据处理程序来转换有效负载,您必须采取业务对象变换中列出的步骤。另外,必须配置 Adapter for HTTP 以使用该有效负载数据处理程序。您可以以下列任一方式设置有效负载数据处理程序:
Adapter for HTTP 使用 JavaProtocolHandlerPackages 连接器配置属性来标识 Java 协议处理程序包的名称。为与 Business Integration Connect 集成,确保将 JavaProtocolHandlerPackage 的属性设置成其缺省值:
com.ibm.net.ssl.internal.www.protocol
Adapter for HTTP 支持层次结构性的配置属性以获取配置其协议侦听器所需的信息。顶级配置属性称为 ProtocolListenerFramework。该顶级属性内存在多个级别的子属性。 要配置这里的协议处理程序以和 Adapter for HTTP 一起使用,确保按照以下步骤配置 ProtocolListener 中的属性:
ProtocolListenerFramework ProtocolListeners HttpListener1
要配置协议侦听器,请设置表 62 中列出的子属性。
属性 | 描述 | 值 |
---|---|---|
协议 |
协议侦听器类型:
|
http 或 https
|
主机 | 协议侦听器侦听的 IP 地址 | WebSphere Business Integration Connect 在其上运行的本地机器的 IP 地址 |
端口 | 协议侦听器侦听请求的端口 | 8080 |
ProtocolListenerFramework ProtocolListeners HttpListener1 URLsConfiguration URL1
将 ContextPath 属性设置成协议侦听器接收到的 HTTP 请求的 URI。
ProtocolListenerFramework ProtocolListeners HttpListener1 URLsConfiguration URL1 TransformationRules TransformationRule1
要配置您协议侦听器的附件转换,请设置表 63 列出的子属性。对于您所使用的每个附件数据处理程序的实例,都需要一个转换规则。有关附件数据处理程序的更多信息,请参阅处理带附件的文档。
属性 | 描述 | 值 |
---|---|---|
ContentType | 要使用数据处理程序转换的数据的内容类型 | 附件数据相关的内容类型 |
MimeType | 用来标识调用的数据处理程序的 MIME 类型 | 与附件数据处理程序实例相关的 MIME 类型 |
Charset | 转换指定内容类型的数据时使用的字符集 | 附件数据字符集 |
有关这些属性的更多信息,请参阅 Adapter for HTTP 用户指南。
Adapter for HTTP 以有效负载业务对象的形式将文档发送到 InterChange Server 以及从其接收文档。当收到或发送 Business Integration Connect 文档时,Adapter for HTTP 调用有效负载数据处理程序来处理该业务对象,如下所述:
因此,您必须创建如表 64 所示的业务对象定义,以表示 Adapter for HTTP 所期望的有效负载业务对象结构。
表 64. Adapter for HTTP 的业务对象定义
条件 | 业务对象定义 | 了解更多信息 |
---|---|---|
如果对您的消息 使用 且您的文档没有附件 |
有效负载业务对象:
| 为通过 HTTP 传递文档的 V4.2.2 ICS 创建有效负载业务对象结构 |
如果您对您的消息使用后端集成封装 |
将业务对象添加到有效负载业务对象以保存消息头信息:
| 为 V4.2.2 ICS 创建 HTTP 传输级头信息. |
如果文档包含附件 | 还必须创建其它业务对象来表示这些附件。 | 创建与附件关联的业务对象定义 |
Adapter for HTTP 期望有效负载业务对象由以下业务对象组成:
图 18 显示了用于 V4.2.2 InterChange Server(通过 HTTP 传输文档)的有效负载业务对象定义的样本业务对象结构。
图 18. V4.2.2 ICS 的 HTTP 有效负载业务对象的业务对象结构
顶级业务对象是请求和响应业务对象的包装器。您必须为该业务对象创建业务对象定义。表 57 汇总了顶级业务对象定义的属性。
属性 | 属性类型 | 描述 |
---|---|---|
MimeType | 字符串 |
定义了被传递给 URL 的数据的内容类型和格式。
|
Charset | 字符串 |
用于确定要调用哪个数据处理程序。
|
请求 | 业务对象 | 表示请求消息的子 业务对象。该业务对象的用途取决于它是参与请求处理还是参与事件通知。要了解关于该业务对象结构的更多信息,请参阅请求业务对象。 |
响应 | 业务对象 | 表示请求消息的子 业务对象(如果您期望获得响应)。该业务对象的用途取决于它是参与请求处理还是参与事件通知。要了解关于该业务对象结构的更多信息,请参阅响应业务对象。 |
表 66 汇总了顶级业务对象定义可以拥有的特定于应用程序的信息。
特定于应用程序的信息 | 标记 | 描述 |
---|---|---|
业务对象级别 | ws_mode | 定义交互是同步的还是异步的 |
属性级别 | ws_botype | 定义哪个属性包含请求业务对象或响应业务对象 |
要了解有关顶级业务对象结构及其特定于应用程序信息的完整描述,请参阅 Adapter for HTTP 用户指南。
请求业务对象包含了要传递到 URL 的数据。它表示了 HTTP 请求消息。该请求业务对象的用途取决于它参与以下哪个 InterChange Server 任务:
有关请求业务对象结构的基本描述,请参阅 Adapter for HTTP 用户指南。 要和 Business Integration Connect 一起使用,必须对请求业务对象定义的结构进行两个定制操作:
该属性提供了有关消息的传输级头的配置信息。要了解更多信息,请参阅为 V4.2.2 ICS 创建 HTTP 传输级头信息。
特定于应用程序的信息的标记 | 描述 | 是否必需? |
---|---|---|
ws_tloname | 给顶级业务对象取名 | 只有当业务对象定义参与事件通知时该标记才是必需 |
cw_mo_http | 指定 HTTP 协议配置元对象,该元对象包含了 HTTP 传输级头字段。要了解更多信息,请参阅为 V4.2.2 ICS 创建 HTTP 传输级头信息。 | 只有当您使用后端集成封装时该标记才是必需的 |
响应业务对象包含了要从 URL 接收的数据。它包含了响应消息中各种 XML 标记的属性。该响应业务对象的用途取决于它参与以下哪个 InterChange Server 任务:
无论该响应是事件通知的一部分还是请求处理的一部分,只有当 Business Integration Connect 和 InterChange Server 之间的交互是 同步的且期望对您的请求做出业务响应时,才发送响应业务对象。
有关故障业务对象结构的基本描述,请参阅 Adapter for HTTP 用户指南。 要和 Business Integration Connect 一起使用,您必须对请求业务对象定义的结构进行一些定制:
该属性提供了有关消息的传输级头的配置信息。要了解更多信息,请参阅为 V4.2.2 ICS 创建 HTTP 传输级头信息。
此标记有下列语法:
ws_botype=response
如果未指定这个标记,则包装器数据处理程序使用(顶级业务对象中的)wbic_response_mime 属性所指示的子代元对象来确定用于响应的数据处理程序。
如果 Business Integration Connect 与 InterChange Server 之间的交互是 异步的,则 Business Integration Connect 不需要响应,因此您无需创建响应业务对象。
如果您正通过 HTTP 传输协议发送 用后端集成封装的文档,那么您的请求业务对象需要包含定制的传输级头信息。 Adapter for HTTP 希望这个定制的头信息位于 动态元对象中。
图 19 显示了请求业务对象的业务对象结构,该请求业务对象表示通过 HTTP 传输协议传递的以后端集成封装的 Business Integration Connect 文档。
请通过执行下列步骤来确保业务对象结构中包含 HTTP 协议配置元对象:
下面几节中逐一描述了这些步骤。
Adapter for HTTP 支持用户定义属性的业务对象,以便在 HTTP 协议配置元对象中保存定制属性。Business Integration Connect 使用该业务对象来保存后端集成封装所需的 HTTP 属性。它还可以包含 Content-Type 属性(该属性指定了要在请求消息中设置的 content-type 头)和 content-length 属性(该属性指定了消息长度,长度单位为字节)。表 4 描述了各个有效的传输头字段。
要创建 HTTP 头字段的用户定义属性的业务对象定义,请遵循以下步骤:
所有属性的属性类型都应当为“字符串”。您可以用 HTTP 属性的确切名称命名属性(如表 4 的头字段列中所列的那样)。
这个特定于属性级应用程序的信息具有以下格式:
ws_prop_name=HTTPproperty
其中 HTTPproperty 是表 4 的头字段列中的值之一。
在图 19 中,HttpProps_BusObj 业务对象定义包含了各种传输头字段的属性。这些属性都有特定于属性级应用程序的信息,用于指定相关协议头的名称。例如,x-aux-sender-id 属性具有如下所示的特定于应用程序的信息:
ws_prop_name=x-aux-sender-id
对于事件通知,请求、响应或故障业务对象可能包含名为 HTTP 协议配置元对象 的动态元对象,该元对象用来保存配置信息(如头信息)。
有关 HTTP 协议配置业务对象结构的信息,请参阅 Adapter for HTTP 用户指南。 要和 Business Integration Connect 一起使用,您必须对 HTTP 协议配置业务对象定义的结构进行以下定制:
所有属性的属性类型都应当为“字符串”。
该属性的属性类型是用户定义属性业务对象的业务对象定义(参阅创建用户定义属性的业务对象)。
例如,在图 19 中,HttpConfigMO_BusObj 业务对象定义包含 UserDefinedProperties 属性,其属性类型是 HttpProps_BusObj。
请求业务对象定义表示了 Business Integration Connect 所请求的信息。有关如何创建请求业务对象的信息,请参阅请求业务对象。为将动态元对象并入您的有效负载业务对象结构,您必须对您的 请求业务对象定义进行下列修改:
该属性的属性类型是 HTTP 协议配置元对象的业务对象定义(参阅创建 HTTP 协议配置元对象)。
cw_mo_http 标记的格式如下:
cw_mo_http=HttpConfigMetaObjAttr
其中 HttpConfigMetaObjAttr 是保存 HTTP 协议配置元对象的请求业务对象中的属性名。
例如,在图 19 中,名为 HttpConfigMO 的属性被添加到请求业务对象定义 WBIC_HttpRequest_BusObj 中。该属性包含动态元对象,该对象是类型为 HttpConfigMO_BusObj 对象的子业务对象。另外,已修改请求业务对象的特定于应用程序的信息,使其包含以下 cw_mo_http 标记,以标识该动态元对象:
cw_mo_http=HttpConfigMO
为配置 V4.2.2 InterChange Server 以通过 HTTP 传输协议与 Business Integration Connect 进行通信,您必须创建如表 68 所示的 InterChange Server 构件。
表 68. 通过 HTTP 传输协议 V4.2.2 ICS 进行通信的构件
ICS 构件 | 目的 | 了解更多信息 |
---|---|---|
业务对象定义 | 表示文档 | 为通过 HTTP 收发文档的 V4.2.2 ICS 创建业务对象定义 |
连接器对象 | 在运行时表示 Adapter for HTTP | 创建 HTTP 连接器对象 |
协作模板和协作对象 | 表示 InterChange Server 用于处理文档的业务流程 | 绑定协作以与 Adapter for HTTP 进行通信 |
要在运行时获取 Adapter for HTTP 的实例,您必须在“系统管理器”中采取以下步骤:
有关如何配置 Adapter for HTTP 连接器对象以便与 Business Integration Connect 一起使用的信息,请参阅设置用于 V4.2.2 ICS 的 HTTP 传输环境。
如=创建协作中描述的,要使 InterChange Server 从何处接收业务对象以及向何处发送业务对象,协作对象在运行时必须存在。当您为使用 dapter for HTTP 将信息发送 Business Integration Connect 以及从其接收信息的协作创建协作对象时,可以绑定协作端口,如下所示: