BPEL 设计器开发者指南
在 WSDL 编辑器中,可以编辑 Web 服务描述语言 (Web Services Description Language, WSDL) 文件。WSDL 是基于 XML 的语言,用于描述 Web 服务。WSDL 文件包含有关 Web 服务功能的信息以及有关如何访问 Web 服务的信息。此编辑器支持 1.1 版的 WSDL 规范。
在 BPEL 模块项目中,可以使用 WSDL 文件为业务流程及其合作伙伴服务定义接口。
您可以从头开始创建 WSDL 文件,或者基于现有的 WSDL 文件进行创建。
WSDL 编辑器提供了“源”视图和 "WSDL" 视图。
WSDL 文件包含以下主要元素:数据类型、消息、端口类型、绑定以及服务。
您可以在 WSDL 文件中添加以下 BPEL 可扩展性元素:合作伙伴链接类型、属性以及属性别名。
WSDL 编辑器包含一个验证工具。该验证工具用于检查 WSDL 文件中的语法和语义问题。“输出”窗口将显示任何错误或警告。
返回页首
要创建 WSDL 文件,必须选择以下任一方法:
向导的输出是一个格式正确的有效 WSDL 文件,该文件包含一组相互关联的元素,其中包括所需的消息、一个端口类型(及其相应的合作伙伴链接类型)、一个绑定以及一个服务。您可以随后使用 WSDL 编辑器来修改该文件。
从头开始创建 WSDL 文件:
基于现有的 WSDL 文件来创建 WSDL 文件:
WSDL 编辑器提供了“源”视图和 "WSDL" 视图。WSDL 编辑器工具栏包含两个可用于访问不同视图的按钮。
“源”视图中显示基本 XML 源代码。您可以直接编辑 XML。
对于每个打开的文档,源代码编辑器顶部都有一个对应的标签。每个标签都显示文档的名称。如果修改了文档并且尚未对其进行保存,则其名称后面将显示一个星号 (*)。您可以通过右键单击某个标签来访问各种不同的命令。
工具栏位于源代码编辑器窗口的顶部。
源代码编辑器中显示的源代码根据语法被标记为不同的颜色。
源代码编辑器的状态行位于水平滚动条下面。要在插入模式和覆盖模式之间进行切换,请使用 Insert 键。
在 "WSDL" 视图中,可以使用 GUI 组件来配置 WSDL 文件的元素和属性。
"WSDL" 视图包含两个子视图:树视图和列视图。要在子视图之间进行切换,请使用 WSDL 编辑器工具栏中的按钮。
某些组件节点可以添加扩展属性。在“添加扩展属性”对话框中,您可以指定名称和名称空间。添加属性后,您可以在“属性”窗口中指定其值。此外,也可以删除这些组件节点的扩展属性。
如果右键单击某个组件节点并选择“转至源”,则会显示“源”视图,并将光标置于组件块开头。
您可以执行重构:
您也可以通过更改“名称”属性的值来重命名组件。WSDL 编辑器将重命名同一文件中的所有实例,但不会重命名其他文件中的实例。
本部分介绍了如何配置 WSDL 文件的根元素,如何在任何元素中添加文档以及如何导入 XML 架构和 WSDL 文件。
根元素包含 WSDL 文件名称、目标名称空间、缺省名称空间以及名称空间前缀的属性。
配置根元素:
您可以在 WSDL 文件的任何元素中添加文档。
添加文档:
您可以使用 WSDL 编辑器来导入作为项目一部分的 XML 架构文件或其他 WSDL 文件。
导入 XML 架构:
导入其他 WSDL 文件:
WSDL 编辑器支持 W3C XML 架构中的内置简单类型。内置简单类型包括 string、date 和 integer 等类型。
您可以通过添加内联架构来定义您自己的数据类型。在 WSDL 编辑器中,可以配置一个或多个全局属性并定义结构。
添加内联架构:
配置内联架构的全局属性:
定义内联架构的结构:
您可以使用 WSDL 编辑器来创建消息。
在 WSDL 文件中,端口类型包含 Web 服务可执行的一个或多个相关操作。操作可以接收和/或发送消息。
每个消息必须包含一个或多个逻辑部件。对于每个部件,必须指定名称和内容类型。
如果更改消息或部件的名称,WSDL 编辑器将会重命名同一文件中的所有实例。要重命名关联的 XSD、WSDL 和 BPEL 文件中的所有实例,请右键单击组件节点,然后选择“重构”>“重命名”。
创建消息:
更改消息的名称:
更改部件的属性:
在现有消息中添加部件:
删除消息或部件:
您可以使用 WSDL 编辑器来创建端口类型。此外,还可以使用 WSDL 编辑器在现有端口类型中添加操作。
在 WSDL 文件中,端口类型包含 Web 服务可执行的一个或多个相关操作。GetQuote 就是一个操作示例。
WSDL 1.1 规范定义了以下操作类别:
每个消息包含一个或多个逻辑部件。对于每个部件,必须指定名称和内容类型。
如果更改端口类型或操作的名称,WSDL 编辑器将会重命名同一文件中的所有实例。要重命名关联的 XSD、WSDL 和 BPEL 文件中的所有实例,请右键单击组件节点,然后选择“重构”>“重命名”。
创建端口类型:
在现有端口类型中添加操作:
更改端口类型的名称:
更改操作的属性:
删除端口类型或操作:
您可以使用 WSDL 编辑器来创建绑定。此外,还可以修改通过“新建 WSDL 文档”向导生成的绑定。
在 WSDL 文件中,绑定为端口类型定义消息格式和协议详细信息。
您可以绑定一个遵循 SOAP 1.1 协议的绑定。绑定包含一个 SOAP 绑定节点以及一个或多个操作。每个操作可以包含以下元素:
如果更改了绑定的名称,WSDL 编辑器将会重命名同一文件中的所有实例。要重命名关联的 XSD、WSDL 和 BPEL 文件中的所有实例,请右键单击绑定节点,然后选择“重构”>“重命名”。
您可以通过现有端口类型来快速创建绑定和服务。如果随后要修改绑定,请参见创建绑定中的相应步骤。
通过端口类型创建绑定和服务:
除了通过现有端口类型快速创建绑定和服务之外,您还可以单独创建绑定、服务及其子节点。本部分介绍了如何创建绑定,以及随后如何配置 SOAP 信息。
创建绑定:
添加 SOAP 绑定节点:
为操作配置 SOAP 元素:
您可以从 WSDL 文件中删除绑定。
删除绑定:
您可以使用 WSDL 编辑器来创建服务。此外,还可以修改通过“新建 WSDL 文档”向导生成的服务。
在 WSDL 文件中,服务指示要使用的绑定以及客户端可以访问 Web 服务的位置。
您可以通过现有端口类型来快速创建绑定和服务。如果随后要修改服务,请参见创建服务中的相应步骤。
除了通过现有端口类型快速创建绑定和服务之外,您还可以单独创建绑定、服务及其子节点。本部分介绍了如何创建服务,以及随后如何配置 SOAP 信息。
在配置服务端口之前,必须创建绑定。
创建服务:
添加 SOAP 地址节点:
您可以从 WSDL 文件中删除服务或端口。
删除服务或端口:
您可以在 WSDL 文件中添加以下 BPEL 可扩展性元素:
在 BPEL 流程中添加合作伙伴链接之前,必须在 WSDL 文件中添加合作伙伴链接类型。
在 BPEL 流程中,合作伙伴链接表示 BPEL 流程与合作伙伴服务之间的交互。每个合作伙伴链接与一种合作伙伴链接类型相关联。
合作伙伴链接类型表现了两种服务之间的会话关系。合作伙伴链接类型可以具有一个或两个角色。角色用于描述服务在关系中的作用。loanRequestor 和 loanProcessor 都是角色示例。每个角色必须指定服务用于接收消息的端口类型。
自动添加合作伙伴链接类型:
手动添加合作伙伴链接类型:
BPEL 服务引擎运行环境使用称为关联的机制来跟踪多个长时间运行的有态消息交换,这些交换通常是在 BPEL 流程与其合作伙伴服务之间进行的。
在 BPEL 流程中启用关联的过程包括以下初始步骤,这些步骤必须在 WSDL 文件中执行:
在 WSDL 文件中执行这些步骤后,可以在 BPEL 流程中定义关联集。关联集引用一个或多个属性。消息活动(调用、回复和接收)和 Pick 元素的活动消息分支随后可使用该关联集。
定义属性:
定义属性别名:
您可以快速确定 WSDL 文件中使用 WSDL 组件的位置。
查找 WSDL 组件的使用实例:
Bookmark this page