Throw 节点

本主题包含以下部分:

用途

使用 Throw 节点抛出消息流内的异常。可由以下节点捕获和处理异常:

  • 前置的 TryCatch 节点
  • 消息流输入节点(内置节点 HTTPInput、MQInput、SCADAInput 都有 catch 终端)
  • 前置的 AggregateReply 节点

如果消息的内容包含意外的数据,则您可以包含 Throw 节点来强制错误路径通过消息流。例如,要回退不包含特殊字段的消息,您可以检查(使用 Filter 节点)该字段是否存在。如果它不存在,则可以将消息传递到 Throw 节点,该节点记录有关消息内 ExceptionList 子树中的异常的详细信息。

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

“Throw 节点”图标

在消息流中使用此节点

查看以下样本,了解如何使用此节点:

在消息流中与 TryCatch 节点一起包含 Throw 节点,来提醒系统管理员隐含的错误情况。例如,如果您有计算数字的 Compute 节点,则可测试该计算的结果,如果结果超出某个值,则抛出异常。TryCatch 节点捕获该异常并将消息传播到处理错误的一系列节点。

配置 Throw 节点

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

对于必须为其输入值的所有必需属性(没有定义缺省值的属性),在属性对话框上都会用星号作标记。

如下所示配置 Throw 节点:

  1. 消息编目中,输入包含消息源的消息编目的全限定路径和文件名。这可以是您自己的消息编目或与 WebSphere Message Broker 一起提供的缺省消息编目。要使用所提供的缺省编目,将此属性保留为空白。
  2. 消息号中,输入抛出异常的错误号。

    如果您已经创建了自己的消息编目,则在该编目中输入要在抛出该异常时使用的消息的编号。

    如果您使用的是缺省消息编目,则指定一个在 30013049 之间的号码。这些号码保留在 WebSphere Message Broker 编目中供您使用。缺省消息编目中这些消息的各个文本是一致的,但根据抛出异 常的每个情况可以使用该范围内不同的号码;使用该号码以标识导致错误的确切原因。

    缺省消息号为 3001

  3. 消息文本中,将消息写到本地错误日志时,输入还有您要与消息一起包含的任何其他空闲格式文本。例如,如果您已经检查了消息中存在特殊字段,但在未找到该字段时 抛出异常,则可能包含以下文本:
    消息不包含必需字段:分支号
    如果您使用的是消息编目,则该文本作为 &1 插入消息文本。
  4. 选择属性对话框导航器中的“描述”,以输入简短描述和/或详细描述。
  5. 单击应用在不关闭“属性”对话框的情况下对 Throw 节点进行更改。单击确定以应用更改,并关闭属性对话框。

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

终端和属性

下表描述 Throw 节点终端。

终端 描述
In 接受供节点处理的消息的输入终端。

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

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

属性 M C 缺省值 描述
消息编目   抽取异常的错误号的错误文本的消息编目的名称。缺省值(空白)表明从与 WebSphere Message Broker 一起提供的消息编目采用消息。
消息号 3001 异常抛出时的错误号。
消息文本   解释错误原因的其他文本。

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

属性 M C 缺省值 描述
简短描述   节点的简要描述。
详细描述   描述消息流中节点用途的文本。
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ac04830_