XML WSDL
- WSDL 代表 Web Services Description Language (Web 服务描述语言)
- WSDL 用于描述 Web 服务
- WSDL 使用 XML 编写
- WSDL 是 W3C 于 2007 年 6 月 26 日发布的推荐标准
WSDL 文档
WSDL 文档描述一个 Web 服务。它使用以下主要元素指定服务的地址和服务的方法
| 元素 | 描述 |
|---|---|
| <types> | 定义 Web 服务使用的数据（XML Schema）类型 |
| <message> | 为每个操作定义数据元素 |
| <portType> | 描述可执行的操作以及涉及的消息。 |
| <binding> | 为每个端口类型定义协议和数据格式 |
WSDL 文档的主要结构如下所示
<definitions>
<types>
数据类型定义........
</types>
<message>
定义正在通信的数据....
</message>
<portType>
操作集......
</portType>
<binding>
协议和数据格式规范....
</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 定义了四种类型
| 类型 | Definition（定义） |
|---|---|
| 单向 | 该操作可以接收消息，但不会返回响应 |
| 请求-响应 | 该操作可以接收请求并返回响应 |
| 请求-响应 | 该操作可以发送请求并等待响应 |
| 通知 | 该操作可以发送消息，但不会等待响应 |
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”操作允许输入新的词汇表术语消息，使用名为 “newTermValues” 的消息，其中包含参数 “term” 和 “value”。但是，该操作没有定义输出。
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>binding 元素有两个属性 - name 和 type。
name 属性（可以使用任何名称）定义绑定的名称，type 属性指向绑定的端口，在此例中是“glossaryTerms”端口。
soap:binding 元素有两个属性 - style 和 transport。
style 属性可以是“rpc”或“document”。在此例中我们使用 document。transport 属性定义要使用的 SOAP 协议。在此例中我们使用 HTTP。
operation 元素定义了 portType 公开的每个操作。
对于每个操作，必须定义相应的 SOAP 操作。您还必须指定输入和输出的编码方式。在此例中我们使用“literal”。
