Web Service描述语言 WSDL 详解(2)

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 name="Simple.foo"＞ 　＜part name="arg" type="xsd:int"/＞ ＜/message＞ ＜message name="Simple.fooResponse"＞ 　＜part name="result" type="xsd:int"/＞ ＜/message＞ ＜portType name="SimplePortType"＞ 　＜operation name="foo" parameterOrder="arg" ＞ 　　＜input message="wsdlns:Simple.foo"/＞ 　　＜output message="wsdlns:Simple.fooResponse"/＞ 　＜/operation＞ ＜/portType＞ ＜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＞ ＜service name="FOOSAMPLEService"＞ 　＜port name="SimplePort" binding="wsdlns:SimpleBinding"＞ 　　＜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文档。