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