>> 更多 SOA 文档
本指南描述如何使用 NetBeans IDE 6.0 的 WSDL 编辑器组件。此组件包含在 SOA 功能中。
在开始之前，确保对本节的要求有所了解。
本教程假设您拥有 Java 语言和平台以及 NetBeans IDE 方面的一些基础知识或编程经验。
开始之前，需要在您的计算机中安装以下软件：
借助WSDL 编辑器，可以编辑 Web 服务描述语言（Web“服务”Description Language，WSDL）文件。
WSDL 是一种基于 XML 的语言，用于描述 web 服务。一个 WSDL 文件包含以下类型的信息：
WSDL 编辑器支持 WSDL 规范的版本 1.1。
WSDL 编辑器提供以下视图：
要创建 WSDL 文件，请使用向导。必须选择以下方法之一：
回到顶部
在“源”视图中，显示基础 XML 源码。可以直接编辑 XML。
源编辑器的顶部是每个已打开文档的选项卡。每个选项卡均显示文档的名称。如果文档被修改并且尚未保存，则名称后面将出现星号（*）。可以右击选项卡以访问各种命令。
工具栏位于 源编辑器窗口的顶部。
源编辑器中显示的源码根据语法呈现不同的颜色。
源编辑器状态栏位于水平滚动条的下方。要在插入模式和改写模式之间切换，可使用 Insert 键。
WSDL 编辑器允许在 WSDL 文件中使用以下类型的代码完成功能：
代码完成框可以包含特定于单个绑定（如 FTP 绑定）的元素和属性。
可以看到代码完成框时，可以继续键入以微调列表中的可选项目。还可以使用鼠标或导航键在列表中滚动。
要选择列表中的项目，请执行以下操作之一：
在 WSDL 编辑器的 WSDL 视图中，WSDL 文件作为树组件或一系列的列出现。
WSDL 视图有两个子视图：树视图和列视图。要在两个视图之间切换，请使用 WSDL 编辑器工具栏中的按钮。
WSDL 视图中的主节点对应于 WSDL 文件中的主要元素。
WSDL 视图中的一些节点允许您添加扩展属性。右击节点并选择“添加扩展属性”。在“添加扩展属性”对话框中，指定名称和名称空间。添加属性之后，即可从“属性”窗口指定值。要删除属性，右击节点并选择“移除属性”。
如果右击节点并选择“转到源”，此时将出现“源”视图，其中光标位于组件代码块的开始。
WSDL 文件的根元素包含 WSDL 文件的名称、目标名称空间、默认名称空间和名称空间前缀属性。可以使用 WSDL 编辑器来编辑这些属性。
要配置根元素：
可以使用 WSDL 编辑器将一个或多个 XML 模式文件导入到 WSDL 文件。
如果 XML 模式文件不能导入，则在“添加导入”对话框中此文件被删去。发生此情况可能由于以下原因：
WSDL 编辑器允许导入位于不同项目的 XML 模式文件。有关更多信息，请参阅 IDE 联机帮助中的“About Cross-Project XML“文件”References”主题。
要导入 XML 模式：
WSDL 编辑器提供了对 W3C XML 模式中的内置简单类型的支持。内置简单类型包括 string、date 和 integer 等类型。
通过添加内嵌模式，可以定义自己的数据类型。WSDL 编辑器允许配置一个或多个模式元素和类型，并允许定义元素和类型的结构。
要添加内嵌模式：
要配置内嵌模式的全局属性：
要定义内嵌模式结构：
可以使用 WSDL 编辑器将一个或多个其他 WSDL 文件导入到 WSDL 文件。
如果 WSDL 文件不能导入，则在“添加导入”对话框中此文件和文件的名称空间将被删去。发生此情况可能由于以下原因：
WSDL 编辑器允许导入位于不同项目的 WSDL 文件。有关更多信息，请参阅 IDE 联机帮助中的“About Cross-Project XML“文件”References”主题。
要导入 WSDL 文件：
可以使用 WSDL 编辑器创建、编辑和删除消息。
在 WSDL 文件中，端口类型包含 web 服务可以执行的一个或多个相关操作。操作接收消息和/或发送消息。
每条消息都包含一个或多个逻辑部分。对于各个部分，您必须指定内容的名称和类型。
如果更改消息或部分的名称，那么 WSDL 编辑器将重命名同一文件中所有出现过的此名称。要重命名关联 XSD、WSDL 和 BPEL 文件中所有出现过的此名称，右击组件节点并选择“重新构造”>“重命名”。
要创建消息：
要向消息添加一个部分：
要更改消息或部分的名称：
要删除消息或部分：
可以使用 WSDL 编辑器创建、编辑和删除端口类型。
在 WSDL 文件中，端口类型包含 web 服务可以执行的一个或多个相关操作。示例操作为 GetQuote。
WSDL 编辑器支持以下类别的操作：
如果更改端口类型或操作的名称，那么 WSDL 编辑器将重命名同一文件中所有出现过的此名称。要重命名关联 XSD、WSDL 和 BPEL 文件中所有出现过的此名称，右击组件节点并选择“重新构造”>“重命名”。
要创建端口类型：
要向现有端口类型添加操作：
向请求-响应操作添加默认值：
要更改端口类型或操作的名称：
要更改操作的参数顺序：
要删除端口类型或操作：
可以使用 WSDL 编辑器创建、编辑和删除绑定。
在 WSDL 文件中，绑定包含端口类型操作和消息的协议和数据格式信息。
WSDL 视图提供以下方法：
如果更改绑定的名称，那么 WSDL 编辑器将重命名同一文件中所有出现过的此名称。要重命名关联 XSD、WSDL 和 BPEL 文件中所有出现过的此名称，右击绑定节点并选择“重新构造”>“重命名”。
要从端口类型创建绑定和服务：
要单独创建绑定：
要删除绑定：
可以使用 WSDL 编辑器创建、编辑和删除服务。
在 WSDL 文件中，服务由一个或多个相关端口组成。每个 端口 将绑定与网络地址相关联，因此定义客户端可以访问的单个端点。
要单独创建服务：
要删除服务或端口：
合作伙伴链接类型 将说明两个服务之间的会话关系。合作伙伴链接类型可以拥有一个或两个角色。
角色描述合作伙伴在关系中的功能。例如，在供求场景中，合作伙伴链接类型可以有两个角色：Buyer 和 Seller。
一个角色必须指定服务用于接收消息的端口类型。
要自动添加合作伙伴链接类型
要手动添加合作伙伴链接类型：
BPEL 服务引擎使用名为 关联 的机制跟踪 BPEL 进程及其合作伙伴服务之间经常发生的多个、有状态的、长运行时间的消息交换。
在 BPEL 进程中启用关联的过程包括以下初始步骤，这些步骤必须在 WSDL 文件中执行：
在 WSDL 文件中执行这些步骤之后，即可在 BPEL 进程中设置关联集。关联集引用一个或多个属性。然后此关联集即可被消息活动（Invoke、Reply 和 Receive）和 Pick 元素的 onMessage 分支使用。
向 WSDL 文件添加属性：
向 WSDL 文件添加属性别名：
可以快速确定 WSDL 文件中是否使用了 WSDL 组件。
要发现是否使用了 WSDL 组件：
可以向任何 WSDL 语言元素添加文档。
要添加文档。
可以在当前的 WSDL 文件中搜索 WSDL 组件。
可以定义要执行的发现类型：
有关正则表达式的更多信息，请参阅 IDE 联机帮助中的“Regular Expressions For Finding and Replacing Text”主题。
要搜索 WSDL 组件：
搜索之后清除高亮显示：
WSDL 编辑器中的“合作伙伴”视图将 WSDL 文件中的抽象元素表示成合作伙伴之间的交互。
抽象元素包括合作伙伴链接类型、角色、端口类型、操作和消息。
合作伙伴链接类型 将说明两个服务之间的会话关系。角色 描述服务在关系中的功能。合作伙伴链接类型可以拥有一个或两个角色。
一个角色必须指定服务用于接收消息的端口类型。端口类型包含 web 服务可以执行的一个或多个相关操作。WSDL 编辑器支持以下类别的操作：
WSDL 文件的具体元素（也就是绑定和服务）描述如何调用抽象元素定义的功能。创建仅包含抽象元素的 WSDL 文件是一种有效的设计方法。可以在部署时通过使用 Composite Application Service Assembly（CASA）编辑器定义具体元素。这样，如果必须在某些时刻更改绑定，不必修改项目即可完成。
在 WSDL 编辑器的“合作伙伴”视图中，可以以合作伙伴交互为开始或以合作伙伴交流的消息为开始定义抽象元素。
要以合作伙伴交互为开始定义抽象元素：
要以消息为开始定义抽象元素：
WSDL 编辑器的“合作伙伴”视图有以下组件：
可以展开或折叠配置框。当框被折叠时，单击向下箭头可展开此框。当框被展开时，单击向上箭头可折叠此框。
IDE 的“导航”窗口提供当前所选文件的压缩视图，简化了在文件不同部分之间的导航。对于 WSDL 文件，“导航”有两个视图：WSDL 和 XML。
“导航”窗口的 WSDL 视图与 WSDL 编辑器的 WSDL 视图相同。
XML 视图使用树结构表示 WSDL 文件中的 XML 标记。
要显示 Navigator，从 IDE 的主菜单选择“窗口”>“导航”。
可以从“合作伙伴”视图的工具栏执行以下任务：
如果右击组件并选择“转到源”，此时将出现“源”视图，其中光标位于组件代码块的开始。
如果右击组件并选择“转到 WSDL”，那么 WSDL 视图将出现，并且高亮显示相应的节点。
在“合作伙伴”视图中执行一项操作之后，通过从 IDE 的主菜单选择“编辑”>“撤消”（Ctrl-Z），可以逆转此操作。通过从 IDE 的主菜单中选择“编辑”>“重做”（Ctrl-Y），可以逆转撤销操作。
通过使用 IDE 的标准打印功能，可以打印“合作伙伴”视图的内容。
“合作伙伴”视图中的“合作伙伴链接类型”区包含 WSDL 文件中各个合作伙伴链接类型的配置框，每个文件都有一个配置框。
单击以放大
合作伙伴链接类型可以拥有一个或两个角色。第一个角色出现在配置框的右侧。如果包含，则第二个角色出现在配置框的左侧。
角色的端口类型出现在角色下方。一个端口类型有一个或多个操作，它显示在端口类型下方的区域。实心的水平箭头表示一条输入消息。虚线水平箭头表示一条输出消息。
如果操作是请求-相应操作，那么可以选择添加默认值。虚线水平箭头表示一条默认消息。
来自导入的 WSDL 文件的合作伙伴链接类型不会在“合作伙伴”视图中出现。
要创建有一个角色合作伙伴链接类型：
要向合作伙伴链接类型添加另一个角色：
“合作伙伴”视图中的“合作伙伴链接类型”区允许您修改或删除 WSDL 文件中的合作伙伴链接类型、角色、端口类型和操作。
要更改合作伙伴链接类型、角色、端口类型或操作的名称：
要删除操作：
要删除端口类型：
要删除角色：
要删除合作伙伴链接类型：
“合作伙伴”视图中的“消息”区包含 WSDL 文件中消息的配置框，每个消息均有一个配置框。
“合作伙伴”视图中的“消息”区允许您修改或删除 WSDL 文件中的消息。
要更改消息的名称：
要更改部分的名称：
要更改部分的内容类型：
要删除部分：
要删除消息：
从头开始创建 WSDL 文件时，向导包含三个可供填充的页面。
这三个页面不必都填完。可以填写“名称和位置”页面，然后单击“完成”。也可以填写“名称和位置”页面和“抽象配置”页面，然后单击“完成”。
要从头开始创建 WSDL 文件：
代替从头开始创建 WSDL 文件，可以根据现有 WSDL 文件创建 WSDL 文件。
要基于现有 WSDL 文件创建 WSDL 文件：
XML 模式包含名为 NCName 的数据类型。任何拥有 NCName 数据类型的名称都必须遵守以下规则：
通过使用以下方法，可以执行重构：
还可以通过更改“名称”属性的值，重命名组件。WSDL 编辑器将重命名同一文件中所有出现过的此名称，但是不管其他文件。
WSDL 编辑器包含一个验证工具。验证工具检查 WSDL 文件的语法和语义是否存在问题。
要验证 WSDL 文件：
Bookmark this page
