第 1 章 介绍 WSDL 合同

摘要

WSDL 文档使用 Web 服务描述语言和多个可能扩展来定义服务。文档具有逻辑部分和组件。合同的抽象部分在实施中立的数据类型和消息中定义服务。文档的声明部分定义了实施服务的端点如何与外界交互。

设计服务的建议方法是先在 WSDL 和 XML 架构中定义服务，然后再编写任何代码。手动编辑 WSDL 文档时，必须确保文档有效且正确。要这样做，您必须对 WSDL 有一定的了解。您可以在 W3C 网站 www.w3.org 找到标准。

1.1. WSDL 文档的结构

概述

WSDL 文件最简单的是根 定义 元素中包含的元素集合。这些元素描述服务以及如何实施该服务的端点。

WSDL 文档有两个不同的部分：

  • 在实施中立地定义该服务 的逻辑部分
  • 定义实施该服务的端点如何在网络中公开的 部分

逻辑部分

WSDL 文档的逻辑部分包含 类型、消息 和 portType 元素。它描述了服务的接口以及该服务交换的消息。在 type 元素中，XML Schema 用于定义组成消息的数据的结构。有多个 消息 元素用于定义服务所使用的消息的结构。portType 元素包含一个或多个 操作 元素，用于定义由服务公开的操作发送的消息。

Concrete 部分

WSDL 文档的结合部分包含 绑定 和服务 元素。它描述了实施该服务的端点如何连接到外部世界。绑定 元素描述了如何 将消息 元素描述的数据单元映射到一个 Concrete 中，如 SOAP。服务 元素包含一个或多个 端口 元素，它们定义实施该服务的端点。