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

王朝c#·作者佚名  2006-12-17
窄屏简体版  字體: |||超大  

数组

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

 
 
 
免责声明:本文为网络用户发布,其观点仅代表作者个人观点,与本站无关,本站仅提供信息存储服务。文中陈述内容未经本站证实,其真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
 
 
© 2005- 王朝網路 版權所有  導航