HTTPReply 节点

本主题包含以下部分:

目的

使用 HTTPReply 节点将来自消息流的响应返回到 Web Service 客户机。该节点生成到 Web Service 客户机的响应(HTTPInput 节点从该客户机接收输入消息),并等待确认表示响应已发送。

如果在消息流中包含 HTTPReply 节点,则必须在同一流中包含 HTTPInput 节点,或者必须从始于 HTTPInput 节点另一个流接收消息。响应通过请求标识与应答相关联,该请求标识由 HTTPInput 节点存储在 LocalEnvironment 中。

该节点从整个输入消息树为 Web Service 客户机构造应答消息,并将它返回到请求方。

HTTPReply 节点在工作台中由以下图标表示:

“HTTPReply 节点”图标

在消息流中使用此节点

请参阅 HTTPInput 节点获取可以如何使用此节点的示例。

配置 HTTPReply 节点

当您将 HTTPReply 节点的实例放入消息流后,便可对它进行配置。右键单击编辑器视图中的节点,然后单击属性。 将显示节点的“基本”属性。

必须为其输入值的所有必要属性(不含已定义缺省值)在该“属性”对话框上都用星号进行标记。

如下所示配置 HTTPReply 节点:

  1. 如果您要忽略与传输相关的故障(例如,如果客户机断开连接),则选中选择传输故障复选框。如果您清除复选框,并且发生与传输相关的错误,则将输入消息传播到 failure 终端。如果您清除复选框,则必须为应答发送超时提供一个值。
  2. 如果您不忽略传输故障,则设置应答发送超时值。这是节点等待确认表示客户机接收到应答所需的时间长度。如果在此时间内接收到确认,则输入消息会通过 out 终端传播到其余的消息流(如果此终端已连接)。如果在该时间内未接收到确认,则在已连接 failure 终端的情况下,通过该终端传播输入消息。如果没有连接 failure 终端,并且未及时接收到确认,则生成异常。
  3. 如果要使用 HTTPReplyHeader 或 HTTPResponseHeader 的值创建缺省 Web service 头,请确保选中从应答或响应生成 HTTP 头复选框。如果在输入消息中不存在相应的头,则使用缺省值。

    节点始终将设置为正确计算值的 Content-Length 头包含在 HTTPReplyHeader 中,即使原始请求中未包含该头。

  4. 如果您要 MRM 解析器按照从消息集生成的字典验证消息的体,则在“属性”对话框导航器中选择“验证”。(如果消息传播到节点的 Failure 终端,则不进行验证。)

    要获取详细信息,请参阅验证消息MRM 域中消息的验证属性

  5. 选择“属性”对话框导航器中的“描述”,以输入简短描述和/或详细描述。
  6. 单击应用在不关闭“属性”对话框的情况下对 HTTPReply 节点进行更改。单击确定以应用更改,并关闭“属性”对话框。

    单击取消以关闭对话框,并废弃对属性所作的所有更改。

将 output 终端连接到另一个节点

如果您要进一步处理消息、处理错误或将消息发送到其他目标,则将此节点的 out 或 failure 终端连接到此消息流中的另一个节点。

终端和属性

在以下表中描述了 HTTPReply 节点终端。

终端 描述
In 接受节点处理的消息的输入终端。
Failure 如果在消息传播期间检测到故障,则这就是消息路由到的输出终端。
Out 如果成功地传播了消息,并且在此消息流内要求进一步处理,则这是消息路由到的输出终端。

下表描述节点属性;头为 M 的列表示属性是否为必需的(没有定义缺省值时,如果必须输入值,则用星号在“属性”对话框上标注),头为 C 的列表示属性是否为可配置(将消息流添加到 BAR 文件以进行部署时可以更改值)。

下表描述 HTTPReply 节点的“基本”属性。

属性 M C 缺省 描述
忽略传输故障 选择 是否忽略传输相关的故障。如果您选中该复选框,则执行此操作。
应答发送超时 120 在假设应答已经不能到达客户机前应答节点等待的时间(以秒为单位)。有效范围是零(表示不确定的等待)到(231)-1。仅当已清除忽略传输故障时才有效。
从应答或响应生成缺省 HTTP 头 选择 如果使用 HTTPReplyHeader 或 HTTPResponseHeader 的值创建缺省 Web service 头,则选中该复选框。

下表描述 HTTPReply 节点的“验证”属性。

请参阅MRM 域中消息的验证属性,以获取这些属性的完整描述。

属性 M C 缺省 描述
验证 继承 验证是否发生。有效值为内容和值内容继承
故障操作 异常 验证失败后将发生什么操作。只有将验证设置为内容内容和值,才可以设置该属性。有效值为用户跟踪本地错误日志异常异常列表
包含所有值约束 选择 无法编辑此属性。所选的复选框指出的缺省操作,即内容和值验证中包括的基本值约束检查。
固定 无法编辑此属性。

下表描述 HTTPReply 节点的“描述”属性。

属性 M C 缺省 描述
简短描述   节点的简要描述。
详细描述   描述消息流中节点用途的文本。
声明 | 商标 | 下载 | | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后更新:2006/05/19
ac04585_