FeaturesDocs & SupportCommunityBlogsPartners

BPEL 设计器开发人员指南：BPEL 模块项目

由 Bob May 创建，由 Irina Filippova
维护，2007 年 12月

目录

本页面内容适用于 NetBeans 6.0 IDE

BPEL 设计器开发人员指南

了解 BPEL 模块项目

BPEL 模块项目是一组源文件，它包括 BPEL 文件、WSDL 文件、XSD 文件和 XML 模式文件。在 BPEL 模块项目中，我们可以设计与 WS-BPEL 2.0 语言规范兼容的业务流程。

BPEL 项目为以下操作提供了“指向并单击”支持：

  • 使用“新建项目”向导来创建新的 BPEL 项目和复合应用程序项目。
  • 导入 WSDL 资源以用作业务流程中的合作伙伴服务。
  • 根据需要，创建新的 WSDL 资源。
  • 导入 XML 架构资源。
  • 将 BPEL 活动添加到业务流程图中，并使用属性编辑器、定制编辑器和弹出菜单操作进一步定义这些元素。
  • 添加到 BPEL、WSDL 和 XSD 文件的源代码中。
  • 检查和验证 XML 源代码。
  • 将项目作为 JBI 模块添加到复合应用程序项目中。
  • 将示例消息发送到部署的一个或多个 BPEL 流程以测试运行流程。
  • 调试部署的业务流程。

因此，在生成 BPEL 流程时遵循的通用步骤是：

  1. 使用“新建项目”向导来 创建 BPEL 模块项目
  2. 创建一个复合应用程序项目。
    对于示例流程，测试用例是自动创建的。对于新项目，则需要手动创建复合应用程序项目。
  3. 将 BPEL 模块作为 JBI 模块添加到复合应用程序项目中。
  4. （可选）生成复合应用程序项目并确保应用服务器已启动。
  5. 将复合应用程序项目 部署 到 BPEL 服务引擎。
  6. 创建测试用例。
    对于示例流程，测试用例是自动创建的；对于新项目，则至少需要创建一个测试用例。
  7. 运行一个或所有测试用例。
  8. （可选）调试 BPEL 流程。

回到顶部

创建 BPEL 模块项目

创建 BPEL 模块项目：

  1. 从 IDE 的主菜单中选择“文件”>“新建项目”，然后执行以下步骤：
    1. 在“类别”下面，选择“面向服务的体系结构”。
    2. 在“项目”下面，选择“BPEL 模块”并单击“下一步”按钮。

    步骤 1

  2. 在“名称和位置”页中，命名该项目并指定项目文件的位置或接受默认值。
  3. 单击“完成”按钮。

    步骤 2

    现在，“项目”窗口已包含该 BPEL 模块的项目节点。

    BPEL 模块节点

  4. 要为项目创建 BPEL 文件，请右键单击“流程文件”节点，然后从弹出菜单中选择“新建”>“BPEL 流程”。
  5. 在“新建 BPEL 流程”话框中，指定文件名、文件夹以及目标名称空间。单击“完成”按钮。

    新建 BPEL 流程文件

  6. 要为项目创建 WSDL 文件，请右键单击“流程文件”节点，然后从弹出菜单中选择“新建”>“WSDL 文档”。
  7. 在“新建 BPEL 流程”对话框中，指定文件名、文件夹以及目标名称空间。（可选）选中“导入 XML 架构文件”复选框，并浏览要导入的架构文件。单击“完成”按钮。

    新建 WSDL 文件

在“项目”窗口中浏览 BPEL 模块项目

通用的 BPEL 模块项目会包含 BPEL 源文件、WSDL 和 XSD 文件。

查看已创建的件：

  1. 在“项目”窗口中，展开创建的 "BpelModule1" 节点和“流程文件”节点。

    “流程文件”节点包含以下项：
    • newProcess.bpel（BPEL 流程）
    • newWSDL.wsdl（流程 Web 服务接口）。

    BPEL 模块流程文件

  2. 双击 "newProcess.bpel" 节点。
    请注意以下内容：
    • “设计”视图中显示了 newProcess.bpel 图。
      “设计”视图是业务流程的可视设计器。BPEL 设计器将自动生成对应于可视化设计的 BPEL 代码。
    • 单击“源”按钮可以调用 newProcess.bpel 的源视图。
    • 在源代码编辑器的右侧打开了 BPEL 元素的组件面板。
    • 在组件面板的下面，打开了选定元素的属性窗口。
    • “导航”窗口显示了 BPEL 流程的 BPEL 逻辑视图。
    • 并在底部显示了“BPEL 映射器”窗口（如果它未自动显示，请从主菜单中选择“窗口”>“BPEL 映射器”）。

    已打开 BPEL 文件
    单击以放大

  3. 双击 "newWSDL.wsdl" 节点可打开 WSDL 编辑器 ，您可以在其中查看和修改 newWSDL.wsdl 文件。

BPEL 模块项目的属性

要打开 BPEL 模块项目的“属性”对话框，请右键单击 BPEL 模块项目节点，然后选择“属性”。在左窗格的树状视图中会显示您可以访问的两个页面：

  • 常规
  • 项目引用
  • XML 目录。

在“常规”页中，您可以查看包含项目文件的文件夹的路径，查看或修改项目服务引擎的前缀（如 com.sun.bpelse），并为项目的组装单元和应用程序子组装提供别名和描述。

“项目引用”页显示了 BPEL 模块项目引用的其他 BPEL 模块项目。可以在其中添加和删除 BPEL 模块项目引用的子项目。

“XML目录”页显示了在 BPEL 模块项目中使用的 XML 目录条目。XML 目录所提供的映射信息将 XML 文档中的外部条目映射到被引用文档的实际位置。可以在其中删除 BPEL 模块项目 XML 目录列表中的 XML 目录条目。

回到顶部


创建一个复合应用程序项目。

不能直接部署 BPEL 模块项目。您必须先将 BPEL 项目作为 JBI 模块添加到复合应用程序项目中。然后，您可以部署复合应用程序项目。通过部署该项目，可使服务组合件用于应用服务器中，从而可以运行其服务单元。

创建复合应用程序项目

“新建项目”向导可指导您完成创建复合应用程序项目所需的步骤。

创建新的复合应用程序项目：

  1. 选择 File > New Project（Ctrl-Shift-N） 选项。
  2. 在“类别”列表中选择“面向服务的体系结构”，在“项目”列表中选择“复合应用程序”，然后单击“下一步”。
  3. 在“名称和位置”页中，命名该项目并指定项目文件的位置。
  4. 要将新的复合应用程序项目设置为主项目，请将“设置为主项目”复选框保留为选中状态。
  5. 单击“完成”按钮。
    将在“项目”窗口中显示新的复合应用程序项目。要能够部署和测试运行业务流程，请将 BPEL 模块作为 JBI 模块添加到复合应用程序项目中。

生成 BPEL 模块项目

在生成项目时，IDE 将编译 BPEL 源文件，并将 BPEL 文件和 Web 服务工件（包括 WSDL 和 XSD 文件）打包为 JAR 归档文件。您应该将此项目 JAR 文件添加到复合应用程序项目中，然后将其部署到 JBI 服务器上。

请按照以下步骤来生成 BPEL 模块项目：

  1. 在“项目”窗口中，右键单击 BPEL 模块点，然后选择“生成项目”。
    您还可以通过在“项目”窗口中右键单击 BPEL 模块节点，然后选择“清理并生成项目”来执行清理生成操作。
  2. 观察“输出”窗口中是否出现“生成成功”消息。

将 JBI 模块添加到复合应用程序项目

将 JBI 模块项目添加到复合应用程序项目：

  1. 在“项目”窗口中，右键单击复合应用程序项目节点，然后选择“添加 JBI 模块”。
  2. 在“选择项目”对话框中，选择 BPEL 模块项目文件夹，请确保在“项目 JAR 文件”列表中显示项目的 JAR 文件，然后单击“添加项目 JAR 文件”。
    要验证是否已将 BPEL 模块添加为 JBI 模块，请在“项”窗口中展开复合应用程序项目 >“JBI 模块”。您会看到 BPEL 模块项目的 JAR 文件。

回到顶部


部署复合应用程序项目。

使用部署操作可编译复合应用程序项目中的文件，将编译的 BPEL 和相关的 Web 服务工件（包括 WSDL 和 XSD 文件）打包为归档文件，然后将它们部署到 JBI 服务器上。

部署复合应用程序项目：

  1. 右键单击复合应用程序项目节点，然后选择“部署项目”。
  2. 在警告对话框中，请确保选中了 "GlassFish V2"，然后单击“确定”。
  3. 如果在“输出”窗口中看到“成功”消息，则说明已成功完成了部署。
    如果未显示“输出”窗口，请选择“窗口”>“输出”>“输出”。
  4. 打开““输出””窗口中，展开“服务器”> "GlassFish V2" > "JBI" >“服务组合件”节点查看已部署的“服务组合件”。
    如果未看到已部署的项目，右键单击“服务组合件”节点并选择“刷新”。

回到顶部


在 BPEL 设计器中创建示例流程

了解构造 BPEL 图的最佳方法是创建示例流程。您可以通过修改现有的示例流程来设计 BPEL 流程。

例如，“新建项目”示例向导会自动生成两种类型的项目（BPEL 模块和复合应用程序），因此，不需要分别创建这项目。IDE 会自动将 BPEL 模块作为 JBI 模块添加到复合应用程序项目中。

在 BPEL 设计器中，可以创建以下示例流程：

同步示例流程

同步流程是指这样的对话模式：客户端向流程发送消息，等待回复，仅当收到回复后才会继续执行操作。创建同步示例流程时，IDE 使用单个同步操作以及所需的 WSDL 和 XML 架构文件来生成框架流程。

异步示例流程

异步流程适用于长时间运行的对话模式：在继续执行操作之前，客户不会等待来自流程的回复。此流程会接受客户端的请求，执行可能需要很长时间的操作，然后在操作完成时异步地回调客户端，而不是同步地将结果返回到客户端。创建异步流程时，IDE 使用一个传入异步操作和一个传出异步操作以及所需的 WSDL 和 XML 架构文件来生成框架流程。

请注意，任何特定的流程都可以包含与一个或多个对话合作伙伴之间的同步和异步交互的任意组合。

旅行预订服务示例

此示例是一个使用大多数 BPEL 元素和几个合作伙伴 Web 服务构造的真实 BPEL 流程示例。

此向导在创建旅行预订服务示例的同时还会创建另一个项目（预订合作伙伴服务），它是三个合作伙伴服务的基于 EJB 和 JMS 的基本实现。

创建示例 BPEL 项目：通用流程

创建 BPEL 模块项目：

  1. 选择 File > New Project（Ctrl-Shift-N） 选项。
  2. 在“类别”列表中，展开“示例”节点，然后选择“面向服务的体系结构”。
  3. 在“项目”列表中，选择要创建的示例项目，然后单击“下一步”。
  4. 在“名称和位置”页中，命名该项目并指定项目文件的位置。
  5. 单击“完成”按钮。
    向导将为选定示例创建两种类型的项目：示例 BPEL 模块项目和示例复合应用程序项目。您可以随意修改示例业务流程，或者在 BPEL 模块中添加其他的 BPEL 流程。要部署、测试运行以及调试流程，请将示例 BPEL 项目作为 JBI 模块添加到复合应用程序项目中。

回到顶部

Companion
Projects: 		                  Powered by: