web service的api说明文档xml格式 - WSDL(Web Service Description Language)

WSDL是基于 XML的用于描述 Web 服务以及如何访问 Web 服务的语言。

WSDD（Web
Service Deployment Descriptor）：Web服务分布描述，它定义了Web服务的接口，如服务名、提供的方法、方法的参数信息。

SOAP（Simple Object Access Protocol）：简单对象访问协议是在分散或分布式的环境中交换信息并执行远程过程调用的轻量级协议，是一个基于XML的协议。使用SOAP，不用考虑任何特定的传输协议（最常用的还是HTTP协议），可以允许任何类型的对象或代码，在任何平台上，以任何一种语言相互通信。

WSDL：Web Services Description Language的缩写，是一个用来描述Web服务和说明如何与Web服务通信的XML语言。为用户提供详细的接口说明书。

<message> web service 使用的消息
<types> web service 使用的数据类型
<binding> web service 使用的通信协议

一个 WSDL 文档的主要结构是类似这样的：
<definitions>
<types>
数据类型定义的容器，它使用某种类型系统(如xsd）
</types>
<message>
通信数据的抽象类型化定义
</message>
<portType>
特定端口的具体协议和数据格式规范
<operation>
</operation>
</portType>
<binding>
特定端口类型的具体协议和数据格式规范
</binding>
<service>
相关端口的集合，包括其关联的接口 、操作、消息等。
</service>
</definitions>

Operation(操作)：对服务所支持的操作进行抽象描述，WSDL定义了四种操作：单向（one-way）：端点接受信息；
请求-响应（request-response）：端点接受消息，然后发送相关消息；
要求-响应（solicit-response）：端点发送消息，然后接受相关消息；
通知（notification）：端点发送消息。