JavaCompute 节点

本主题包含以下部分:

用途

使用 JavaCompute 节点可以执行以下某个任务:

  • 检查入局消息并根据它的内容将它不作任何更改地传播到两个输出终端中的一个;该节点行为的方式与 Filter 节点相似,但它使用 Java 而不是 ESQL 来确定要使用哪个输出终端。
  • 更改部分入局消息并将更改的消息传播到输出终端中的一个。
  • 创建和构建完全独立于输入消息的新输出消息。

该节点使用的 Java 代码存储在 Eclipse Java 项目中。

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

Compute 节点图标

在消息流中使用此节点

可以通过以下三种方式使用 JavaCompute 节点:

  • 使用 JavaCompute 节点查看消息,并根据消息的内容将它传播到输出终端。不更改消息的内容,您对该消息具有只读访问权。
  • 使用 JavaCompute 节点修改消息,并将修改过的消息传播到输出终端。
  • 使用 JavaCompute 节点创建新的消息,并将该新消息传播到输出终端。

Message Brokers Toolkit中的样本收藏夹里查看样本。

配置 JavaCompute 节点

您可以配置消息流中出现的每个 JavaCompute 节点实例。

要执行此操作,在编辑器视图中右键单击该节点。将显示打开 Java 选项。单击此属性。

第一次执行此操作时,将启动向导,指导您完成创建新的 Java 项目和包含一些框架代码的 Java 类。此框架代码将显示在 Java 编辑器中。

请参阅为 JavaCompute 节点创建 Java 代码,获取框架代码或所提供模板的示例。

如果这不是您第一次执行此操作,则在 Java 计算透视图中显示 Java 代码。

要将 JavaCompute 节点的实例与某个 Java 类关联,在消息流的编辑器视图中右键单击该节点并选择属性,然后选择基本。将显示该节点的基本属性。

JavaCompute 节点只有一个基本属性。就是 Java 类。输入在此节点使用的 Java 类的名称。此名称必须在该消息流项目的项目引用中提供的 JavaCompute 节点类列表中。

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

完成配置时,单击应用。这会在不关闭属性对话框的情况下对 JavaCompute 节点进行更改。

或者,单击确定。这会对 JavaCompute 节点进行更改并关闭属性对话框。

您可以单击取消关闭对话框,并废弃对该节点所作的所有更改。

指定 Java

编码 Java 语句可以定制 JavaCompute 节点的行为。

例如,使用输入消息或数据库内容(未经更改或修改)或新数据,您可以定制它来创建新输出消息或消息。例如,您可能要通过添加数据库的值在输入消息中修改值,并在输出消息中的字段存储结果。

在与 JavaCompute 节点关联的 Java 文件中编写您想要的 Java 语句。

如果此节点的 Java 文件尚不存在,右键单击 JavaCompute 节点并单击打开 Java。这将在编辑器视图中创建并打开了新的 Java 文件。

如果该文件已存在,单击 Java 类属性旁边的浏览按钮。将显示“JavaCompute 节点类型选择”对话框,它将列出此消息流可访问的 Java 类列表。选择相应的 Java 类并单击确定。当在“选择”字段中输入至少一个字符后,匹配类型列表将显示合适的 Java 类。
注: 如果在“选择”字段中输入“*”,则显示所有的 Java 类。

验证消息

设置验证属性可以定义如何验证 JavaCompute 节点产生的消息。注意这些属性不会使输入消息生效。预期如果这种验证是必需的,则输入节点或前面的 Validation 节点将已经执行了验证。

有关更多详细信息,请参阅验证消息MRM 域中消息的验证属性

终端和属性

下表中描述了 JavaCompute 节点的终端。

终端 描述
In 接受供节点处理的消息的输入终端。
Failure 如果在计算期间检测到故障,则这就是输入消息路由到的输出终端。(即使设置了验证属性,也不会验证传播到节点的 failure 终端的消息。)
Out 这是转换的消息路由到的输出终端。
Alternate 备用的输出终端,可以将已转换的消息路由到该终端,而不是 Out 终端。

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

JavaCompute 节点具有下表中描述的基本属性。

属性 M C 缺省值 描述
Java 类 此节点中使用的 Java 类的名称。此名称必须出现在可供使用的 Java 类列表中。

下表中描述了 JavaCompute 节点的验证属性。

属性 M C 缺省值 描述
验证 是否发生验证,以及验证消息的哪一部分。有效值为内容和值内容继承
故障操作 异常 验证失败后将发生什么操作。只有将验证设置为内容内容和值,才可以设置该属性。有效值为用户跟踪本地错误日志异常异常列表
包含所有值约束 选中 无法编辑此属性。缺省操作,由所选的复选框表明,即验证中包含所有值约束。
修改 无法编辑此属性。提供了最小修订。有效值为全部

下表中描述了 JavaCompute 节点“一般消息选项”的属性。

属性 M C 缺省值 描述
解析计时 按需解析 该属性控制何时解析输入消息。有效值为按需解析立即解析完全解析

请参阅按需解析,获取此属性的完整描述。

将 MQRFH2C 压缩解析器用于 MQRFH2 域 False 该属性控制 MQRFH2 头中是否使用 MQRFH2C 压缩解析器,而不是 MQRFH2 解析器。

下表中描述了 JavaCompute 节点“XMLNSC 解析器选项”的属性。

属性 M C 缺省值 描述
将 XMLNSC 压缩解析器用于 XMLNS 域 已清除 更新开始设置该属性会导致外发 MQRFH2 指定 XMLNS 而不是 XMLNSC 解析器,允许外部应用程序保持不变。如果外发消息不包含 MQRFH2 头,则该属性不起作用。更新结束
混合内容保留方式 此属性控制当 XMLNSC 解析器遇到输入消息中的混合文本时,是否使用该解析器创建消息树中的元素。有效值为全部。选择全部表示为混合文本创建元素。选择表示忽略混合文本并且不创建元素。
注释保留方式 此属性控制当 XMLNSC 解析器遇到输入消息中的注释时,是否使用该解析器创建消息树中的元素。有效值为全部。选择全部表示为注释创建元素。选择表示忽略注释并且不创建元素。
处理指令保留方式 此属性控制当 XMLNSC 解析器遇到输入消息中的处理指令时,是否使用该解析器创建消息树中的元素。有效值为全部。选择全部表示为处理指令创建元素。选择表示忽略处理指令并且不创建元素。

下表中描述了 JavaCompute 节点的描述属性。

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