合作伙伴链接

另请参见

在 BPEL 语言中，合作伙伴链接是对 BPEL 流程交互的外部 Web 服务的引用。合作伙伴链接活动用于定义每个合作伙伴在对话消息交换中所扮演的角色。依靠其对合作伙伴链接类型的引用，合作伙伴链接活动间接地指示每个合作伙伴实现的端口类型。

合作伙伴链接元素和合作伙伴链接类型定义

合作伙伴链接类型是对 WSDL 的 BPEL 扩展。因此，它在 WSDL 文件中进行定义，而不是在 BPEL 文件中定义。合作伙伴链接类型在一个或两个任意角色之间创建一种关联，并指示每个角色必须实现单个端口类型。通过将端口类型与角色进行关联，合作伙伴链接类型定义了合作伙伴之间的交互规则。

请不要混淆合作伙伴链接元素和合作伙伴链接类型定义之间的区别：

• 合作伙伴链接类型和角色是 BPEL 扩展，它们是在 WSDL 文件中定义的。
• 合作伙伴链接元素是 BPEL 2.0 元素。它们是在 BPEL 流程文件中定义的。合作伙伴链接元素会引用合作伙伴链接类型属性。

合作伙伴链接类型定义是合作伙伴链接元素的先决条件。只能通过引用特定合作伙伴链接类型和角色（它们必须在 WSDL 文件中进行定义）来定义合作伙伴链接元素。

添加合作伙伴链接的方法

可以使用以下任一方法，在业务流程中添加合作伙伴链接：

• 将合作伙伴链接元素从组件面板拖到图中。
• 将 WSDL 文件从“项目”窗口的同一个项目拖到图中。
• 将 WSDL 文件从“项目”窗口的其他项目拖到图中。IDE 会自动检索另一个项目中的 WSDL 文件，并将相关文件复制到项目结构内的合作伙伴目录中。
• 将 Web 服务节点从“项目”窗口中的 EJB 项目拖到图中。

• 拖动 Web 服务节点时，BPEL 设计器将从应用服务器中检索 WSDL 文件。要成功检索 WSDL 文件，应用服务器必须正在运行并且必须部署了 Web 服务项目。

使用合作伙伴链接元素

使用合作伙伴链接元素：

1. 在“设计”视图中，使用上面列出的一种方法，将合作伙伴链接元素添加到图中。
   将显示合作伙伴链接属性编辑器对话框。
2. 在属性编辑器对话框中，请指定以下内容：
• 名称。接受缺省名称或输入任意名称。名称在流程中必须是唯一的。
• WSDL 文件。选择与合作伙伴链接关联的外部服务的 WSDL 文件。
  如果通过将 WSDL 文件拖到图中来添加合作伙伴链接元素，则可能预先选择了 WSDL 文件。
3. 请选择以下任一选项来指定合作伙伴链接类型：
• 使用现有的合作伙伴链接类型。如果要使用指定的 WSDL 文件中已存在的合作伙伴链接类型定义，请选择此单选按钮，并按照下面的使用现有合作伙伴链接类型的步骤进行操作。
• 使用新建的合作伙伴链接类型。如果要在指定的 WSDL 文件中创建新的合作伙伴链接类型定义，并在此合作伙伴链接元素中使用该定义，请选择此单选按钮，并按照下面所述的使用新合作伙伴链接类型的步骤进行操作。

使用现有的合作伙伴链接类型：

1. 选择“使用现有的合作伙伴链接类型”单选按钮，然后从下拉列表中选择合作伙伴链接类型。“我的角色”和/或“合作伙伴角色”字段是自动进行填充的。
2. 单击“确定”。
   IDE 将使用您提供的值来修改 BPEL 文件。

• 要交换业务流程角色（我的角色）和合作伙伴角色（合作伙伴角色），请单击“交换角色”按钮。

添加新的合作伙伴链接类型并配置合作伙伴链接元素以使用它：

1. 选择“使用新建的合作伙伴链接类型”单选按钮，并指定合作伙伴链接类型的名称。
2. 按如下方式指定业务流程角色（我的角色）和/或合作伙伴角色（合作伙伴角色）：
1. 选中要定义的角色对应的复选框。
2. 在“角色名称”字段中指定角色名称。
3. 从下拉列表中选择端口类型。
3. 单击“确定”。
   IDE 将在 WSDL 文件中添加新的合作伙伴链接类型定义，并使用您提供的值来修改 BPEL 文件。

• 请注意，至少要设置一个角色；否则，无法正确配置合作伙伴链接。

另请参见

接收

回复

调用

添加 WSDL 和 XML 架构导入

关于 WSDL 编辑器

BPEL 设计器组件面板：Web 服务

关于 BPEL 设计器的“设计”视图