FeaturesPluginsDocs & SupportCommunityPartners

BPEL 设计器开发者指南:BPEL 项目


目录

BPEL 设计器开发者指南


了解 BPEL 项目

要创建您自己的 BPEL 项目,您可以从头开始创建自己的 BPEL 模块,或者从创建样例流程入手。

BPEL 项目通过为以下操作启用“指向并单击”支持来提供 NetBeans Enterprise Pack/运行环境集成:

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

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

  1. 生成 BPEL 模块项目。
    请使用 BPEL 设计器来创建项目。
  2. 创建一个复合应用程序项目。
    如果以前尚未创建,请创建该项目;对于样例流程,会自动创建复合应用程序项目。
  3. 将 BPEL 模块作为 JBI 模块添加到复合应用程序项目中。
  4. (可选)生成复合应用程序项目。
  5. 确保应用服务器已启动。
  6. 部署复合应用程序项目。
  7. 创建测试用例。
    对于样例流程,测试用例是自动创建的;对于新项目,则需要创建至少一个测试用例。
  8. 运行一个或所有测试用例。

部署和测试要求应用服务器正在运行。

生成、部署和测试运行步骤是特定于运行环境集成的。目前,BPEL 服务器社区中并没有这些任务的标准规范,因此,这些任务只能针对指定的服务器供应商。

BPEL 项目“设计”视图生成的 BPEL 源工件与标准的 BPEL 2.0 非常接近,但本发行版本中未提供的 BPEL 2.0 元素中列出了它们的不同之处。

返回页首


创建新的 BPEL 项目

您可以使用 IDE 来创建新的 BPEL 项目。为此:

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

    步骤 1

  2. 单击“下一步”。
  3. 提供“项目名称”、“项目位置”和“项目文件夹”字段,或者接受缺省值。
  4. 单击“完成”。

    步骤 2

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

    BPEL 模块节点

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

    新建 BPEL 流程文件

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

    新建 WSDL 文件

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

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

查看已创建的工件:

  1. 在“项目”窗口中,展开创建的 "BpelModule1" 节点和“流程文件”节点。
    “流程文件”节点包含以下项:
    • newProcess.bpel(BPEL 流程)
    • newWSDL.wsdl(流程 Web 服务接口)。

    BPEL 模块流程文件

  2. 双击 "newProcess.bpel" 节点。
    请注意以下内容:
    • 源代码编辑器包含了 newProcess.bpel 的标签。
    • “设计”视图中显示了 newProcess.bpel 图。
      “设计”视图是业务流程的可视设计器。在此视图中,您可以按可视方式对业务流程进行建模。BPEL 设计工具将自动生成对应于可视设计的 BPEL 代码。
    • 在源代码编辑器的右侧打开了 BPEL 元素的组件面板。
    • 在组件面板的下面,打开了选定元素的属性窗口。
    • “导航”窗口显示了 BPEL 流程的 BPEL 逻辑视图。
    • 并在底部显示了“BPEL 映射器”窗口(如果它未自动显示,请从主菜单中选择“窗口”>“BPEL 映射器”)。

    已打开 BPEL 文件
    单击以放大

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

BPEL 模块项目的属性

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

  • 常规
  • (生成)>“子项目引用”

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

仅为可以包含子项目的 BPEL 模块项目显示“子项目引用”页。可以在其中查看、添加、删除和重新排列 BPEL 模块项目引用的子项目(.jar 文件)。

返回页首


创建新的 JBI 部署项目

不能直接部署 BPEL 项目。您必须先将 BPEL 项目作为 JBI 模块添加到复合应用程序项目中。然后,您可以部署复合应用程序项目。通过部署该项目,可使服务组装用于应用服务器中,从而可以运行其服务单元。有关复合应用程序项目的详细信息,请参见 BPEL 运行环境部分。

创建复合应用程序项目

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

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

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

生成 BPEL 模块项目

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

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

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

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

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

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

返回页首


将复合应用程序项目部署到 JBI 服务器上

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

您可以部署复合应用程序项目:

  1. 右键单击复合应用程序项目节点,然后选择“部署项目”。
  2. 在警告对话框中,请确保选择了 "Sun Java System Application Server 9",然后单击“确定”。
  3. 如果在“输出”窗口中看到“成功”消息,则说明已成功完成了部署。
  4. 如果未显示“输出”窗口,请选择“窗口”>“输出”。
  5. 切换至“运行环境”窗口,展开“服务器”> "Sun Java System Application Server" > "JBI",右键单击“服务组装”节点,
  6. 然后选择“刷新”。您会看到部署的服务组装。

返回页首


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

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

例如,“新建项目”样例向导会自动生成两种类型的项目(BPEL 模块和复合应用程序),因此,不需要分别创建这些项目。但是,要部署样例应用程序,您需要手动将 BPEL 模块作为 JBI 模块添加到复合应用程序项目中。

在 BPEL 设计器中,可以创建以下样例流程:

同步样例流程

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

异步样例流程

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

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

旅行预订服务样例

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

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

创建样例 BPEL 项目:通用流程

创建样例 BPEL 项目:

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


返回页首

Bookmark this page

del.icio.us furl simpy slashdot technorati digg
Companion
Projects:
MySQL Database Server   Open JDK: an Open SourceJDK   GlassFish Community: an Open Source Application Server    Mobile & Embedded Community    Open Solaris   java.net - The Source for Java Technology Collaboration   Virtual Box - full virtualizer  Open ESB - The Open Enterprise Service Bus Powered by