Web Service基础知识——WSDL概述

怎样向别人介绍你的Web service有什么功能,以及每个函数调用时的参数呢?你可能会自己写一套文档,你甚至可能会口头上告诉需要使用你的Web service的人。这些非正式的方法至少都有一个严重的问题:当程序员坐到电脑前,想要使用你的Web service的时候,他们的工具(如Visual Studio)无法给他们提供任何帮助,因为这些工具根本就不了解你的Web service。解决方法是:用机器能阅读的方式提供一个正式的描述文档。

Web service描述语言(WSDL)就是这样一个基于XML的语言,用于描述Web service及其函数、参数和返回值。因为是基于XML的,所以WSDL既是机器可阅读的,又是人可阅读的,这将是一个很大的好处。一些最新的开发工具既能根据你的Web service生成WSDL文档,又能导入WSDL文档,生成调用相应Web service的代码。

WSDL的元素

WSDL文档用以下这些元素描述一个Web Service:

Types(消息类型) 定义 web service 使用的数据类型。为了最大程度的平台中立性,WSDL 使用 XML Schema 语法来定义数据类型。
Message(消息) 定义一个操作的数据元素,它由一个或者多个part组成。可以把这些part比作传统编程语言中一个函数调用的参数。
Part 消息参数
Operation(操作) 对服务所支持的操作进行抽象描述,WSDL定义了四种操作:
1.单向(one-way):端点接收信息;(常用)
2.请求-响应(request-response):端点接收消息,然后发送相关消息;(常用)
3.要求-响应(solicit-response):端点发送消息,然后接收相关消息;与通知模式类似,唯一的区别要期待客户对Web服务的响应。
4.通知(notification[2] ):端点发送消息。Web服务将消息发送给客户,但不等待回复;
5.如果有input+output+可选的fault参数,那就使用请求/响应模式;如果只使用input,那就使用单向模式。
Port Type (端口类型) 最重要的WSDL元素,描述Web Service中的操作以及相关的消息。
可以把 元素比作传统编程语言中的一个函数库(或一个模块、或一个类)。
Binding 每个端口定义消息格式和协议细节。
Port Type 定义为绑定和网络地址组合的单个端点。
Service 相关端口的集合,包括其关联的接口、操作、消息等。此元素可把若干个 web services 的定义组合在一个单一的 WSDL 文档中。

WSDL文档的结构




   definition of types........



   definition of a message....



   definition of a port.......



   definition of a binding....


所有WSDL文档的根元素都是definition元素。   WSDL 文档可包含其它的元素,比如 extension 元素,以及一个 service 元素,此元素可把若干个 web services 的定义组合在一个单一的 WSDL 文档中。我看看一个W3C网站上的而一个例子:


   



   



  
        
        
  

在这个例子中, 元素把 "glossaryTerms" 定义为某个端口的名称,把 "getTerm" 定义为某个操作的名称。

操作 "getTerm" 拥有一个名为 "getTermRequest" 的输入消息,以及一个名为 "getTermResponse" 的输出消息

元素可定义每个消息的部件,以及相关联的数据类型。

对比传统的编程,glossaryTerms 是一个函数库,而 "getTerm" 是带有输入参数 "getTermRequest" 和返回参数 getTermResponse 的一个函数。

WSDL文档实例

下面我们拿一个实例来分析WSDL文档,实例地址为:http://fy.webxml.com.cn/webservices/EnglishChinese.asmx?wsdl(复制到浏览器中打开)。

首先只展示一级节点,将所有子节点收缩起来,看起来应该是这样:

Web Service基础知识——WSDL概述_第1张图片

在这个例子中,WSDL文档包含的元素有Types、36个Message、3个portType(比作传统编程语言中的一个函数库、或者模块、或者类)、4个binding、1个service。


你可能感兴趣的:(Web,service)