首页 > 代码库 > WSDL 知识点

WSDL 知识点

2024-07-07 11:27:09 234人阅读

WSDL

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

WSDL简介

WSDL是基于 XML 的WebService的描述语言，是一种接口定义语言，用于描述Web Service的接口信息等。

WSDL文档可以分为两部分。顶部分由抽象定义组成，而底部分则由具体描述组成。

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

? XML

? XML 命名空间

? XML Schema

什么是WSDL？

u WSDL 指网络服务描述语言, 用于描述网络服务

u WSDL 使用XML 编写, 是一种 XML 文档，它包含一系列描述某个 web service 的定义

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

u WSDL 还不是 W3C 标准

WSDL发展史

2001 年 3 月，WSDL 1.1 被 IBM、微软作为一个 W3C 记录（W3C note）提交到有关 XML 协议的 W3C XML 活动，用于描述网络服务。

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

WSDL文档结构

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

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

元素	定义
<portType>	web service 执行的操作
<message>	web service 使用的消息
<types>	web service 使用的数据类型
<binding>	web service 使用的通信协议

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

<types>

definition of types........

</types>

definition of a message....

</message>

definition of a port.......

</portType>

definition of a binding....

</binding>

</definitions>

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

WSDL端口

<portType> 元素是最重要的 WSDL 元素。

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

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

WSDL消息

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

每个消息均由一个或多个部件组成。可以把这些部件比作传统编程语言中一个函数调用的参数。

WSDL types

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

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

WSDL Binding

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

WSDL实例

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

<messagename="getTermRequest">

<partname="term"type="xs:string"/>

</message>

<messagename="getTermResponse">

<partname="value"type="xs:string"/>

</message>

<portTypename="glossaryTerms">

<operationname="getTerm">

<inputmessage="getTermRequest"/>

<outputmessage="getTermResponse"/>

</operation>

</portType>

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

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

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

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

WSDL端口

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

<portType> 元素是最重要的 WSDL 元素。

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

端口定义了指向某个 web service 的连接点。可以把该元素比作传统编程语言中的一个函数库（或一个模块、或一个类），而把每个操作比作传统编程语言中的一个函数。

操作类型

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

类型	定义
One-way （单向）	此操作可接受消息，但不会返回响应。服务器端接收消息。
Request-response （请求相应）	服务端点接收请求消息，然后发送响应消息，
Solicit-response （要求应答）	服务访问端发送要求消息，然后接收应答消息
Notification （通知）	此操作可发送一条消息，但不会等待响应。服务访问端点发送通知消息。

One-Way 操作

一个 one-way 操作的例子：

<messagename="newTermValues">

<partname="term"type="xs:string"/>

<partname="value"type="xs:string"/>

</message>

<portTypename="glossaryTerms">

<operationname="setTerm">

<inputname="newTerm"message="newTermValues"/>

</operation>

</portType>

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

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

Request-Response 操作

一个 request-response 操作的例子：

<messagename="getTermRequest">

<partname="term"type="xs:string"/>

</message>

<messagename="getTermResponse">

<partname="value"type="xs:string"/>

</message>

<portTypename="glossaryTerms">

<operationname="getTerm">

<inputmessage="getTermRequest"/>

<outputmessage="getTermResponse"/>

</operation>

</portType>

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

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

WSDL绑定

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

绑定到 SOAP

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

<messagename="getTermRequest">

<partname="term"type="xs:string"/>

</message>

<messagename="getTermResponse">

<partname="value"type="xs:string"/>

</message>

<portTypename="glossaryTerms">

<operationname="getTerm">

<inputmessage="getTermRequest"/>

<outputmessage="getTermResponse"/>

</operation>

</portType>

<bindingtype="glossaryTerms"name="b1">

<soap:bindingstyle="document"transport="http://schemas.xmlsoap.org/soap/http"/>

<soap:operationsoapAction="http://example.com/getTerm"/>

<input>

<soap:bodyuse="literal"/>

</input>

<soap:bodyuse="literal"/>

</output>

</operation>

</binding>

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, Discovery and Integration"，可译为“通用描述、发现与集成服务”。

什么是 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 -Internet Engineering Task Force 互联网工程任务组

UDDI的好处是什么？

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

在 UDDI 之前，还不存在一种Internet 标准，可以供企业为它们的企业和伙伴提供有关其产品和服务的信息。也不存在一种方法，来集成到彼此的系统和进程中。

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

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

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

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

4. 扩展销售并延伸市场范围

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

UDDI如何被使用？

假如行业发布了一个用于航班比率检测和预订的 UDDI 标准，航空公司就可以把它们的服务注册到一个 UDDI 目录中。然后旅行社就能够搜索这个 UDDI 目录以找到航空公司预订界面。当此界面被找到后，旅行社就能够立即与此服务进行通信，这样由于它使用了一套定义良好的预订界面

谁在支持UDDI？

DDI 是一个跨行业的研究项目，由所有主要的平台和软件提供商驱动，比如：Dell, Fujitsu, HP, Hitachi, IBM, Intel, Microsoft, Oracle, SAP, 以及 Sun, 它既是一个市场经营者的团体，也是一个电子商务的领导者。

完整的WSDL语法

描述于 W3C 工作草案的完整 WSDL 1.2 语法已列在下面：

<wsdl:definitionsname="nmtoken" ?targetNamespace="uri">

<importnamespace="uri"location="uri"/> *

<wsdl:documentation ./> ?

<wsdl:types> ?

<wsdl:documentation ./> ?

<xsd:schema ./> *

</wsdl:types>

<wsdl:messagename="ncname"> *

<wsdl:documentation ./> ?

<partname="ncname"element="qname" ?type="qname" ?/> *

</wsdl:message>

<wsdl:portTypename="ncname"> *

<wsdl:documentation ./> ?

<wsdl:operationname="ncname"> *

<wsdl:documentation ./> ?

<wsdl:inputmessage="qname"> ?

<wsdl:documentation ./> ?

</wsdl:input>

<wsdl:outputmessage="qname"> ?

<wsdl:documentation ./> ?

</wsdl:output>

<wsdl:faultname="ncname"message="qname"> *

<wsdl:documentation ./> ?

</wsdl:fault>

</wsdl:operation>

</wsdl:portType>

<wsdl:serviceTypename="ncname"> *

<wsdl:portTypename="qname"/> +

</wsdl:serviceType>

<wsdl:bindingname="ncname"type="qname"> *

<wsdl:documentation ./> ?

<-- binding details --> *

<wsdl:operationname="ncname"> *

<wsdl:documentation ./> ?

<-- binding details --> *

<wsdl:input> ?

<wsdl:documentation ./> ?

<-- binding details -->

</wsdl:input>

<wsdl:output> ?

<wsdl:documentation ./> ?

<-- binding details --> *

</wsdl:output>

<wsdl:faultname="ncname"> *

<wsdl:documentation ./> ?

<-- binding details --> *

</wsdl:fault>

</wsdl:operation>

</wsdl:binding>

<wsdl:servicename="ncname"serviceType="qname"> *

<wsdl:documentation ./> ?

<wsdl:portname="ncname"binding="qname"> *

<wsdl:documentation ./> ?

<-- address details -->

</wsdl:port>

</wsdl:service>

</wsdl:definitions>

声明：以上内容来自用户投稿及互联网公开渠道收集整理发布，本网站不拥有所有权，未作人工编辑处理，也不承担相关法律责任，若内容有误或涉及侵权可进行投诉：投诉/举报工作人员会在5个工作日内联系你，一经查实，本站将立刻删除涉嫌侵权内容。

联系
我们

首页 > 代码库 > WSDL 知识点

WSDL 知识点

WSDL

WSDL简介

什么是WSDL？

WSDL发展史

WSDL文档结构

WSDL端口

WSDL消息

WSDL types

WSDL Binding

WSDL实例

WSDL端口

操作类型

One-Way 操作

Request-Response 操作

WSDL绑定

绑定到 SOAP

WSDL 和 UDDI

什么是 UDDI？

UDDI基于什么？

UDDI的好处是什么？

UDDI如何被使用？

谁在支持UDDI？

完整的WSDL语法

看完仍有疑问？有类似问题直接问程序猿