corner imagecorner image
FeaturesPluginsDocs & SupportCommunityPartners

BPEL 设计器开发人员指南

由 维护

最后更新：2008 年 4 月
本文适用于 NetBeans IDE 6.1 发行版。

目录

本页内容适用于 NetBeans IDE 6.1

了解 BPEL 模块项目

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

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

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

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

  1. 使用“新建项目”向导来 新建 BPEL 模块项目。
  2. 创建一个复合应用程序项目。

    对于示例流程，复合应用程序项目是自动创建的。对于从头开始创建的流程，应该手动创建复合应用程序项目。

  3. 在复合应用程序项目中添加 JBI 模块。
  4. （可选）编译复合应用程序项目并确保应用服务器已启动。
  5. 在 BPEL 服务引擎上部署复合应用程序项目 。
  6. 创建测试用例。

    对于示例流程，测试用例是自动创建的；对于新项目，则需要创建至少一个测试用例。

  7. 运行一个或所有测试用例。
  8. （可选）调试 BPEL 流程。

新建 BPEL 模块项目

创建 BPEL 模块项目：

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

      “新建项目”。步骤 1

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

    此时，“项目”窗口包含 BPEL 模块项目的一个项目节点。


    新建 BPEL 模块
  4. 要为项目创建 BPEL 文件，请右键单击 Process Files 节点，然后从弹出式菜单中选择“新建”>“BPEL 流程”。
  5. 在“新建 BPEL 流程”对话框中，指定文件名和文件夹。单击“完成”按钮。

    “新建 BPEL 流程”向导

  6. 要为项目创建 WSDL 文件，请右键单击 Process Files 节点，然后从弹出式菜单中选择“新建”>“WSDL 文档”选项。
  7. 在“新建 WSDL 文档”对话框中，指定文件名和文件夹。（可选）选中“导入 XML模式文件”复选框，并浏览选择要导入的模式文件。单击“完成”按钮。

    “新建 WSDL 文档”向导

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

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

查看已创建的工件：

  1. 在“项目”窗口中，展开创建的 BPELModule1 节点和 Process Files 节点。

    Process Files 节点包含三项：

    • 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 文件。有关更多信息，请参阅 使用 WSDL 文件

BPEL 模块项目的属性

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

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

在 “常规” 页面，可以查看包含项目文件的文件夹路径，查看或修改项目服务引擎的前缀（如 com.sun.bpelse）。

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

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

创建复合应用程序项目

不能直接部署 BPEL 模块项目。首先，必须在复合应用程序项目中添加一个 BPEL 模块项目，将其作为 JBI 模块。然后，可以部署复合应用程序项目。通过部署项目，使得应用服务器可以使用服务组合件来运行其服务单元。

创建复合应用程序项目

可以根据“新建项目”向导提示步骤来创建复合应用程序项目。

新建复合应用程序项目：
  1. 选择“文件”>“新建项目”（Ctrl-Shift-N） 选项。
  2. 在“类别”列表中选择“ SOA”，在“项目”列表中选择 “复合应用程序”，然后单击“下一步”按钮。
  3. 在“名称和位置”页中，命名该项目并指定项目文件的存放位置。
  4. 要将新的复合应用程序项目设置为主项目，请将“设置为主项目”复选框保留为选中状态。
  5. 单击“完成”按钮。

    在“项目”窗口中将显示新建的复合应用程序项目。要能够部署和测试运行业务流程，请将 BPEL 模块作为 JBI 模块添加到复合应用程序项目中。

编译 BPEL 模块项目

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

请按照以下步骤来编译 BPEL 模块项目：

  1. 在“项目”窗口中，右键单击 BPEL 模块项目节点，然后选择“编译项目”选项。

    还可以在“项目”窗口中右键单击 BPEL 模块节点，然后选择“清理和编译项目”来执行清理编译操作。

  2. 观察“输出”窗口中是否显示消息 BUILD SUCCESSFUL。

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

将 JBI 模块项目添加到复合应用程序项目：
  1. 在“项目”窗口中，右键单击复合应用程序项目节点，然后选择“添加 JBI 模块”选项。
  2. 在“选择项目”对话框中，选择 BPEL 模块项目文件夹，请确保在“项目 JAR 文件”列表中显示有项目的 JAR 文件，然后单击“添加项目 JAR 文件”。

    要验证是否已将 BPEL 模块添加为 JBI 模块，请在“项目”窗口中展开 Composite Application project > JBI Modules。您会看到 BPEL 模块项目的 JAR 文件。

部署复合应用程序项目

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

部署复合应用程序项目：

  1. 右键单击复合应用程序项目节点，然后选择“部署项目”。
  2. 在“警告”对话框中，请确保选中了 GlassFish V2 选项，然后单击“确定”按钮。
  3. 如果在“输出”窗口中显示消息 Build successful，说明已成功部署。

    如果“输出”窗口不可见，请选择“窗口”>“输出”>“输出” 选项。

  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. 选择“文件”>“新建项目”（Ctrl-Shift-N） 选项。
  2. 在“类别”列表中，展开 “示例” 节点，然后选择 “SOA” 节点。
  3. 在“项目”列表中，选择要创建的示例项目，然后单击“下一步”按钮。
  4. 在“名称和位置”页中，命名该项目并指定项目文件的存放位置。
  5. 单击“完成”按钮。

    向导将为所选示例创建两种类型的项目：示例 BPEL 模块项目和示例复合应用程序项目。可以随意修改示例业务流程，或者在 BPEL 模块中添加其他的 BPEL 流程。要部署、测试运行和调试 BPEL 流程，请使用复合应用程序项目。

返回顶部
Companion
Projects: 		MySQL Database Server   GlassFish Community: an Open Source Application Server   Open Solaris  Open JDK: an Open SourceJDK   Mobile & Embedded Community     Sponsored by 
Sponsored by Sun Microsystems