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

数组

　　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：

＜?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="ArrayOfPERSON"＞ ＜xsd:complexContent＞ ＜xsd:restriction base="soapenc:Array"＞ ＜attribute ref="soapenc:arrayType" wsdl:arrayType="typens:PERSON[]"/＞ ＜/xsd:restriction＞ ＜/xsd:complexContent＞ ＜/xsd:complexType＞ ＜/schema＞ ＜/types＞ ＜message name="addPersons"＞ 　＜part name="person" type="typens:ArrayOfPERSON"/＞ ＜/message＞ ＜message name="addPersonResponse"＞ 　＜part name="result" type="xsd:int"/＞ ＜/message＞ ＜/definitions＞

＜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是不支持重载的。