本主题仅适用于 IBM Business Process Manager Advanced 配置。

从 Java 引用中调用 WSDL 接口

在自顶向下式开发中,如果您希望 Java™ 组件或独立引用调用具有 WSDL 接口的组件,那么不必手动创建 Java 引用。可以将 Java 组件连接到具有 WSDL 接口的组件。组合件编辑器将自动添加对 Java 组件的引用。于是,您可以选择为该引用生成与其他组件上的 WSDL 接口匹配的 Java 接口。否则,将为此引用生成 WSDL 接口。

开始之前

本任务适用于这样的情况:您正在进行自顶向下式开发,从而在生成业务实现之前创建组合件图。您可以在有关自顶向下式开发的主题中找到更多有关此开发方式的信息。请参阅下面的相关概念。

关于此任务

如果要从 Java 组件中调用具有 WSDL 接口的组件,请完成下列步骤。您可以使用这些步骤从独立引用中调用具有 WSDL 接口的组件。例如,当您使用 Java 代码(例如 JSP)来访问独立引用时,此功能非常有用。有关在自底向上式开发中使用 Java 类和 EJB 的信息,请参阅下面的相关任务中的“从 WSDL 引用中调用 Java 接口”。

过程

  1. 创建不具有实现类型的组件。
  2. 在选用板中,将 Java 组件拖到组合件图中的第一个组件左侧。
  3. 选择非类型化组件(右侧的组件)。单击此组件上的添加接口图标 “添加接口”按钮
  4. 在“添加接口”窗口中,选择显示 WSDL 作为接口类型并选择现有接口,或者单击新建并在名称字段中输入接口名称。
  5. 绘制一条从 Java 组件到具有 WSDL 接口的组件的连线。系统将显示一条参考消息,该消息指出将在源上生成匹配的引用。系统将询问您是否要继续。单击确定
  6. 接着,系统询问您是否要生成与目标 WSDL 接口兼容的 Java 引用,而不是生成 WSDL 引用。单击 通过选择此选项,可以在源上生成 Java 引用。此 Java 引用允许您使用静态方法。如果使用 WSDL 类型的引用,那么必须使用动态调用接口 (DII) 方法与目标服务进行交互。使用此选项将生成两个接口 - 同步接口和异步接口。(在构建运行之后或者在重新生成实现时,将创建异步接口。)

    在源上生成的 Java 引用将包含 Java 接口。您可以通过选择该引用并右键单击以选择打开接口来打开该接口。生成 Java 组件的实现后,它将有一个用于查找所引用服务的方法。如果在添加新引用之前已生成 Java 实现,那么可以使用同步 > 到实现操作以重新生成实现并对其添加新方法。

    您不应对生成的代码进行修改。如果重构 WSDL 接口,即,如果将其移动或重命名,那么将相应地重构所生成的接口。但是,即使删除此 WSDL 接口,生成的接口也仍存在。如果 WSDL 接口已更改,但未进行重构,那么您将接收到错误消息。要更正此错误,可以对源引用使用重新生成 Java 接口操作以重新生成 Java 引用代码。

    如果已在 Java 组件上创建 WSDL 引用以访问具有 WSDL 接口的组件,那么可以使用转换为 Java 引用操作将源 WSDL 引用更改为 Java 引用。右键单击对 Java 组件的引用可看到弹出菜单,此菜单包含该选项。此操作将在该引用上创建相当于 WSDL 接口的 Java 接口,并允许用户访问具有静态方法的目标服务。

示例

注: 除了“从 WSDL 引用中调用 Java 接口”(请参阅下面的相关任务以获取指向此主题的链接)所描述的特殊情况以外,不能绘制从 WSDL 引用到 Java 接口的连线。