一:WSDL定义
WSDL是一个用于精确描述Web服务的文档,WSDL文档是一个遵循WSDL XML模式的XML文档。WSDL 文档将Web服务定义为服务访问点或端口的集合。在 WSDL 中,由于服务访问点和消息的抽象定义已从具体的服务部署或数据格式绑定中分离出来,因此可以对抽象定义进行再次使用:消息,指对交换数据的抽象描述;而端口类型,指操作的抽象集合。用于特定端口类型的具体协议和数据格式规范构成了可以再次使用的绑定。将Web访问地址与可再次使用的绑定相关联,可以定义一个端口,而端口的集合则定义为服务。
一个WSDL文档通常包含7个重要的元素,即types、import、message、portType、operation、binding、 service元素。这些元素嵌套在definitions元素中,definitions是WSDL文档的根元素。文章的下一部分将会详细介绍WSDL 的基本结构。
二:WSDL的基本结构--概述
如第一部分最后描述的那样,一个基本的WSDL文档包含7个重要的元素。下面将分别介绍这几个元素以及他们的作用。
WSDL 文档在Web服务的定义中使用下列元素:
- Types - 数据类型定义的容器,它使用某种类型系统(一般地使用XML Schema中的类型系统)。
- Message - 通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。
- Operation - 对服务中所支持的操作的抽象描述,一般单个Operation描述了一个访问入口的请求/响应消息对。
- PortType - 对于某个访问入口点类型所支持的操作的抽象集合,这些操作可以由一个或多个服务访问点来支持。
- Binding - 特定端口类型的具体协议和数据格式规范的绑定。
- Port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。
- Service- 相关服务访问点的集合。
可以参考下图来理解一下WSDL的文档结构图:
WSDL的xml schema可以参照如下网址:http://schemas.xmlsoap.org/wsdl/
三:WSDL的基本结构--详述
本节将通过一个例子详细描述WSDL文档每个元素的作用。下面一个例子是一个简单的WSDL文档的内容,该文档的产生可以参见我的另外一篇文章:xfire开发实例--HelloWorld篇 。
一个简单的Web Service的WSDL文档,该服务支持名为sayHello的唯一操作,该操作通过在http上运行SOAP协议来实现的。该请求接受一个字符串name,经过处理后返回一个简单的字符串。文档如下:
< wsdl:definitions
targetNamespace ="http://com.liuxiang.xfireDemo/HelloService"
xmlns:tns ="http://com.liuxiang.xfireDemo/HelloService"
xmlns:wsdlsoap ="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:soap12 ="http://www.w3.org/2003/05/soap-envelope"
xmlns:xsd ="http://www.w3.org/2001/XMLSchema"
xmlns:soapenc11 ="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:soapenc12 ="http://www.w3.org/2003/05/soap-encoding"
xmlns:soap11 ="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:wsdl ="http://schemas.xmlsoap.org/wsdl/" >
< wsdl:types >
< xsd:schema xmlns:xsd ="http://www.w3.org/2001/XMLSchema"
attributeFormDefault ="qualified" elementFormDefault ="qualified"
targetNamespace ="http://com.liuxiang.xfireDemo/HelloService" >
< xsd:element name ="sayHello" >
< xsd:complexType >
< xsd:sequence >
< xsd:element maxOccurs ="1" minOccurs ="1"
name ="name" nillable ="true" type ="xsd:string" />
</ xsd:sequence >
</ xsd:complexType >
</