WSDL教程.docx

WSDL教程.docx

《WSDL教程.docx》由会员分享，可在线阅读，更多相关《WSDL教程.docx（10页珍藏版）》请在冰豆网上搜索。

WSDL教程

WSDL教程

WSDL（网络服务描述语言，WebServicesDescriptionLanguage）是一门基于XML的语言，用于描述WebServices以及如何对它们进行访问。

WSDL简介

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

您应当具备的基础知识

在继续学习之前，您需要对下面的知识有基本的了解：

∙XML

∙XML命名空间

∙XMLSchema

如果您希望首先学习这些项目，请访问我们的XML系列教程。

什么是WSDL?

∙WSDL指网络服务描述语言

∙WSDL使用XML编写

∙WSDL是一种XML文档

∙WSDL用于描述网络服务

∙WSDL也可用于定位网络服务

∙WSDL还不是W3C标准

WSDL可描述网络服务（WebServices）

WSDL指网络服务描述语言（WebServicesDescriptionLanguage）。

WSDL是一种使用XML编写的文档。

这种文档可描述某个Webservice。

它可规定服务的位置，以及此服务提供的操作（或方法）。

在W3C的WSDL发展史

在2001年3月，WSDL1.1被IBM、微软作为一个W3C纪录（W3Cnote）提交到有关XML协议的W3CXML活动，用于描述网络服务。

（W3C纪录仅供讨论。

一项W3C纪录的发布并不代表它已被W3C或W3C团队亦或任何W3C成员认可。

）

在2002年7月，W3C发布了第一个WSDL1.2工作草案。

请在我们的W3C教程阅读更多有关规范的状态及时间线。

WSDL文档

WSDL文档仅仅是一个简单的XML文档。

它包含一系列描述某个webservice的定义。

WSDL文档结构

WSDL文档是利用这些主要的元素来描述某个webservice的：

元素

定义

webservice执行的操作

webservice使用的消息

webservice使用的数据类型

webservice使用的通信协议

一个WSDL文档的主要结构是类似这样的：

definitionoftypes........

definitionofamessage....

definitionofaport.......

definitionofabinding....

WSDL文档可包含其它的元素，比如extension元素，以及一个service元素，此元素可把若干个webservices的定义组合在一个单一的WSDL文档中。

如需完整的语法概述，请访问WSDL语法这一节。

WSDL端口

元素是最重要的WSDL元素。

它可描述一个webservice、可被执行的操作，以及相关的消息。

可以把元素比作传统编程语言中的一个函数库（或一个模块、或一个类）。

WSDL消息

元素定义一个操作的数据元素。

每个消息均由一个或多个部件组成。

可以把这些部件比作传统编程语言中一个函数调用的参数。

WSDLtypes

元素定义webservice使用的数据类型。

为了最大程度的平台中立性，WSDL使用XMLSchema语法来定义数据类型。

WSDLBindings

元素为每个端口定义消息格式和协议细节。

WSDL实例

这是某个WSDL文档的简化的片段：

//定义一个输入参数包名，可能有多个参数

string"/>//定义一个参数名为term,类型为string

//定义一个返回输出参数包名

string"/>//参数名为value,类型为string

//函数库，或相当于类

//方法名

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

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

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

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

WSDL端口

WSDL端口可描述由某个webservice提供的界面（合法操作）。

WSDL端口

元素是最重要的WSDL元素。

它可描述一个webservice、可被执行的操作，以及相关的消息。

端口定义了指向某个webservice的连接点。

可以把该元素比作传统编程语言中的一个函数库（或一个模块、或一个类），而把每个操作比作传统编程语言中的一个函数。

操作类型

请求-响应是最普通的操作类型，不过WSDL定义了四种类型：

类型

定义

One-way

此操作可接受消息，但不会返回响应。

Request-response

此操作可接受一个请求并会返回一个响应

Solicit-response

此操作可发送一个请求，并会等待一个响应。

Notification

此操作可发送一条消息，但不会等待响应。

One-Way操作

一个one-way操作的例子：

string"/>

string"/>

//只有输入参数，没有返回参数

在这个例子中，端口"glossaryTerms"定义了一个名为"setTerm"的one-way操作。

这个"setTerm"操作可接受新术语表项目消息的输入，这些消息使用一条名为"newTermValues"的消息，此消息带有输入参数"term"和"value"。

不过，没有为这个操作定义任何输出。

Request-Response操作

一个request-response操作的例子：

string"/>

string"/>

//既有输入参数，也有返回参数。

在这个例子中，端口"glossaryTerms"定义了一个名为"getTerm"的request-response操作。

"getTerm"操作会请求一个名为"getTermRequest"的输入消息，此消息带有一个名为"term"的参数，并将返回一个名为"getTermResponse"的输出消息，此消息带有一个名为"value"的参数。

WSDL绑定

WSDL绑定可为webservice定义消息格式和协议细节。

绑定到SOAP

一个请求-响应操作的例子：

string"/>

string"/>

bindingstyle="document"

transport="http:

//schemas.xmlsoap.org/soap/http"/>

operation

soapAction="/>

bodyuse="literal"/>

bodyuse="literal"/>

binding元素有两个属性-name属性和type属性。

name属性定义binding的名称，而type属性指向用于binding的端口，在这个例子中是"glossaryTerms"端口。

soap:

binding元素有两个属性-style属性和transport属性。

style属性可取值"rpc"或"document"。

在这个例子中我们使用document。

transport属性定义了要使用的SOAP协议。

在这个例子中我们使用HTTP。

operation元素定义了每个端口提供的操作符。

对于每个操作，相应的SOAP行为都需要被定义。

同时您必须如何对输入和输出进行编码。

在这个例子中我们使用了"literal"。

WSDL和UDDI

UDDI是一种目录服务，企业可以使用它对Webservices进行注册和搜索。

UDDI，英文为"UniversalDescription,DiscoveryandIntegration"，可译为“通用描述、发现与集成服务”。

什么是UDDI？

UDDI是一个独立于平台的框架，用于通过使用Internet来描述服务，发现企业，并对企业服务进行集成。

∙UDDI指的是通用描述、发现与集成服务

∙UDDI是一种用于存储有关webservices的信息的目录。

∙UDDI是一种由WSDL描述的webservices界面的目录。

∙UDDI经由SOAP进行通信

∙UDDI被构建入了微软的.NET平台

UDDI基于什么？

UDDI使用W3C和IETF*的因特网标准，比如XML、HTTP和DNS协议。

UDDI使用WSDL来描述到达webservices的界面

此外，通过采用SOAP，还可以实现跨平台的编程特性，大家知道，SOAP是XML的协议通信规范，可在W3C的网站找到相关的信息。

*注释：

IETF-InternetEngineeringTaskForce

UDDI的好处

任何规模的行业或企业都能得益于UDDI。

在UDDI之前，还不存在一种Internet标准，可以供企业为它们的企业和伙伴提供有关其产品和服务的信息。

也不存在一种方法，来集成到彼此的系统和进程中。

UDDI规范帮助我们解决的问题：

∙使得在成百万当前在线的企业中发现正确的企业成为可能

∙定义一旦首选的企业被发现后如何启动商业

∙扩展新客户并增加对目前客户的访问

∙扩展销售并延伸市场范围

∙满足用户驱动的需要，为在全球Internet经济中快速合作的促进来清除障碍

UDDI如何被使用

假如行业发布了一个用于航班比率检测和预订的UDDI标准，航空公司就可以把它们的服务注册到一个UDDI目录中。

然后旅行社就能够搜索这个UDDI目录以找到航空公司预订界面。

当此界面被找到后，旅行社就能够立即与此服务进行通信，这样由于它使用了一套定义良好的预订界面。

谁在支持UDDI？

UDDI是一个跨行业的研究项目，由所有主要的平台和软件提供商驱动，比如：

Dell,Fujitsu,HP,Hitachi,IBM,Intel,Microsoft,Oracle,SAP,以及Sun,它既是一个市场经营者的团体，也是一个电子商务的领导者。

已有数百家公司参与了这个UDDI团体。

完整的WSDL语法

描述于W3C工作草案的完整WSDL1.2语法已列在下面：

definitionsname="nmtoken"?

targetNamespace="uri">

*

documentation..../>?

types>?

documentation..../>?

schema..../>*

types>

messagename="ncname">*

documentation..../>?

type="qname"?

/>*

message>

portTypename="ncname">*

documentation..../>?

operationname="ncname">*

documentation..../>?

inputmessage="qname">?

documentation..../>?

input>

outputmessage="qname">?

documentation..../>?

output>

faultname="ncname"message="qname">*

documentation..../>?

fault>

operation>

portType>

serviceTypename="ncname">*

portTypename="qname"/>+

serviceType>

bindingname="ncname"type="qname">*

documentation..../>?

<--bindingdetails-->*

operationname="ncname">*

documentation..../>?

<--bindingdetails-->*

input>?

documentation..../>?

<--bindingdetails-->

input>

output>?

documentation..../>

<--bindingdetails-->

output>

faultname="ncname">

documentation..../>

<--bindingdetails-->

fault>

operation>

binding>

servicename="ncname"serviceType="qname">

documentation..../>

portname="ncname"binding="qname">

documentation..../>

<--addressdetails-->

port>

service>

definitions>

您已经学习了WSDL，下一步呢？

WSDL概要

本教程已为您讲解了如何创建可描述web服务的WSDL文档。

它也规定了服务的位置和服务所提供的操作（或方法）。

您已经学习到如何为web服务定义消息格式和协议细节。

您也学习了可通过UDDI来注册和搜索web服务。

您已经学习了WSDL，下一步呢？

下一步应该学习SOAP和WebServices。

SOAP

SOAP是一种基于XML的简易协议，允许应用程序通过HTTP来交换信息。

或者更简单地讲，SOAP是用于访问web服务的协议。

如果您希望学习更多有关SOAP的知识，请访问我们的SOAP教程。

WebServices

Webservices可把您的应用程序转换为web应用程序。

通过使用XML，可以在应用程序间传送消息。

如果您希望学习更多有关Webservices的知识，请访问我们的Webservices教程。