当前位置: 首页 > 网络学院 > XML相关教程 > WSDL > WSDL 文档
A WSDL document is just a simple XML document.
WSDL文档仅仅是一份简单的XML文档。
It contains set of definitions to describe a web service.
它包含了一系列描述web service的定义。
A WSDL document describes a web service using these major elements:
WSDL 文档是利用这些主要的元素来描述某个 web service 的:
Element 元素 | Defines 定义 |
---|---|
<portType> | The operations performed by the web service web service 执行的操作 |
<message> | The messages used by the web service web service 使用的消息 |
<types> | The data types used by the web service web service 使用的数据类型 |
<binding> | The communication protocols used by the web service web service 使用的通信协议 |
The main structure of a WSDL document looks like this:
一个 WSDL 文档的主要结构是类似这样的:
<definitions> <types> |
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 元素,此元素可把若干个 web services 的定义组合在一个单一的 WSDL 文档中。
For a complete syntax overview go to the chapter WSDL Syntax.
如需完整的语法概述,请访问WSDL 语法。
The <portType> element is the most important WSDL element.
<portType>元素是最重要的 WSDL 元素。
It describes a web service, the operations that can be performed, and the messages that are involved.
它可描述一个 web service、可被执行的操作,以及相关的消息。
The <portType> element can be compared to a function library (or a module, or a class) in a traditional programming language.
可以把 <portType> 元素比作传统编程语言中的一个函数库(或一个模块、或一个类)。
The <message> element defines the data elements of an operation.
<message>元素定义一个操作的数据元素。
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.
每个信息均由一个或多个部件组成。可以把这些部件比作传统编程语言中一个函数调用的参数。
The <types> element defines the data type that are used by the web service.
<types>元素定义 web service 使用的数据类型。
For maximum platform neutrality, WSDL uses XML Schema syntax to define data types.
为了最大程度的平台中立性,WSDL 使用 XML Schema 语法来定义数据类型。
The <binding> element defines the message format and protocol details for each port.
<binding>元素为每个端口定义消息格式和协议细节。
This is a simplified fraction of a WSDL document:
这是某个 WSDL 文档的简化的片段:
<message name="getTermRequest"> <portType name="glossaryTerms"> |
In this example the <portType> element defines "glossaryTerms" as the name of a port, and "getTerm" as the name of an operation.
在上述案例中,<portType> 元素将 "glossaryTerms" 定义为一个端口的名称,将 "getTerm" 定义为一项操作的名称。
The "getTerm" operation has an input message called "getTermRequest" and an output message called "getTermResponse".
"getTerm" 操作包含一条名为"getTermRequest" 的输入信息和一条名为"getTermResponse".的输出信息。
The <message> elements define the parts of each message and the associated data types.
<message>元素定义了每个元素部件以及相关的数据类型。
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 的一个函数。