WSDL 文档

来源:百度文库 编辑:神马文学网 时间:2024/07/04 22:23:55
A WSDL document is just a simple XML document.
一份WSDL文档是一份简单的XML文档。
It contains set of definitions to describe a web service.
它包含了几组用于描述网页服务的定义。
The WSDL Document Structure
WSDL文档结构
A WSDL document describes a web service using these major elements:
一份WSDL文档用到这些重要元素来描述网页服务:
Element
元素 Defines
定义
The operations performed by the web service
由网页服务进行的操作
The messages used by the web service
网页服务使用的信息
The data types used by the web service
网页服务使用的数据类型
The communication protocols used by the web service
网页服务使用的交流协议
The main structure of a WSDL document looks like this:
一份WSDL文档的主要结构会像这样:


definition of types........


definition of a message....


definition of a port.......


definition of a binding....


A WSDL document can also contain other elements, like extension elements and a service element that makes it possible to group together the definitions of several web services in one single WSDL document.
一份WSDL文档可能也会包含其他元素,像extension(扩展)元素和service(服务)元素,service元素可以把若干个网页服务的定义合在一起放在一份单独的WSDL文档里。
For a complete syntax overview go to the chapterWSDL Syntax.
想了解关于全部语法,请阅读WSDL Syntax.这章。
WSDL Ports
WSDL端口
The element is the most important WSDL element.
元素是最重要的WSDL元素
It describes a web service, the operations that can be performed, and the messages that are involved.
它描述了网页服务,可进行的操作,以及涉及到的信息。
The element can be compared to a function library (or a module, or a class) in a traditional programming language.
元素可以比喻为传统设计语言里的函数库(或一个模块,一个类)
WSDL Messages
WSDL信息
The element defines the data elements of an operation.
元素定义了一项操作的数据元素。
Each message can consist of one or more parts. The parts can be compared to the parameters of a function call in a traditional programming language.
每条信息都由一部分或几部分组成。这些部分可比作是在传统设计语言里被调用的函数的参数。
WSDL Types
WSDL类型
The element defines the data type that are used by the web service.
元素定义了被网页服务所用的数据类型。
For maximum platform neutrality, WSDL uses XML Schema syntax to define data types.
为了最大限度的平台中立,WSDL用XML格式语法来定义数据类型。
WSDL Bindings
WSDL 捆绑
The element defines the message format and protocol details for each port.
元素为每个端口定义了信息格式化和协议细节。
WSDL Example
WSDL举例
This is a simplified fraction of a WSDL document:
下面是一份WSDL文档的简化了的片段:











In this example the element defines "glossaryTerms" as the name of a port, and "getTerm" as the name of an operation.
在这个例子里元素把"glossaryTerms"定义为一个端口的名称,"getTerm"定义为一项操作的名称。
The "getTerm" operation has an input message called "getTermRequest" and an output message called "getTermResponse".
"getTerm"操作有一条"getTermRequest"的输入信息和一条"getTermResponse".的输出信息
The elements define the parts of each message and the associated data types.
元素定义了每条元素的部分(part)和相联系的数据类型。
Compared to traditional programming, glossaryTerms is a function library, "getTerm" is a function with "getTermRequest" as the input parameter and getTermResponse as the return parameter.
与传统程序设计相比,glossaryTerms是个函数库,"getTerm"是个以"getTermRequest"作为输入参数,getTermResponse作为输出参数的函数