WSDL Introduction

在我的先前的文章中，我已经介绍过Web服务的整个技术体系Web Service "stack"，如下图：

其中，绿色部分是先前已经定义好的并且广泛使用的传输层和网络层的标准：IP、HTTP、SMTP等。而蓝色部分是目前开发的Web服务的相关标准协议，包括服务调用协议SOAP、服务描述协议WSDL和服务发现/集成协议UDDI，以及服务工作流描述语言WSFL。而橙色部分描述的是更高层的待开发的关于路由、可靠性以及事务等方面的协议。黄色部分是各个协议层的公用机制，这些机制一般由外部的正交机制来完成。

其中，一个可以使用的Web服务应当按照需要选用若干层次的功能，而无需所有的特性。但是无论如何为了实现一个一般意义上的Web服务，具备Web服务的基础特性：跨平台调用和接口可机器识别，那么必需使用WSDL和SOAP。SOAP是用来最终完成Web服务调用的，而WSDL则是用于描述如何使用SOAP来调用Web服务的。

WSDL 是一种XML Application，他将Web服务描述定义为一组服务访问点，客户端可以通过这些服务访问点对包含面向文档信息或面向过程调用的服务进行访问(类似远程过程调用)。WSDL首先对访问的操作和访问时使用的请求/响应消息进行抽象描述，然后将其绑定到具体的传输协议和消息格式上以最终定义具体部署的服务访问点。相关的具体部署的服务访问点通过组合就成为抽象的Web服务。

在具体使用中，我们可以对 WSDL 进行扩展(类似SOAP的可扩展性)，这样无论通信时使用何种消息格式或网络协议，都可以对服务访问点及其使用的消息格式进行描述。在WSDL的框架中，可以使用任意的消息格式和网络协议，如同SOAP中可以使用任意的网络协议一样。在WSDL规范中，定义了如何使用SOAP消息格式、HTTP GET/POST消息格式以及MIME格式来完成Web服务交互的规范。

WSDL概述

由于通信协议和消息格式在 Web 技术圈子里已经达到了标准化，我们知道在通常的开发过程中，对于对象的Interface一定具备相应的SDK描述文档，Web服务也是一种对象，只不过它是被部署在Web上而已。很自然的，我们也完全需要有对Web服务这个对象的界面的SDK描述文档。然而这两者又不尽相同，一来目前在Web上的应用已经完全接受了XML这个基本的标准，基本上所有新出台的技术都是基于XML标准的，二来Web服务的目标是即时装配，松散耦合以及自动集成的，这意味着SDK描述文档应当是具备被机器识别的能力的。

也就是说，对于使用标准化的消息格式/通信协议的Web服务，它需要以某种结构化的方式(即XML)对Web服务的调用/通信加以描述，而且实现这一点也显得非常重要，这是Web服务即时装配的基本保证。WSDL正是这样一种描述语言，WSDL 定义了一套基于 XML的语法，将Web服务描述为能够进行消息交换的服务访问点的集合，从而满足了这种需求。WSDL 服务定义为分布式系统提供了可机器识别的SDK文档，并且可用于描述自动执行应用程序通信中所涉及的细节。

WSDL 文档将Web服务定义为服务访问点或端口的集合。在 WSDL 中，由于服务访问点和消息的抽象定义已从具体的服务部署或数据格式绑定中分离出来，因此可以对抽象定义进行再次使用：消息，指对交换数据的抽象描述；而端口类型，指操作的抽象集合。用于特定端口类型的具体协议和数据格式规范构成了可以再次使用的绑定。将Web访问地址与可再次使用的绑定相关联，可以定义一个端口，而端口的集合则定义为服务。因此，WSDL 文档在Web服务的定义中使用下列元素：

Types - 数据类型定义的容器，它使用某种类型系统(一般地使用XML Schema中的类型系统)。
Message - 通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。
Operation - 对服务中所支持的操作的抽象描述，一般单个Operation描述了一个访问入口的请求/响应消息对。
PortType - 对于某个访问入口点类型所支持的操作的抽象集合，这些操作可以由一个或多个服务访问点来支持。
Binding - 特定端口类型的具体协议和数据格式规范的绑定。
Port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。
Service- 相关服务访问点的集合。

大家可以参考下图，来理解一下WSDL文档的结构组织：

Figure 2. WSDL元素的对象结构示意图

其中，Types是一个数据类型定义的容器，包含了所有在消息定义中需要的XML元素的类型定义，我将在今后的文章中结合XML Schema来详细说明如何进行类型定义。

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

PortType具体定义了一种服务访问入口的类型，何谓访问入口的类型呢？就是传入/传出消息的模式及其格式。一个PortType可以包含若干个Operation，而一个Operation则是指访问入口支持的一种类型的调用。在WSDL里面支持四种访问入口调用的模式：

单请求;
单响应;
请求/响应;
响应/请求。

在这里请求指的是从客户端到Web服务端，而响应指的是从Web服务端到客户端。PortType的定义中会引用消息定义部分的一个到两个消息，作为请求或响应消息的格式。比如，一个股票查询的访问入口可能就会支持两种请求消息，一种请求消息中指明股票代码，而另一种请求消息中则会指明股票的名称，响应消息可能都是股票的价格等等。

以上三种结构描述了调用Web服务的抽象定义，这三部分与具体Web服务部署细节无关，是可复用的描述(每个层次都可以复用)。如果与一般的对象语言做比较的话，这部分可以堪称是IDL描述的对象，描述了对象的接口标准，但是到底对象是用哪种语言实现，遵从哪种平台的细节规范，被部署在哪台机器上则是后面的元素所描述的。

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

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

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

在介绍了WSDL的主要元素之后，大家会发现，WSDL的设计理念完全继承了以XML为基础的当代Web技术标准的一贯设计理念：开放。WSDL允许通过扩展使用其他的类型定义语言(不光是XML Schema)，允许使用多种网络传输协议和消息格式(不光是在规范中定义的这些：SOAP/HTTP，HTTP-GET/POST以及MIME等)。同时WSDL也应用了当代软件工程中的复用理念，分离了抽象定义层和具体部署层，使得抽象定义层的复用性大大增加。比如我们可以先使用抽象定义层为一类Web服务进行抽象定义(比如UDDI Registry，抽象定义肯定是完全一致的遵循了UDDI规范)，而不同的运营公司可以采用不同的具体部署层的描述结合抽象定义完成其自身的Web服务的描述。

WSDL文档示例

下例是一个提供股票报价的简单Web服务的 WSDL 定义。该服务支持名为 GetLastTradePrice 的单一操作，这个操作是通过在 HTTP 上运行 SOAP 1.1 协议来实现的。该请求接受一个类型为字符串的 tickerSymbol，并返回类型为浮点数的价格。

<?xml version="1.0"?>
            <definitions name="StockQuote"
            targetNamespace="http://example.com/stockquote.wsdl"
            xmlns:tns="http://example.com/stockquote.wsdl"
            xmlns:xsd1="http://example.com/stockquote.xsd"
            xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
            xmlns="http://schemas.xmlsoap.org/wsdl/">
            <types>
            <schema targetNamespace="http://example.com/stockquote.xsd"
            xmlns="http://www.w3.org/1999/XMLSchema">
            <element name="TradePriceRequest">
            <complexType>
            <all>
            <element name="tickerSymbol" type="string"/>
            </all>
            </complexType>
            </element>
            <element name="TradePriceResult">
            <complexType>
            <all>
            <element name="price" type="float"/>
            </all>
            </complexType>
            </element>
            </schema>
            </types>

上面这部分是数据类型的定义，其中为定义了两个元素的结构:

TradePriceRequest(交易价格请求): 将该元素定义为包含一个字符串元素(tickerSymbol)的复合类型元素。
TradePriceResult(交易价格): 将该元素定义为一个包含一个浮点数元素(price)的复合类型元素。

 <message name="GetLastTradePriceInput">
            <part name="body" element="xsd1:TradePriceRequest"/>
            </message>
            <message name="GetLastTradePriceOutput">
            <part name="body" element="xsd1:TradePriceResult"/>
            </message>

这部分是消息格式的抽象定义，其中定义了两个消息格式：

GetlastTradePriceInput(获取最后交易价格的请求消息格式): 由一个消息片断组成，该消息片断的名字是body，包含的具体元素类型是TradePriceRequest。(前面已经定义过了)
GetLastTradePriceOutput(获取最后交易价格的响应消息格式) : 由一个消息片断组成，该消息片断的名字是body，包含的具体元素类型是TradePriceResult。(前面已经定义过了)

 <portType name="StockQuotePortType">
            <operation name="GetLastTradePrice">
            <input message="tns:GetLastTradePriceInput"/>
            <output message="tns:GetLastTradePriceOutput"/>
            </operation>
            </portType>

这部分定义了服务访问点的调用模式的类型，表明StockQuoteService的某个入口类型是请求/响应模式，请求消息是GetlastTradePriceInput，而响应消息是GetLastTradePriceOutput。

 <binding name="StockQuoteSoapBinding" type="tns:StockQuotePortType">
            <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>
            <operation name="GetLastTradePrice">
            <soap:operation soapAction="http://example.com/GetLastTradePrice"/>
            <input>
            <soap:body use="literal" namespace="http://example.com/stockquote.xsd"
            encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
            </input>
            <output>
            <soap:body use="literal" namespace="http://example.com/stockquote.xsd"
            encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
            </output>
            </soap:operation>
            </operation>
            </soap:binding>
            </binding>

这部分将服务访问点的抽象定义与SOAP HTTP绑定，描述如何通过SOAP/HTTP来访问按照前面描述的访问入口点类型部署的访问入口。其中规定了在具体SOAP调用时，应当使用的soapAction是"http://example.com/GetLastTradePrice"，而请求/响应消息的编码风格都应当采用SOAP规范默认定义的编码风格" http://schemas.xmlsoap.org/soap/encoding/"。

 <service name="StockQuoteService">
            <documentation>股票查询服务</documentation>
            <port name="StockQuotePort" binding="tns:StockQuoteBinding">
            <soap:address location="http://example.com/stockquote"/>
            </port>
            </service>
            </definitions>

这部分是具体的Web服务的定义，在这个名为StockQuoteService的Web服务中，提供了一个服务访问入口，访问地址是"http://example.com/stockquote"，使用的消息模式是由前面的binding所定义的。

按照这个WSDL文档的描述，在具体Web服务的使用中，具体发生的SOAP交互可能如下面所示：

SOAP消息请求:

POST /StockQuote HTTP/1.1
            Host: example.com
            Content-Type: text/xml; charset="utf-8"
            Content-Length: nnnn
            SOAPAction: "http://example.com/GetLastTradePrice"
            <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
            SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
            <SOAP-ENV:Body>
            <m:TradePriceRequest xmlns:m="http://example.com/stockquote.xsd">
            <tickerSymbol>MSFT</tickerSymbol >
            </m:TradePriceRequest>
            </SOAP-ENV:Body>
            </SOAP-ENV:Envelope>

SOAP消息响应:

HTTP/1.1 200 OK
            Content-Type: text/xml; charset="utf-8"
            Content-Length: nnnn
            <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
            SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
            <SOAP-ENV:Body>
            <m:TradePriceResult xmlns:m=" http://example.com/stockquote.xsd ">
            <price>74.5</price>
            </m:TradePriceResult >
            </SOAP-ENV:Body>
            </SOAP-ENV:Envelope>

小结

在本文中，我简单介绍了WSDL规范的用途，基本结构和使用方法，在之后，我将就WSDL的元素结构细节进行展开，同时就如何在UDDI Registry中应用WSDL展开讨论。

参考资料

Web Service 技术/评论网站
- UDDI-China.ORG, 以UDDI为主的Web服务技术网站。
- WebServices.ORG, Web服务的综合类技术网站。
- IBM developerWorks/Web Service Zone, IBM的Web服务技术资源中心
- MSDN Online Web Services Developer Resources, Microsoft的Web服务的开发者资源网站
解决B2B电子商务应用交互和集成的InterOP Stack系列技术标准规范
- Web Service Description Language (WSDL) 1.0, IBM, 25 Sep 2000
- SOAP: Simple Object Access Protocol Specification 1.1, IBM, Microsoft, DevelopMentor, 2000
- Extensible Markup Language (XML) 1.0 (Second Edition), W3C, 6 Oct 2000
- UDDI程序员API规范, UDDI-China.org, UDDI.org
- UDDI数据结构参考, UDDI-China.org, UDDI.org

为什么使用WSDL?

　　像Internet协议之类的标准有没有为权威所利用，或者人们这样看待它是因为顺之所获的好处远远超出了代价？曾经有许多试图建立的标准都流产了。有时候，那些还没有普遍使用的标准甚至由法令或政府规定强行推出：Ada语言就是一例。

　　我相信正是跟随标准所带来的好处使它广泛接受。例如，对于铁路服务来说，真正重要的是，不同公司所铺设的铁路结合到一起，或者是来自好几个公司的产品协调的工作在一起。几家大的企业合力建立了SOAP标准。Web Service描述语言(WSDL)向这种Web Service的提供商和用户推出了方便的协调工作的方法，使我们能更容易的获得SOAP的种种好处。几家公司的铁道并在一起不算什么难事，他们所需遵循的只是两轨间的标准距离。对Web Service来说，这要复杂得多。我们必须先制定出指定接口的标准格式。

　　曾经有人说SOAP并不真需要什么接口描述语言。如果SOAP是交流纯内容的标准，那就需要一种语言来描述内容。SOAP消息确实带有某些类型信息，因此SOAP允许动态的决定类型。但不知道一个函数的函数名、参数的个数和各自类型，怎么可能去调用这个函数呢？没有WSDL，我可以从必备文档中确定调用语法，或者检查消息。随便何种方法，都必须有人参与，这个过程可能会有错。而使用了WSDL，我就可以通过这种跨平台和跨语言的方法使Web Service代理的产生自动化。就像COM和CORBA的IDL文件，WSDL文件由客户和服务器约定。

　　注意由于WSDL设计成可以绑定除SOAP以外的其他协议，这里我们主要关注WSDL在HTTP上和SOAP的关系。同样，由于SOAP目前主要用来调用远程的过程和函数，WSDL支持SOAP传输的文档规范。WSDL 1.1已经作为记录递交给W3C（见http://www.w3.org/TR/wsdl.html）

　　WSDL文档结构

　　若要理解XML文档，将之看作块状图表非常有用。下图以XML的文档形式说明了WSDL的结构，它揭示了WSDL文档五个栏之间的关系。

　　WSDL文档可以分为两部分。顶部分由抽象定义组成，而底部分则由具体描述组成。抽象部分以独立于平台和语言的方式定义SOAP消息，它们并不包含任何随机器或语言而变的元素。这就定义了一系列服务，截然不同的网站都可以实现。随网站而异的东西如序列化便归入底部分，因为它包含具体的定义。

　　l 抽象定义

　　　 Types

　　　　独立与机器和语言的类型定义

　　　 Messages

　　　　包括函数参数（输入与输出分开）或文档描述

　　　 PortTypes

　　　　引用消息部分中消息定义来描述函数签名（操作名、输入参数、输出参数）

　　2 具体定义

　　　 Bindings

　　　　PortTypes部分的每一操作在此绑定实现

　　　 Services

　　　　确定每一绑定的端口地址

　　下面的图中，箭头连接符代表文档不同栏之间的关系。点和箭头代表了引用或使用关系。双箭头代表"修改"关系。3-D的箭头代表了包含关系。这样，各Messages栏使用Types栏的定义，PortTypes栏使用Messages栏的定义；Bindings栏引用了PortTypes栏，Services栏引用Bindings栏，PortTypes和Bindings栏包含了operation元素，而Services栏包含了port元素。PortTypes栏里的operation元素由Bindings栏里的operation元素进一步修改或描述。

图一：抽象定义和具体定义

　　在此背景中，我将使用标准的XML术语来描述WSDL文档。Element是指XML的元素，而"attribute"指元素的属性。于是：

< element attribute ="attribute-value" > contents </ element >

内容也可能由一个或多个元素以递归的方式组成。根元素是所有元素之中最高级的元素。子元素总是从属于另一个元素，父元素。

　　注意，文档之中可能只有一个Types栏，或根本没有。所有其他的栏可以只有零元素、单元素或是多元素。WSDL的列表要求所有的栏以固定的顺序出现：import, types, message, portType, binding, service。所有的抽象可以是单独存在于别的文件中，也可以从主文档中导入。

WSDL文件示例

　　让我们来研究一下WSDL文件，看看它的结构，以及如何工作。请注意这是一个非常简单的WSDL文档实例。我们的意图只是说明它最显著的特征。以下的内容中包括更加详细的讨论。

<?xml version="1.0" encoding="UTF-8" ?>

<definitions name="FooSample"

　targetNamespace="http://tempuri.org/wsdl/"

　xmlns:wsdlns="http://tempuri.org/wsdl/"

　xmlns:typens="http://tempuri.org/xsd"

　xmlns:xsd="http://www.w3.org/2001/XMLSchema"

　xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"

　xmlns:stk="http://schemas.microsoft.com/soap-toolkit/wsdl-extension"

　xmlns="http://schemas.xmlsoap.org/wsdl/">

<types>

<schema targetNamespace="http://tempuri.org/xsd"

　　xmlns="http://www.w3.org/2001/XMLSchema"

　　xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"

　　xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"

　　elementFormDefault="qualified" >

</schema>

</types>

</message>

</message>

　</operation>

</portType>

　<stk:binding preferredEncoding="UTF-8" />

　<soap:binding style="rpc"

　　transport="http://schemas.xmlsoap.org/soap/http"/>

　　<soap:operation soapAction="http://tempuri.org/action/Simple.foo"/>

　　<input>

　　　<soap:body use="encoded" namespace="http://tempuri.org/message/"

　　　　encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />

　　</input>

　　　<soap:body use="encoded" namespace="http://tempuri.org/message/"

　　　　encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" />

　　</output>

　</operation>

</binding>

　　<soap:address location="http://carlos:8080/FooSample/FooSample.asp"/>

　</port>

</service>

</definitions>

以下是该实例文档的总述：稍后我将详细讨论每一部分的细节。

　　第一行申明该文档是XML。尽管这并不是必需的，但它有助于XML解析器决定是否解析WSDL文件或只是报错。第二行是WSDL文档的根元素：<definitions>。一些属性附属于根元素，就像<schema>子元素对于<types>元素。

　　<types>元素包含了Types栏。如果没有需要声明的数据类型，这栏可以缺省。在WSDL范例中，没有应用程序特定的types声明，但我仍然使用了Types栏，只是为了声明schema namespaces。

　　<message>元素包含了Messages栏。如果我们把操作看作函数，<message>元素定义了那个函数的参数。<message>元素中的每个<part>子元素都和某个参数相符。输入参数在<message>元素中定义，与输出参数相隔离--输出参数有自己的<message>元素。兼作输入、输出的参数在输入输出的<message>元素中有它们相应的<part>元素。输出<message>元素以"Response"结尾，就像以前所用的"fooResponse"。每个<part>元素都有名字和类型属性，就像函数的参数有参数名和参数类型。

　　用于交换文档时，WSDL允许使用<message>元素来描述交换的文档。

　　<part>元素的类型可以是XSD基类型，也可以是SOAP定义类型(soapenc)、WSDL定义类型(wsdl)或是Types栏定义的类型。

　　一个PortTypes栏中，可以有零个、单个或多个<portType>元素。由于抽象PortType定义可以放置在分开的文件中，在某个WSDL文件中没有<portType>元素是可能的。上面的例子里只是用了一个<portType>元素。而一个<portType>元素可在<operation>元素中定义一个或是多个操作。示例仅使用了一个名为"foo"的<operation>元素。这和某个函数名相同。<operation>元素可以有一个、两个、三个子元素：<input>, <output> 和<fault>元素。每个<input>和<output>元素中的消息都引用Message栏中的相关的<message>元素。这样，示例中的整个<portType>元素就和以下的C函数等效：

int foo(int arg);

这个例子足见XML和C相比要冗长的多。（包括<message>元素，XML在示例中共使用了12行代码来表达相同的单行函数声明。）

　　Bindings栏可以有零个、一个或者多个<binding>元素。它的意图是制定每个<operation>通过网络调用和回应。Services栏同样可以有零个、一个、多个<service>元素。它还包含了<port>元素，每个<port>元素引用一个Bindings栏里的<binding>元素。Bindings和Services栏都包含WSDL文档。

Namespace
<definitions>和子节点<schema>都是namespace属性：

<definitions name="FooSample"

　targetNamespace="http://tempuri.org/wsdl/"

　xmlns:wsdlns="http://tempuri.org/wsdl/"

　xmlns:typens="http://tempuri.org/xsd"

　xmlns:xsd="http://www.w3.org/2001/XMLSchema"

　xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"

　xmlns:stk="http://schemas.microsoft.com/soap-toolkit/wsdl-extension"

　xmlns="http://schemas.xmlsoap.org/wsdl/">

<types>

　<schema targetNamespace="http://tempuri.org/xsd"

　　xmlns="http://www.w3.org/2001/XMLSchema"

　　xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"

　　xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"

　　elementFormDefault="qualified" >

　</schema>

</types>

　　每个namespace属性都声明了一个缩略语，用在文档中。例如"xmlns:xsd"就为 http://www.w3.org/2001/XMLSchema定义了一个缩略语（xsd）。这就允许对该namespace的引用只需简单的在名字前加上前缀就可以了，如："xsd:int"中的"xsd"就是合法的类型名。普通范围规则可运用于缩略前缀。也就是说，前缀所定义的元素只在元素中有效。

　　Namespace派什么用？namespace的作用是要避免命名冲突。如果我建立一项Web Service，其中的WSDL文件包含一个名为"foo"的元素，而你想要使用我的服务与另一项服务连接作为补充，这样的话另一项服务的WSDL文件就不能包含名为"foo"的元素。两个服务器程序只有在它们在两个事例中表示完全相同的东西时，才可以取相同的名字。如果有了表示区别的namespace，我的网络服务里的"foo"就可以表示完全不同于另一个网络服务里"foo"的含义。在你的客户端里，你只要加以限制就可以引用我的"foo"。

　　见下例：http://www.infotects.com/fooService#foo 就是完全限制的名字，相当于"carlos:foo"，如果我声明了carlos作为http://www.infotects.com/fooService的快捷方式。请注意namespace中的URL是用来确定它们的唯一性的，同时也便于定位。URL所指向的地方不必是实际存在的网络地址，也可以使用GUID来代替或补充URL。例如，GUID"335DB901-D44A-11D4-A96E-0080AD76435D"就是一个合法的namespace指派。

　　targetNamespace属性声明了一个namespace，元素中所有的声明的名字都列于其内。在WSDL示例中，<definitions>的targetNamespace 是http://tempuri.org/wsdl。这意味着所有在WSDL文档中声明的名字都属于这个namespace。<schema>元素有自己的targetNamespace属性，其值为 http://tempuri.org/xsd ，在<schma>元素中定义的所有名字都属于这个namespace而不是main的target namespace。

　　<schema>元素的以下这行声明了默认的namespace。Schema中所有有效的名字都属于这个namespace。

xmlns="http://www.w3.org/2001/XMLSchema"

SOAP消息

　　对于使用WSDL的客户机和服务机来说，研究WSDL文件的一种方法就是决定什么来接受所发送的信息。尽管SOAP使用底层协议，如IP和HTTP等，但应用程序决定了服务器与客户机之间交互的高级协议。也就是说，进行一项操作，比如"echoint"把输入的整数送回，参数的数目、每个参数的类型、以及参数如何传送等因素决定了应用程序特定的协议。有很多方法可以确定此类协议，但我相信最好的方法就是使用WSDL。如果我们用这种视角来看待它，WSDL不只是一种接口协议，而且是一种协议特定的语言。它就是我们超越"固定"协议（IP、HTTP等）所需要的应用程序特定协议。

　　WSDL可以确定SOAP消息是否遵从RPC或文档风格。RPC风格的消息（就是示例中所用的）看起来像是函数调用。而文档风格的消息则更普通，嵌套层次更小。下面的XML消息就是示例WSDL文件解析后的发送/接受效果，解析使用的是MS SOAP Toolkit 2.0（MSTK2）中的SoapClient对象。

　　从客户端调用"foo(5131953)"函数：

＜?xml version="1.0" encoding="UTF-8" standalone="no"?＞
　＜SOAP-ENV:Envelope
　　SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
　　xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"＞
　＜SOAP-ENV:Body＞
　　＜m:foo xmlns:m="http://tempuri.org/message/"＞
　　　＜arg＞5131953＜/arg＞
　　＜/m:foo＞
　＜/SOAP-ENV:Body＞
　＜/SOAP-ENV:Envelope＞
　从服务器接受的信息：
　　＜?xml version="1.0" encoding="UTF-8" standalone="no"?＞
＜SOAP-ENV:Envelope
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"＞
＜SOAP-ENV:Body＞
＜SOAPSDK1:fooResponse xmlns:SOAPSDK1="http://tempuri.org/message/"＞
＜result＞5131953＜/result＞
＜/SOAPSDK1:fooResponse＞
＜/SOAP-ENV:Body＞
＜/SOAP-ENV:Envelope＞

　　两函数都调用了消息，其回应是有效的XML。SOAP消息由几部分组成，首先是＜Envelop＞元素，包含一个可选的＜Header＞元素以及至少一个＜body＞元素。Rpc函数所调用的消息体有一个根据操作"foo"命名的元素，而回应信息体有一个"fooResponse"元素。Foo元素有一个部分＜arg＞，就和WSDL中描述的一样，是单参数的。fooResponse也相应的有一个＜result＞的部分。注意encodingStyle、envelope和message的namespace和WSDL Bindings栏中的预定义的一致，重复如下：

＜binding name="SimpleBinding" type="wsdlns:SimplePortType"＞
＜stk:binding preferredEncoding="UTF-8" /＞
＜soap:binding style="rpc"
transport="http://schemas.xmlsoap.org/soap/http"/＞
＜operation name="foo"＞
＜soap:operation
soapAction="http://tempuri.org/action/Simple.foo"/＞
＜input＞
＜soap:body use="encoded"
namespace="http://tempuri.org/message/"
encodingStyle=
"http://schemas.xmlsoap.org/soap/encoding/" /＞
＜/input＞
＜output＞
＜soap:body use="encoded"
namespace="http://tempuri.org/message/"
encodingStyle=
"http://schemas.xmlsoap.org/soap/encoding/" /＞
＜/output＞
＜/operation＞
＜/binding＞

WSDL的Types栏和Messages栏中的XML Schema

　　WSDL数据类型是基于"XML Schema: Datatypes"(XSD)的，现在已经被W3C推荐。这一文档共有三个版本（1999，2000/10，2001），因此必须在namespace属性的＜definitions＞元素中指明所使用的是哪一个版本。

　　

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

　　在本文中，我将只考虑2001版本。WSDL标准的推荐者强烈建议使用2001版。

　　在本栏和以后各部分，需使用以下简缩或前缀

前缀	代表的Namespace	描述
Soapenc	http://schemas.xmlsoap.org/soap/encoding	SOAP 1.1 encoding
Wsdl	http://schemas.xmlsoap.org/wsdl/soap	WSDL 1.1
Xsd	http://www.w3.org/2001/XMLSchema	XML Schema

　　XSD基类型

　　下表是直接从MSTK2文档中取出的，列举了MSTK2所支持的所有XSD基类型。它也告诉在客户端或服务器端的WSDL读取程序如何把XSD类型映射到在VB、C++和IDL中相应的类型。

XSD (Soap)类型	变量类型	VB	C++	IDL	Comments
anyURI	VT_BSTR	String	BSTR	BSTR
base64Binary	VT_ARRAY \| VT_UI1	Byte()	SAFEARRAY	SAFEARRAY(unsigned char)
Boolean	VT_BOOL	Boolean	VARIANT_BOOL	VARIANT_BOOL
Byte	VT_I2	Integer	short	short	转换时验证范围有效性
Date	VT_DATE	Date	DATE	DATE	时间设为 oo:oo:oo
DateTime	VT_DATE	Date	DATE	DATE
Double	VT_R8	Double	double	double
Duration	VT_BSTR	String	BSTR	BSTR	不转换和生效
ENTITIES	VT_BSTR	String	BSTR	BSTR	不转换和生效
ENTITY	VT_BSTR	String	BSTR	BSTR	不转换和生效
Float	VT_R4	Single	float	float
GDay	VT_BSTR	String	BSTR	BSTR	不转换和生效
GMonth	VT_BSTR	String	BSTR	BSTR	不转换和生效
GMonthDay	VT_BSTR	String	BSTR	BSTR	不转换和生效
GYear	VT_BSTR	String	BSTR	BSTR	不转换和生效
GYearMonth	VT_BSTR	String	BSTR	BSTR	不转换和生效
ID	VT_BSTR	String	BSTR	BSTR	不转换和生效
IDREF	VT_BSTR	String	BSTR	BSTR	不转换和生效
IDREFS	VT_BSTR	String	BSTR	BSTR	不转换和生效
Int	VT_I4	Long	long	long
Integer	VT_DECIMAL	Variant	DECIMAL	DECIMAL	转换时范围生效
Language	VT_BSTR	String	BSTR	BSTR	不转换和生效
Long	VT_DECIMAL	Variant	DECIMAL	DECIMAL	转换时范围生效
Name	VT_BSTR	String	BSTR	BSTR	不转换和生效
NCName	VT_BSTR	String	BSTR	BSTR	不转换和生效
negativeInteger	VT_DECIMAL	Variant	DECIMAL	DECIMAL	转换时范围生效
NMTOKEN	VT_BSTR	String	BSTR	BSTR	不转换和生效
NMTOKENS	VT_BSTR	String	BSTR	BSTR	不转换和生效
nonNegativeIntege	VT_DECIMAL	Variant	DECIMAL	DECIMAL	转换时范围生效
nonPositiveInteger	VT_DECIMAL	Variant	DECIMA	DECIMAL	转换时范围生效
normalizedString	VT_BSTR	String	BSTR	BSTR
NOTATION	VT_BSTR	String	BSTR	BSTR	不转换和生效
Number	VT_DECIMAL	Variant	DECIMAL	DECIMAL
positiveInteger	VT_DECIMAL	Variant	DECIMAL	DECIMAL	转换时范围生效
Qname	VT_BSTR	String	BSTR	BSTR	不转换和生效
Short	VT_I2	Integer	short	short
String	VT_BSTR	String	BSTR	BSTR
Time	VT_DATE	Date	DATE	DATE	日设为1899年12月30日
Token	VT_BSTR	String	BSTR	BSTR	不转换和生效
unsignedByte	VT_UI1	Byte	unsigned char	unsigned char
UnsignedInt	VT_DECIMAL	Variant	DECIMAL	DECIMAL	转换时范围生效
unsignedLong	VT_DECIMAL	Variant	DECIMAL	DECIMAL	转换时范围生效
unsignedShort	VT_UI4	Long	Long	Long	转换时范围生效

　　XSD定义了两套内建的数据类型：原始的和派生的。在下文中查阅内建数据类型的层次十分有益：

http://www.w3.org/TR/2001/PR-xmlschema-2-20010330

　　complex类型

　　XML schema允许complex类型的定义，就像C里是struct。例如，为了定义类似如下的C的struct类型：

typedef struct {
　string firstName;
　string lastName;
　long ageInYears;
　float weightInLbs;
　float heightInInches;
} PERSON;

　　我们可以写XML schema：

＜xsd:complexType name="PERSON"＞
＜xsd:sequence＞
　＜xsd:element name="firstName" type="xsd:string"/＞
　＜xsd:element name="lastName" type="xsd:string"/＞
　＜xsd:element name="ageInYears" type="xsd:int"/＞
　＜xsd:element name="weightInLbs" type="xsd:float"/＞
　＜xsd:element name="heightInInches" type="xsd:float"/＞
＜/xsd:sequence＞
＜/xsd:complexType＞

　　不过，complex类型可以表达比struct更多的信息。除了＜sequence＞以外，它还可以有其他的子元素，比如＜all＞

＜xsd:complexType name="PERSON"＞
＜xsd:all＞
　＜xsd:element name="firstName" type="xsd:string"/＞
　＜xsd:element name="lastName" type="xsd:string"/＞
　＜xsd:element name="ageInYears" type="xsd:int"/＞
　＜xsd:element name="weightInLbs" type="xsd:float"/＞
　＜xsd:element name="heightInInches" type="xsd:float"/＞
＜/xsd:all＞
＜/xsd:complexType＞

　　这意味着＜element＞的成员变量可以以任何顺序排列，每一个都是可选的。这和C中的struct类型不太一样。

　　注意内建数据类型string, int, float。C的string也是XML的string，float也类似。但C中的long类型在XML中是int（上表中）。

　　在WSDL文件中，像上面的complex类型可以在Types栏声明。例如，我可以用以下方式声明PERSON类型并用在Messages栏。

　　上例中第一个消息由"adperson"，并且有一个＜part＞，其类型为"PERSON"。PERSON类型是在Types栏声明的。

　　如果我们使用完整的WSDL文件包含以上的部分，并以之初始化MSTK2 SoapClient，它将成功的解析该文件。当然，它不会去调用＜addPerson＞。这是因为SoapClient本身并不知道如何处理complex类型，它需要定制类型映射来处理complex类型。MSTK2文档中有包含定制类型映射的示例。

　　还有另一种方法可以把＜part＞元素联系到类型声明。这就是使用元素。下例中我将Types栏中声明两个元素（"Person"和"Gendr"），然后我将在"addPerson"＜message＞中使用元素属性来引用它们。

＜?xml version="1.0" encoding="UTF-8" ?＞
＜definitions … ＞
＜types＞
＜schema targetNamespace="someNamespace"
　xmlns:typens="someNamespace" ＞
＜element name="Person"＞
＜xsd:complexType＞
　＜xsd:sequence＞
　　＜xsd:element name="firstName" type="xsd:string"/＞
　　＜xsd:element name="lastName" type="xsd:string"/＞
　　＜xsd:element name="ageInYears" type="xsd:int"/＞
　　＜xsd:element name="weightInLbs" type="xsd:float"/＞
　　＜xsd:element name="heightInInches" type="xsd:float"/＞
　＜/xsd:sequence＞
＜/xsd:complexType＞
＜/element＞
＜element name="Gender"＞
＜xsd:simpleType＞
　＜xsd:restriction base="xsd:string"＞
　　＜xsd:enumeration value="Male" /＞
　　＜xsd:enumeration value="Female" /＞
　＜/xsd:restriction＞
＜/xsd:simpleType＞
＜/element＞
＜/schema＞
＜/types＞

＜message name="addPerson"＞
　＜part name="who" element="typens:Person"/＞
　＜part name="sex" element="typens:Gender"/＞
＜/message＞

＜message name="addPersonResponse"＞
　＜part name="result" type="xsd:int"/＞
＜/message＞
＜/definitions＞

　　Types栏中的Gender＜element＞里嵌入了枚举类型，其枚举值为"Male""Female"。然后我又在"addPerson"＜message＞中通过元素属性而不是类型属性来引用它。

　　"元素属性"和"类型属性"在把某特定类型关联到＜part＞时有什么不同呢？使用元素属性，我们可以描述一个部分，它可以假定几个类型（就像变量一样），而是用类型属性我们就无法这样做。下例说明了这一点。

＜?xml version="1.0" encoding="UTF-8" ?＞
＜definitions … ＞
＜types＞
＜schema targetNamespace="someNamespace"
xmlns:typens="someNamespace"＞
＜xsd:complexType name="PERSON"＞
　＜xsd:sequence＞
　　＜xsd:element name="firstName" type="xsd:string"/＞
　　＜xsd:element name="lastName" type="xsd:string"/＞
　　＜xsd:element name="ageInYears" type="xsd:int"/＞
　　＜xsd:element name="weightInLbs" type="xsd:float"/＞
　　＜xsd:element name="heightInInches" type="xsd:float"/＞
　＜/xsd:sequence＞
＜/xsd:complexType＞
＜xsd:complexType name="femalePerson"＞
＜xsd:complexContent＞
　＜xsd:extension base="typens:PERSON" ＞
　＜xsd:element name="favoriteLipstick" type="xsd:string" /＞
＜/xsd:extension＞
＜/xsd:complexContent＞
＜/xsd:complexType＞
＜xsd:complexType name="malePerson"＞
＜xsd:complexContent＞
＜xsd:extension base="typens:PERSON" ＞
＜xsd:element name="favoriteShavingLotion" type="xsd:string" /＞
＜/xsd:extension＞
＜/xsd:complexContent＞
＜/xsd:complexType＞
＜xsd:complexType name="maleOrFemalePerson"＞
＜xsd:choice＞
　＜xsd:element name="fArg" type="typens:femalePerson" ＞
　＜xsd:element name="mArg" type="typens:malePerson" /＞
＜/xsd:choice＞
＜/xsd:complexType＞
＜/schema＞
＜/types＞

＜message name="addPerson"＞
　＜part name="person" type="typens:maleOrFemalePerson"/＞
＜/message＞

＜message name="addPersonResponse"＞
　＜part name="result" type="xsd:int"/＞
＜/message＞

＜/definitions＞

　　上例也告诉我们extension的派生。"femailPerson"和"malePerson"都是从"PERSON"派生出来的。它们各有一些额外的元素："femalePerson"有"favoriteLipstick"元素，"malePerson"有"favoriteShavingLotion"元素。两派生类型都归入一个complex类型"maleOrFemalePerson"，使用的是＜choice＞构造。最后，在"adperson"＜message＞中，新类型有"person"＜part＞引用。这样，参数或＜part＞就可以是"femalePerson"或"malePerson"了。
数组

　　XSD提供＜list＞结构来声明一个数组，元素之间有空格界定。不过SOAP不是使用XSD来编码数组的，它定义了自己的数组类型--"SOAP-ENC: Array"。下列的例子揭示了从这一类型派生出一位整数数组的方法：

＜xsd:complexType name="ArrayOfInt"＞
＜xsd:complexContent＞
　＜xsd:restriction base="soapenc:Array"＞
　　＜attribute ref="soapenc:arrayType" wsdl:arrayType="xsd:int[]"/＞
　＜/xsd:restriction＞
＜/xsd:complexContent＞
＜/xsd:complexType＞

　　新的complex类型从soapenc:array限制派生。然后又声明了complex类型的一个属性。引用"soapenc:arrayType"实际上是这样完成的：

＜xsd:attribute name="arrayType" type="xsd:string"/＞

　　wsdl:arrayType属性值决定了数组每个成员的类型。数组的成员也可以是Complex类型。：

＜xsd:complexType name="ArrayOfPERSON"＞
＜xsd:complexContent＞
＜xsd:restriction base="soapenc:Array"＞
＜attribute ref="soapenc:arrayType"
wsdl:arrayType="typens:PERSON[]"/＞
＜/xsd:restriction＞
＜/xsd:complexContent＞
＜/xsd:complexType＞

　　WSDL要求数组的类型由"ArrayOf"和每个数组元素的类型串联而成。很显然，顾名思义，"ArrayOfPERSON"是PERSON结构的数组。下面我将使用ArrayOfPERSON来声明一个＜message＞，并加入不止一个PERSON：

　　＜portType＞和＜operation＞元素

　　PortType定义了一些抽象的操作。PortType中的operation元素定义了调用PortType中所有方法的语法，每一个operation元素声明了方法的名称、参数（使用＜message＞元素）和各自的类型（＜part＞元素要在所有＜message＞中声明）。

　　在一篇WSDL文档中可以有几个＜PortType＞元素，每一个都和一些相关操作放在一起，就和COM和一组操作的接口相似。

　　在＜operation＞元素中，可能会有至多一个＜input＞元素，一个＜output＞元素，以及一个＜fault＞元素。三个元素各有一个名字和一个消息属性。

　　＜input＞, ＜output＞, ＜fault＞元素属性的名字有何含义呢？它们可以用来区别两个同名操作（重载）。例如，看下面两个C函数：

void foo(int arg);
void foo(string arg);

　　这种重载在WSDL中可以这样表示：

＜?xml version="1.0" encoding="UTF-8" ?＞
＜definitions name="fooDescription"
　targetNamespace="http://tempuri.org/wsdl/"
　xmlns:wsdlns="http://tempuri.org/wsdl/"
　xmlns:typens="http://tempuri.org/xsd"
　xmlns:xsd="http://www.w3.org/2001/XMLSchema"
　xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
　xmlns:stk="http://schemas.microsoft.com/soap-toolkit/wsdl-
　extension"
　xmlns="http://schemas.xmlsoap.org/wsdl/"＞
＜types＞
＜schema targetNamespace="http://tempuri.org/xsd"
　xmlns="http://www.w3.org/2001/XMLSchema"
　xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
　xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
　elementFormDefault="qualified" ＞
＜/schema＞
＜/types＞

＜message name="foo1"＞
　＜part name="arg" type="xsd:int"/＞
＜/message＞

＜message name="foo2"＞
　＜part name="arg" type="xsd:string"/＞
＜/message＞

＜portType name="fooSamplePortType"＞
＜operation name="foo" parameterOrder="arg " ＞
　＜input name="foo1" message="wsdlns:foo1"/＞
＜/operation＞
＜operation name="foo" parameterOrder="arg " ＞
　＜input name="foo2" message="wsdlns:foo2"/＞
＜/operation＞
＜/portType＞

＜binding name="fooSampleBinding" type="wsdlns:fooSamplePortType"＞
＜stk:binding preferredEncoding="UTF-8" /＞
＜soap:binding style="rpc"
transport="http://schemas.xmlsoap.org/soap/http"/＞
＜operation name="foo"＞
＜soap:operation soapAction="http://tempuri.org/action/foo1"/＞
　＜input name="foo1"＞
　　＜soap:body use="encoded" namespace="http://tempuri.org/message/"
　　　　encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" /＞
　＜/input＞
＜/operation＞
＜operation name="foo"＞
＜soap:operation soapAction="http://tempuri.org/action/foo2"/＞
＜input name="foo2"＞
＜soap:body use="encoded"
　　　namespace="http://tempuri.org/message/"
　　　encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
/＞
＜/input＞
＜/operation＞
＜/binding＞

＜service name="FOOService"＞
＜port name="fooSamplePort" binding="fooSampleBinding"＞
＜soap:address
　　location="http://carlos:8080/fooService/foo.asp"/＞
＜/port＞
＜/service＞
＜/definitions＞

　　到目前为止，还没有一种SOAP的实现支持重载。这对基于JAVA的客户端十分重要，因为JAVA服务器使用的接口用到JAVA的重载特性。而对基于COM的客户端，就不那么重要，因为COM是不支持重载的。
＜binding＞和＜operation＞元素

　　Binding栏是完整描述协议、序列化和编码的地方，Types, Messages和PortType栏处理抽象的数据内容，而Binding栏是处理数据传输的物理实现。Binding栏把前三部分的抽象定义具体化。

　　把相关的数据制定和消息声明分开，这意味着同一类型服务的提供者可以把一系列的操作标准化。每个提供者可以提供定制的binding来互相区分。WSDL也有一个重要的结构，使抽象定义可以放在分离的文件中，而不是和Bindings和Services在一起，这样可在不同的服务提供者之间提供标准化的抽象定义，这很有帮助。例如，银行可以用WSDL文档来标准化一些银行的操作。每个银行仍然可以自由的订制下层的协议、串行优化，及编码。

　　下面是重载的WSDL示例的Binding栏，重复在此以便讨论：

＜binding name="fooSampleBinding" type="wsdlns:fooSamplePortType"＞
＜stk:binding preferredEncoding="UTF-8" /＞
＜soap:binding style="rpc"
　transport="http://schemas.xmlsoap.org/soap/http"/＞
＜operation name="foo"＞
　＜soap:operation soapAction="http://tempuri.org/action/foo1"/＞
　　＜input name="foo1"＞
　　　＜soap:body use="encoded" namespace="http://tempuri.org/message/"
　　　　　　　　　encodingStyle=
　　　　　　　　 "http://schemas.xmlsoap.org/soap/encoding/" /＞
　　＜/input＞
　＜/operation＞
＜operation name="foo"＞
＜soap:operation soapAction="http://tempuri.org/action/foo2"/＞
　＜input name="foo2"＞
　　＜soap:body use="encoded"
　　　　　　　　　　namespace="http://tempuri.org/message/"
　　　　　　　　encodingStyle=
　　　　　　　　　　"http://schemas.xmlsoap.org/soap/encoding/" /＞
　＜/input＞
＜/operation＞
＜/binding＞

　　＜binding＞元素已经取了一个名字（本例中"fooSampleBinding"），这样就可以被Services栏的＜port＞元素引用了。它有一个"type"的属性引用＜portType＞，本例中就是"wsdlns:fooSamplePortType"。第二行是MSTK2的扩展元素＜stk:binding＞，它指定了preferredEncoding属性为"UTF-8"。

　　＜soap:binding＞元素指定了所使用的风格（"rpc"）和传输方式。Transport属性应用了一个namespace，正是这个namespace指明使用HTTP SOAP协议。

　　有两个同以"foo"命名的＜operation＞元素。唯一不同的是它们各自的＜input＞名字，分别为"foo1"和"foo2"。两个＜operation＞元素中的＜soap:operation＞元素有同样的"soapAction"属性，是URI。soapAction属性是SOAP特定的URI，它只是简单的使用于SOAP消息。所产生的SOAP消息有一个SOAPAction头，而URI也仅在＜soap:operation＞元素里才起作用。soapAction属性在HTTP的binding中是必需的，但在其他非HTTP binding中却不要提供。目前它的使用并不清楚，但它似乎有助于本例中的两个"foo"操作。SOAP 1.1指明soapAction用来确定消息的"意图"。似乎服务器可以在不解析整个消息的情况下就能使用这一属性来发送消息。实际上，它的使用多种多样。＜soap:operation＞元素也可以包含另一属性，即"style"属性，在有必要冲突＜soap:binding＞元素指定的风格时可以使用。

　　＜operation＞属性可以包含＜input＞, ＜output＞和＜fault＞的元素，它们都对应于PortType栏中的相同元素。只有＜input＞元素在上例中提供。这三个元素中的每一个可有一个可选的"name"属性，在本例中，我们用这种方法来区分同名操作。在本例的＜input＞元素中有一个＜soap:body＞元素，它指定了哪些信息被写进SOAP消息的信息体中。该元素有以下属性：

　　Use

　　　用于制定数据是"encoded"还是"literal"。"Literal"指结果SOAP消息包含以抽象定义（Types, Messages, 和PortTypes）指定格式存在的数据。"Encoded"指"encodingStyle"属性决定了编码方式。

　　Namespace

　　　每个SOAP消息体可以有其自己的namespace来防止命名冲突。这一属性制定的URI在结果SOAP消息中逐字使用。

　　EncodingStyle

　　　对SOAP编码，它应该有以下URI值：

"http://schemas.xmlsoap.org/soap/encoding"

文档风格实现

　　在前几栏中，＜soap:binding＞元素有一个类型属性，设为"rpc"。此属性设为"document"时会改变传输时消息的串行化。不同于函数签名，现在的消息是文档传输的。在这类binding中，＜message＞元素定义文档格式，而不是函数签名。作为例子，考虑以下WSDL片段：

＜definitions
xmlns:stns="(SchemaTNS)"
xmlns:wtns="(WsdlTNS)"
targetNamespace="(WsdlTNS)"＞

＜schema targetNamespace="(SchemaTNS)"
elementFormDefault="qualified"＞
＜element name="SimpleElement" type="xsd:int"/＞
＜element name="CompositElement" type="stns:CompositeType"/＞
＜complexType name="CompositeType"＞
＜all＞
　＜element name='a' type="xsd:int"/＞
　＜element name='b' type="xsd:string"/＞
＜/all＞
＜/complexType＞
＜/schema＞

＜message...＞
　＜part name='p1' type="stns:CompositeType"/＞
　＜part name='p2' type="xsd:int"/＞
　＜part name='p3' element="stns:SimpleElement"/＞
　＜part name='p4' element="stns:CompositeElement"/＞
＜/message＞
…
＜/definitions＞

　　schema有两个元素：SimpleElement和CompositeElement，还有一个类型声明（CompositeType）。唯一声明的＜message＞元素有四个部分：p1：Composite型；p2：int型；p3：SimpleElement型；p4：CompositeElement型。以下有一个表，对四种类型的use/type决定的binding作一比较：rpc/literal, document/literal, rpc/encoded, 以及document/encoded。表指明了每种binding的表现。

　　＜service＞和＜port＞元素

　　service是一套＜port＞元素。在一一对应形式下，每个＜port＞元素都和一个location关联。如果同一个＜binding＞有多个＜port＞元素与之关联，可以使用额外的URL地址作为替换。
一个WSDL文档中可以有多个＜service＞元素，而且多个＜service＞元素十分有用，其中之一就是可以根据目标URL来组织端口。这样，我就可以方便的使用另一个＜service＞来重定向我的股市查询申请。我的客户端程序仍然工作，因为这种根据协议归类的服务不随服务而变化。多个＜service＞元素的另一个作用是根据特定的协议划分端口。例如，我可以把所有的HTTP端口放在同一个＜service＞中，所有的SMTP端口放在另一个＜service＞里。我的客户可以搜索与它可以处理的协议相匹配的＜service＞。

＜service name="FOOService"＞
＜port name="fooSamplePort" binding="fooSampleBinding"＞
　＜soap:address
　　　location="http://carlos:8080/fooService/foo.asp"/＞
＜/port＞
＜/service＞

　　在一个WSDL文档中，＜service＞的name属性用来区分不同的service。因为同一个service中可以有多个端口，它们也有"name"属性。

　　总结

　　本文中我描述了WSDL文档关于SOAP方面的最显著的特点。不过应该说明的是WSDL并不仅限于HTTP上的SOAP。WSDL用来描述HTTP-POST、HTTP-GET、SMTP及其他协议时非常清晰。使用了WSDL，SOAP更加容易处理了，无论是开发者还是使用者。我相信WSDL和SOAP一起将会开创网络应用程序世界的新时代。

　　WSDL的namespace里有一系列的XML元素。下表概述了那些元素、它们的属性和内容。

元素	属性	内容（子元素）
＜definitions＞	name targetNamespace xmlns (other namespaces)	＜types＞＜message＞＜portType＞＜binding＞＜service＞
＜types＞	(none)	＜xsd:schema＞
＜message＞	Name	＜part＞
＜portType＞	Name	＜operation＞
＜binding＞	name type	＜operation＞
＜service＞	name	＜port＞
＜part＞	name type	(empty)
＜operation＞	name parameterOrder	＜input＞＜output＞＜fault＞
＜input＞	name message	(empty)
＜output＞	name message	(empty)
＜fault＞	name message	(empty)
＜port＞	name binding	＜soap:address＞

　　　

　　资源：

　　1. WSDL 1.1

　　2. SOAP 1.1

　　3. XML Schema Primer

　　4. MS SOAP Toolkit Download Site

　　5. A tool for translating IDL to WSDL

　　6. Free Web Services resources including a WSDL to VB proxy generator

　　7. PocketSOAP: SOAP related components, tools & source code

posted on 2007-12-05 17:17 mjgforever 阅读(957) 评论(0) 编辑收藏举报

刷新页面返回顶部

毛毛的小窝 — 关注技术交流、让我们一起成长

导航

公告

WSDL Introduction