XML WSDL
- WSDL代表Web服务描述语言
- WSDL用于描述web服务
- WSDL是用XML编写的
- WSDL 是 2007 年 6 月 26 日的 W3C 推荐标准
WSDL文档
WSDL文档描述web服务。它使用以下主要元素指定服务的位置和服务的方法:
| 元素 | 描述 |
|---|---|
| <types> | 定义web服务使用的（XML架构）数据类型 |
| <message> | 定义每个操作的数据元素 |
| <portType> | 描述可以执行的操作和涉及的消息。 |
| <binding> | 定义每个端口类型的协议和数据格式 |
WSDL文档的主要结构如下所示:
<definitions><types>
data type definitions........
</types>
<message>
definition of the data being communicated....
</message>
<portType>
set of operations......
</portType>
<binding>
protocol and data format specification....
</binding>
</definitions>
WSDL实例
这是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>
在本例中， <portType>元素将"glossaryTerms"定义为端口名，"getTerm" 定义为操作名。
"getTerm"操作有一个名为"getTermRequest"的输入消息和一个名为"getTermResponse"的输出消息。
<message> 元素定义每个消息的部分和相关的数据类型。
<portType> 元素
<portType> 元素定义了一个web服务、可以执行的操作以及所涉及的消息。
请求-响应类型是最常见的操作类型，但WSDL定义了四种类型:
| 类型 | 定义 |
|---|---|
| One-way | 该操作可以接收消息，但不会返回响应 |
| Request-response | 该操作可以接收请求并返回响应 |
| Solicit-response | 操作可以发送请求并等待响应 |
| Notification | 该操作可以发送消息，但不会等待响应 |
WSDL单向操作
单向操作实例:
<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 >
在上面的实例中，portType"glossaryTerms"定义了一个名为"setTerm"的单向操作。
"setTerm" 操作允许使用带有输入参数"term"和"value"的"newTermValues"消息输入新的词汇表术语消息。但是，没有为操作定义输出。
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>
在上面的实例中，portType"glossaryTerms"定义了一个名为"getTerm"的请求-响应操作。
"getTerm" 操作需要一个名为"getTermRequest"的输入消息和一个名为"term"的参数，并将返回一个名为"getTermResponse"的输出消息和一个名为"value"的参数。
WSDL绑定到SOAP
WSDL绑定定义了web服务的消息格式和协议细节。
请求-响应操作实例:
<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>
绑定元素有两个属性-name和type。
name属性（您可以使用任何想要的名称）定义绑定的名称，type属性指向绑定的端口，在本例中是"glossaryTerms"端口。
soap:binding 有两个属性-样式和传输。
样式属性可以是"rpc"或"document"。在这种情况下，我们使用文档。transport属性定义要使用的SOAP协议。在本例中，我们使用HTTP。
operation 元素定义portType公开的每个操作。
对于每个操作，必须定义相应的SOAP操作。您还必须指定输入和输出是如何编码的。在本例中，我们使用 "literal".
