WSDL
1、WSDL文档结构
WSDL元素结构示意图如下图所示:
其中:
1)Types是一个数据类型定义的容器,包含了所有在消息定义中需要的XML元素的类型定义。
2)Message具体定义了在通信中使用的消息的数据结构,Message元素包含了一组Part元素,每个Part元素都是最终消息的一个组成部分,每个Part都会引用一个DataType来表示它的结构。Part元素不支持嵌套。
3)PortType具体定义了一种服务访问入口的类型,何谓访问入口的类型呢?就是传入/传出消息的模式及其格式。
一个PortType可以包含若干个Operation,而一个Operation则是指访问入口支持的一种类型的调用。以上三种结构描述了调用Web服务的抽象定义,这三部分与具体Web服务部署细节无关,是可复用的描述(每个层次都可以复用)。
4)Service描述的是一个具体的被部署的Web服务所提供的所有访问入口的部署细节,一个Service往往会包含多个服务访问入口,而每个访问入口都会使用一个Port元素来描述。
5)Port描述的是一个服务访问入口的部署细节,包括通过哪个Web地址(URL)来访问,应当使用怎样的消息调用模式来访问等。其中消息调用模式则是使用Binding结构来表示。
6)Binding结构定义了某个PortType与某一种具体的网络传输协议或消息传输协议相绑定,从这一层次开始,描述的内容就与具体服务的部署相关了。比如可以将PortType与SOAP/HTTP绑定,也可以将PortType与MIME/SMTP相绑定等。
2、WSDL端口
元素是最重要的WSDL元素。
它可描述一个Web service可被执行的操作以及相关的消息。
可以把元素比作传统编程语言中的一个函数库(或一个模块,或一个类)。
端口包含如下类型:
1)一个One-way操作的例子:
<message name="newTermValues">
<part name="term" type="xs:string"/>
<part name="value" type="xs:string"/>
</message>
<portType name="glossaryTerms">
<operation name="setTerm">
<input name="newTerm" message="newTermValues"/>
</operation>
</portType >
在这个例子中,端口"glossaryTerms"定义了一个名为"setTerm"的one-way操作。
这个"setTerm"操作可接受新术语表项目消息的输入,这些消息使用一条名为"newTermValues"的消息,此消息带有输入参数"term"和"value"。不过,没有为这个操作定义任何输出。
2)一个Request-response操作的例子:
<message name="getTermRequest">
<part name="term" type="xs:string"/>
</message>
<message name="getTermResponse">
<part name="value" type="xs:string"/>
</message>
<portType name="glossaryTerms">
<operation name="getTerm">
<input message="getTermRequest"/>
<output message="getTermResponse"/>
</operation>
</portType>
在这个例子中,端口“glossaryTerms”定义了一个名为“getTerm”的request-response操作。
“getTerm”操作会请求一个名为“getTermRequest”的输入消息,此消息带有一个名为“term”的参数,并将返回一个名为 “getTermResponse”的输出消息,此消息带有一个名为“value”的参数。
3、WSDL绑定
一个绑定的例子:
<message name="getTermRequest">
<part name="term" type="xs:string"/>
</message>
<message name="getTermResponse">
<part name="value" type="xs:string"/>
</message>
<portType name="glossaryTerms">
<operation name="getTerm">
<input message="getTermRequest"/>
<output message="getTermResponse"/>
</operation>
</portType>
<binding type="glossaryTerms" name="b1">
<soap:binding style="document"
transport="http://schemas.xmlsoap.org/soap/http" />
<operation>
<soap:operation soapAction="http://example.com/getTerm"/>
<input><soap:body use="literal"/></input>
<output><soap:body use="literal"/></output>
</operation>
</binding>
binding元素有“name”和“type”两个属性。“name”属性定义binding的名称,而“type”属性指向binding的端口,在这个例子中是“glossaryTerms”端口。
soap:binding元素有“style”和“transport”两个属性。“style”属性可取值为“rpc”或“document”。
在这个例子中我们使用“document”。“transport”属性定义SOAP使用的协议,在这个例子中使用HTTP。
operation元素定义了每个端口提供的操作符。对于每个操作,相应的SOAP行为都需要被定义。同时必须知道如何对输入和输出进行编码。在这个例子中使用了“literal”。