正在创建 ESQL 文件

当您在需要 ESQL 来定制其功能(Compute、Database 和 Filter 节点)的消息流中包含节点时,必须在 ESQL 文件的 ESQL 模块中对提供定制的 ESQL 语句进行编码。如果您选择,可以为多个模块使用同一个 ESQL 文件。

开始之前

要执行此任务,必须先完成下列任务:

ESQL 文件存储在文件系统或者在共享库内。如果您使用的是文件系统,则这可以是本地文件系统或共享的驱动器。如果将文件存储在存储库中,可以使用 Eclipse 支持的任何可用存储库(例如,CVS)。

要创建 ESQL 文件:

  1. 切换到“代理应用程序开发”透视图
  2. 单击文件 > 新建 > 消息流 ESQL 文件

    您也可以按 Ctrl+N。这显示一个对话框,允许您选择向导,以创建新对象。在左视图中单击 Message Brokers,右视图显示了可以为 WebSphere Message Broker 创建的对象列表。单击右边视图中的“消息流 ESQL 文件”,然后单击下一步

    将显示新消息流 ESQL 文件向导。
  3. 输入要在其中创建的 ESQL 文件的消息流项目名称。 必须输入现有消息流项目的名称。对话框显示项目名称字段中输入的当前项目名称。 可以接受这个值,或者更改它以指定不同的项目。您也可以单击浏览来查看有效项目的列表(在“导航器”视图中已定义并显示的项目),并从该列表中选择合适的值。

    如果输入不存在的项目名称,在对话框中显示错误消息该指定的项目不存在,直到您指定了一个有效的项目名称才能继续。

  4. 如果想要在特定的代理模式中定义 ESQL 文件,在适当的输入字段中输入代理模式的名称,或者单击浏览,从该项目有效的代理模式列表中选择代理模式。(如果此项目中只定义了一个缺省代理模式,则禁用浏览。)
  5. 输入新的 ESQL 文件名。 如果输入该项目中已用于 ESQL 文件的名称,在对话框中显示错误消息资源 <名称>.esql 已存在,并且直到您指定了一个有效的名称才能继续。

    由于 Windows 文件系统的限制,创建 ESQL 文件时,文件路径的总长度不得超过 256 个字符。如果尝试将消息流添加到带有 ESQL 或路径长度超过 256 个字符的映射文件的代理归档文件,则不会产生编译过的消息流,并且也无法部署。因此,确保 ESQL 文件、映射文件、对象和代理模式的名称尽可能短。

还可以为您自动创建 ESQL 文件。在右键单击 Compute、Database 或 Filter 节点时,如果从显示的菜单中选择“打开 ESQL”,并且在代理模式中还未存在由相应属性标识的模块,会为您自动创建一个模块。这在与 <message_flow_name>.msgflow 文件相同的项目中,在同一代理模式中的 <message_flow_name>.esql 文件中创建。如果该 ESQL 文件还不存在,则也将为您创建。

单个 ESQL 文件的内容与消息流以及节点没有任何特定的关系。由您决定在哪些文件中创建哪些模块(除非由相应属性标识的指定模块缺省情况下是在 <message_flow_name>.esql 中 文件的,如上所述)。监视每个文件中的 ESQL 大小和复杂性,如果它们变得难以查看或管理,就拆分文件。

如果在 ESQL 文件内创建可再次使用的子例程(在代理模式级别),可能想要从其他项目的 ESQL 模块中引用这些例程。要完成此操作,指定要调用子例程的项目,这取决于是否定义了 ESQL 中包含的项目。您可以在创建第二个项目时指定它或者更新项目的相关性,具体操作如下:选择项目并单击属性,并且在属性对话框的“项目引用”页面中更新相关性。

相关概念
项目引用
开发存储库
消息流概述
消息映射概述
代理模式
ESQL 模块
相关任务
开发消息流
相关参考
内置节点
ESQL 引用
声明 | 商标 | 下载 | 书库 | 支持 | 反馈
Copyright IBM Corporation 1999, 2006 最后一次更新时间:2006/08/14
ak09031_