解析Web接口描述语言WSDL

一、概述

　　Web服务定义语言(Web Services Definition Language，WSDL)是一个建议性标准，用于描 述Web服务的技术调用语法。WSDL定义了一套基于 XML的语法，将Web服务描述为能够进行消息交换的服务访问点的集合，从而满足了这种需求。WSDL服务定义为分布式系统提供了可机器识别的SDK文档，并且可用于描述自动执行应用程序通信中所涉及的细节。WSDL的当前版本是1.1，规范可以从http://www.w3.org/TR/wsdl获得。

　　WSDL就是描述XMLWeb服务的标准XML格式，WSDL由Ariba、Intel、IBM和微软等开发商提出。它用一种和具体语言无关的抽象方式定义了给定Web服务收发的有关操作和消息。就其定义来说，你还不能把WSDL当作一种对象接 口定义语言，例如，CORBA或COM等应用程序体系结构就会用到对象接口定义语言。 WSDL保持协议中立，但它确实内建了绑定SOAP的支持，从而同SOAP建立了不可分割的联系。

　　WSDL服务描述是一个XML文档，它与WSDL模式(schema)的定义一致。WSDL文档并不是完整的服务描述，而只包括了服务描述任务的较低层次，即：服务接口的原始技术描述。WSDL是Web服务的接口定义语言IDL（Interface Definition Language，），本质上，WSDL描述说明的是Web服务的以下三个基本属性：

　　服务做些什么--服务所提供的操作(方法)。
　　如何访问服务--数据格式详情以及访问服务操作的必要协议。
　　服务位于何处--由特定协议决定的网络地址，如URL。

二、WSDL文档结构

• WSDL信息模型充分利用了抽象规范与规范具体实现的分离方法，也就是分离了服务接口定义(抽象接口)与服务实现定义(具体端点)。
•  抽象接口规范描述了终端的处理能力，它在WSDL中表示为portType。
• 束定机制 (binding mechanism)在WSDL中表示为binding元素，它使用特定的通信协议、数据编码模型和底层通信协议，将Web服务的抽象定义映射至特定实现。
• 若束定结合了实现的访问地址，抽象端点也就成为可供服务请求者调用的具体端点(concrete endpoint)，WSDL的port元素表示了这一结合。
  
• 抽象接口可以支持任何数量的操作(operations)。
• 操作是由一组消息(messages)定义，消息定义了操作的交互定式。
• 与抽象的消息、操作概念相对应的具体实现是由binding元素指定。

与XML应用相同，WSDL模式定义了几个高层元素，或称为主要元素。在WSDL中，Web服务描述中的主要元素如下：

1. 　　Types，定义了Web服务使用的所有数据类型集合，可被元素的各消息部件所引用。它使用某种类型系统(一般地使用XMLSchema中的类型系统)。
2. 　　Message，通信消息数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。
3. 　　Operation，对服务中所支持操作的抽象描述。一般单个Operation描述了一个访问入口的请求/响应消息对。
4. 　　PortType，对于某个访问入口点类型所支持操作的抽象集合。这些操作可以由一个或多个服务访问点来支持。
5. 　　Binding，包含了如何将抽象接口的元素(portType)转变为具体表示的细节，具体表示也就是指特定的数据格式和协议的结合；特定端口类型的具体协议和数据格式规范的绑定。
6. 　　Port，定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。
7. 　　Service，这是一个粗糙命名的元素，代表端口的集合；相关服务访问点的集合。

　因此，portType(与message和type元素的细节相结合)描述了Web服务是什么，binding元素描述了如何使用Web服务，port及service元素描述了Web服务的位置。

图1 WSDL信息模型

　　图1体现了WSDL信息模型的一个可能结构，它清楚反映了portType元素包含的抽象消息/操作和binding元素的具体消息/操作间的关系。图中的黑体字突出了WSDL规范中的术语。WSDL使用的元素名称有些含糊，由于不存在能够区分抽象和具体概念的一致命名原则，因此必须记住哪一个元素代表抽象概念，哪一个元素代表具体的概念。

2、WSDL对象结构图

　　从图2所示的WSDL对象结构图可知，一个WSDL文档中可以包含一个Types，多个Message、PortType、Binding和Service。

图2 WSDL对象结构图

　　其中，Types是一个数据类型定义的容器，包含了所有在消息定义中需要的XML元素的类型定义。

　　Message具体定义了在通信中使用的消息的数据结构，Message元素包含了一组Part元素，每个Part元素都是最终消息的一个组成部分，每个Part都会引用一个DataType来表示它的结构。Part元素不支持嵌套(可以使用DataType来完成这方面的需要)，都是并列出现。

　　PortType具体定义了一种服务访问入口的类型（传入/传出消息的模式及其格式），一个PortType可以包含若干个Operation，而一个Operation则是指访问入口支持的一种类型的调用。在WSDL里面支持四种访问入口调用的模式：1) 单请求; 2) 单响应; 3) 请求/响应; 4) 响应/请求。在这里请求指的是从客户端到Web服务端，而响应指的是从Web服务端到客户端。PortType的定义中会引用消息定义部分的一个到两个消息，作为请求或响应消息的格式。 

　　Service描述的是一个具体的被部署的Web服务所提供的所有访问入口的部署细节，一个Service往往会包含多个服务访问入口，而每个访问入口都会使用一个Port元素来描述。

　　Port描述的是一个服务访问入口的部署细节，包括通过哪个Web地址(URL)来访问，应当使用怎样的消息调用模式来访问等。其中消息调用模式则是使用Binding结构来表示。

　　Binding结构定义了某个PortType与某一种具体的网络传输协议或消息传输协议相绑定，从这一层次开始，描述的内容就与具体服务的部署相关了。比如可以将PortType与SOAP/HTTP绑定，也可以将PortType与MIME/SMTP相绑定等。

　　3、WSDL文档类型

　　WSDL文档被分为两种类型：服务接口（service interface ）和服务实现（service implementations）。（如下图3所示）

图3 WSDL文档类型

　　服务接口由 WSDL文档来描述，这种文档包含服务接口的 types、import、message、portType 和 binding 等元素。服务接口包含将用于实现一个或多个服务的 WSDL服务定义。它是 Web 服务的抽象定义，并被用于描述某种特定类型的服务。

　　通过使用一个 import 元素，一个服务接口文档可以引用另一个服务接口文档。例如，一个仅包含 message 和 portType 元素的服务接口可以被另一个仅包含此 portType 的绑定的服务接口引用。

　　WSDL服务实现文档将包含 import 和 service 元素。服务实现文档包含实现一个服务接口的服务的描述。import 元素中至少会有一个将包含对 WSDL服务接口文档的引用。一个服务实现文档可以包含对多个服务接口文档的引用。

　　WSDL服务实现文档中的 import 元素包含两个属性。namespace 的属性值是一个与服务接口文档中的 targetNamespace 相匹配的URL。location 属性是一个用于引用包含完整的服务接口定义的 WSDL文档的 URL。port 元素的 binding 属性包含对服务接口文档中的某个特定绑定的引用。

　　服务接口文档由服务接口提供者开发和发布。服务实现文档由服务提供者创建和发布。服务接口提供者与服务提供者这两个角色在逻辑上是分离的，但他们可以是同一个商业实体。 

　　一个完整的 WSDL服务描述是由一个服务接口和一个服务实现文档组成的。

　　4、WSDL工具

　　你可以手工创建WSDL文件，不过，你还可以采用相当多的工具通过WSDL来为你自动处理和定义Web服务。推荐工具软件如下：

　　Omniopera----图形用户界面的WSDI、XML和XSD编辑器。 
　　Microsoft的SOAP Toolkit----一种工具包，其中包括根据WSDL定义创建COM接口的向导程序，还包括根据COM接口创建WSDL的向导程序。
　　IBM的Web Services Toolkit----一种工具包，其中包括产生WSDL和SOAP部署说明的向导程序。

　三、WSDL扩展机制

　　WSDL设计继承了以XML为基础的当代Web技术标准的开放设计理念。它允许通过扩展使用其它的类型定义语言(不光是XMI Schema)，允许使用多种网络传输协议和消息格式(不仅是在规范中定义的SOAP/HTTP、HTTP-GET/POST及MIME等)。WSDL也应用了当代软件工程中的复用理念，分离了抽象定义层和具体部署层，使得抽象定义层的复用性大大增加。

　　1、 SOAP绑定

　　WSDL包括用于SOAP 1.1终端的绑定，此绑定支持下列协议信息规范：

　　需要指示出此绑定是针对SOAP 1.1协议的。
　　为SOAP 终端指定地址的方式。
　　用于SOAPAction HTTP头的URI，而此头是绑定了SOAP 的HTTP头。
　　作为SOAP封装一部分传送的头列表定义。

　　SOAP绑定使用下列扩展元素对WSDL进行扩展：（注意黑体标注）

＜definitions .... ＞
＜binding .... ＞
＜soap:binding style="rpc|document" transport="uri"＞ …1
＜operation .... ＞
＜soap:operation soapAction="uri" style="rpc|document"＞ …2
＜input＞
＜soap:body parts="nmtokens" use="litera　　|encoded"
encodingStyle="uri-list" namespace="uri"＞…3
＜soap:header message="qname" fault="qname"/＞ …4 
＜/input＞
＜output＞
＜soap:body parts="nmtokens" use="litera　　|encoded"
encodingStyle="uri-list"? namespace="uri"/＞…3
＜soap:header message="qname" fault="qname"/＞ …4 
＜/output＞
＜fault＞
＜soap:fault name="nmtoken" use="litera　　|encoded"
encodingStyle="uri-list" namespace="uri"＞…5
＜/fault＞
＜/operation＞
＜/binding＞
＜port .... ＞
＜soap:address location="uri"/＞ …6
＜/port＞
＜/definitions＞

　　1）soap:binding

　　SOAP绑定元素的目的是指出绑定是针对SOAP协议格式的：Envelope, Header 和 Body。这个元素没有对编码或消息格式进行声明。在使用SOAP绑定时必须指出soap:binding元素。

　　2）soap:operation

　　soap:operation 元素从整体上为操作提供信息。

　　style属性指出操作是面向RPC（消息包含参数和返回值）的还是面向文档的（消息包含文档）。此信息可用于选择合适的编程模板。此属性的值将影响SOAP消息体的构建方式，如果没有指定值，它默认为soap:binding元素中指定的值。如果soap:binding元素没有指定样式，它假定为"文档"。

　　soapAction属性为此操作的SOAPAction头指定了值。此URI应当被直接用作SOAPAction头的值，在作出请求时不要试图将一个相对URI变成绝对URI。对于绑定了SOAP的HTTP协议来说，此值是必需的（它没有默认值）。对于其它的SOAP协议绑定，决对不能为其指定值，而soap:operation元素可以被忽略。