Webservice接口-WSDL文档

WSDL是一个用于精确描述Web服务的文档，WSDL文档是一个遵循WSDL-XML模式的XML文档。WSDL 文档将Web服务定义为服务访问点或端口的集合。在 WSDL 中，由于服务访问点和消息的抽象定义已从具体的服务部署或数据格式绑定中分离出来，因此可以对抽象定义进行再次使用。消息，指对交换数据的抽象描述；而端口类型，指操作的抽象集合。用于特定端口类型的具体协议和数据格式规范构成了可以再次使用的绑定。将Web访问地址与可再次使用的绑定相关联，可以定义一个端口，而端口的集合则定义为服务。
一个WSDL文档通常包含8个重要的元素，即definitions、types、import、message、portType、operation、binding、service元素。这些元素嵌套在definitions元素中，definitions是WSDL文档的根元素。
WSDL文档外层结构图示：

WSDL 服务的基本元素：
Types（消息类型）：数据类型定义的容器，它使用某种类型系统（如 XSD）。
Message（消息）：通信数据的抽象类型化定义，它由一个或者多个 part 组成。
Part：消息参数
PortType（端口类型）：特定端口类型的具体协议和数据格式规范。，它由一个或者多个 Operation组成。
Operation（操作）：对服务所支持的操作进行抽象描述，WSDL定义了四种操作：
1.单向（one-way）：端点接受信息；
3.要求-响应（solicit-response）：端点发送消息，然后接受相关消息；
4.通知（notification[2] ）：端点发送消息。
Binding：特定端口类型的具体协议和数据格式规范。
Port：定义为绑定和网络地址组合的单个端点。
Service：相关端口的集合，包括其关联的接口、操作、消息

definitions元素
所有的WSDL文档的根元素均是definitions元素。该元素封装了整个文档，同时通过其name提供了一个WSDL文档。除了提供一个命名空间（targetNamespace）外，该元素没有其他作用
types元素
WSDL采用了W3C XML模式内置类型作为其基本类型系统。types元素用作一个容器，用于定义XML模式内置类型中没有描述的各种数据类型（不太明白：XML模式内置类型中没有描述的各种数据类型）。当声明消息部分的有效时，消息定义使用了在types元素中定义的数据类型和元素

import元素
import元素使得可以在当前的WSDL文档中使用其他WSDL文档中指定的命名空间中的定义元素。本例子中没有使用import元素。通常在用户希望模块化WSDL文档的时候，该功能是非常有效果的。
import的格式如下：
<wsdl:import namespace=“http://xxx.xxx.xxx/xxx/xxx” location=“http://xxx.xxx.xxx/xxx/xxx.wsdl”/>

namespace属性：值必须与正导入的WSDL文档中声明的targetNamespace相匹配；
location属性：指向一个实际的WSDL文档，且该文档不能为空

message元素
message元素描述了Web服务使用消息的有效负载。message元素可以描述输出或者接受消息的有效负载；还可以描述SOAP文件头和错误detail元素的内容

portType元素
portType元素定义了Web服务的抽象接口。该接口有点类似Java的接口，都是定义了一个抽象类型和方法，没有定义实现。在WSDL中，portType元素是由binding和service元素来实现的，这两个元素用来说明Web服务实现使用的Internet协议、编码方案以及Internet地址。
一个portType中可以定义多个operation，一个operation可以看作是一个方法
这部分将服务访问点的抽象定义与SOAP、HTTP绑定，描述如何通过SOAP/HTTP来访问按照前面描述的访问入口点类型部署的访问入口

service元素和port元素
service元素包含一个或者多个port元素，其中每个port元素表示一个不同的Web服务。port元素将URL赋给一个特定的binding，甚至可以使两个或者多个port元素将不同的URL赋值给相同的binding

1）查看WebService提供的接口
标签 wsdl:operation 中的 name 表示提供的接口名称，每个接口包含 wsdl:input 和 wsdl:output 两个部分，可 以理解为输入消息和输出消息。
wsdl:input 相当于接口的输入参数
wsdl:output 相当于接口的返回结果

2）查看WebService提供的接口的参数
找 wsdl:message 标签中 与 接口名称相同的项，比如：

其中关键词 element=“tns:getWeatherbyCityName” ，name=“parameters”
继续查看 xs:complexType/ s:complexType 标签中与"tns:getWeatherbyCityName " 冒号后面的字符相匹配的标签，比如：

s:element标签描述的内容即参数的属性，这里是要求输入theCityName，参数类型为string。
即接口原型为 getWeatherbyCityName（string theCityName）