WSDL文件是什么？

Web service描述语言(WSDL)。

当程序员坐到电脑前,想要使用Web service的时候,其的工具(如Visual Studio)无法给其提供任何帮助，因为这些工具根本就不了解Web service。

解决方法是：

用机器能阅读的方式提供一陪棚个正式的描述文档.Web service描闷游述语言(WSDL)

就是这样一个基于XML的语言,用于描述Web service及其函数、参数和返回值.因为是基于XML的，所以WSDL既是机器可阅读的，又是人可阅读的。

这将是一个很大的好处.一些最新的开发工具 既能根据你的Web service生成WSDL文档,又能导入WSDL文档，生成调用相芦罩则应Web service的代码。

WSDL用来提供对服务的描述 ,它的主要构成要素有五个:

1）Types：定义WSDL定义中所用到的数据类型,即XML Schema Types。

2）Message :对一组消息的输入和输出参数的定义。

Web Service 元数据注释（JSR 181）

@WebService

1、serviceName： 对外发布的服务名，指定 Web Service 的服务名称：wsdl:service。缺省值为 Java 类的简单名称 + Service。（字符串）

2、endpointInterface： 服务接口全路径, 指定做SEI（Service EndPoint Interface）服务端点接口

3、name：此属性的值包含XML Web Service的名称。在默认情况下，该值是实现XML Web Service的类的名称，wsdl:portType 的名称。缺省值为 Java 类或接口的非限定名称。（字符串

4、portName： wsdl:portName。缺省值为 WebService.name+Port。

5、targetNamespace：指定你想要的名称空间，认是使用接口实现类的包名的反缀

6、wsdlLocation：指定用于定义 Web Service 的 WSDL 文档的 Web 地址。Web 地址可以是相对路径或绝对路径。（字符串）

注意：实现类上可以不添加Webservice注解

@WebMethod

注释表示作为一项 Web Service *** 作的方法，将此注释应用于客户机或服务器服务端点接口（SEI）上的方法，或者应用于 JavaBeans 端点的服务器端点实现类。

要答基点：

仅支持在使用 @WebService 注释来注释的类上使用 @WebMethod 注释

1、operationName：指定与此方法相匹配的wsdl:operation 的名称。缺省值为 Java 方法的名称。（字符串）

2、action：定义此 *** 作的行为。对于 SOAP 绑定，此值将确定 SOAPAction 头的值。缺省值为 Java 方法的名称。（字符串）

3、exclude：指定是否从 Web Service 中排除某一方法。缺省值为 false。（布尔值）

@Oneway

注释将一个方法表示为只有输入消息而没有输出消息的 Web Service 单向 *** 作。

将此注释应用于客户机或服务器服务端点接口（SEI）上的方法，或者应用于 JavaBeans 端点的服务器端点实现类

@WebParam

注释用于定制从单个参数至 Web Service 消息部件和 XML 元素的映射。

将此注释应用于客户机或服务器服务端点接口（SEI）上的方法，或者应用于 JavaBeans 端点的服务器端点实现类。

1、name ：参数的名称。如果 *** 作是远程过程调用（RPC）类型并且未指定partName 属性，那么这是用于表示参数的 wsdl:part 属性的名称。

如果 *** 作是文档类型或者参数映射至某个头，那么 -name 是用于表示该参数的 XML 元素的局部名称。如果 *** 作是文档类型、

参数类型为 BARE 并且方式为 OUT 或 INOUT，那么必须指定此属性。（字符串）

2、partName：定义用于表示此参数的 wsdl:part属性的名称。仅当 *** 作类型为 RPC 或者 *** 作是文档类型并且参数类型为BARE 时才使用此参数。（字符串）

3、targetNamespace：指定参数的 XML 元素的 XML 名称空间。当属性枣信映射至 XML 元素时，仅应用于文档绑定。缺省值为 Web Service 的 targetNamespace。（字符串）

4、mode：此值表示此方法的参数流的方向。有效值为 IN、INOUT 和 OUT。（字符串）

5、header：指定参数是在消息头还是消息体中。缺省值为 false。（布尔值）

@WebResult

注释用于定制从返回值至 WSDL 部件或 XML 元素的映射。将此注释应用于客户机或服务器服务端点接口（SEI）上的方凳举轮法，或者应用于 JavaBeans 端点的服务器端点实现类。

1、name：当返回值列示在 WSDL 文件中并且在连接上的消息中找到该返回值时，指定该返回值的名称。对于 RPC 绑定，这是用于表示返回值的 wsdl:part属性的名称。对于文档绑定，-name参数是用于表示返回值的 XML 元素的局部名。对于 RPC 和 DOCUMENT/WRAPPED 绑定，缺省值为 return。对于 DOCUMENT/BARE 绑定，缺省值为方法名 + Response。（字符串）

2、targetNamespace：指定返回值的 XML 名称空间。仅当 *** 作类型为 RPC 或者 *** 作是文档类型并且参数类型为 BARE 时才使用此参数。（字符串）

3、header：指定头中是否附带结果。缺省值为false。（布尔值）

4、partName：指定 RPC 或 DOCUMENT/BARE *** 作的结果的部件名称。缺省值为@WebResult.name。（字符串）

@HandlerChain

注释用于使 Web Service 与外部定义的处理程序链相关联。只能通过对 SEI 或实现类使用 @HandlerChain 注释来配置服务器端的处理程序。

但是可以使用多种方法来配置客户端的处理程序。可以通过对生成的服务类或者 SEI 使用 @HandlerChain 注释来配置客户端的处理程序。此外，可以按程序在服务上注册您自己的 HandlerResolver 接口实现，或者按程序在绑定对象上设置处理程序链。

1、file：指定处理程序链文件所在的位置。文件位置可以是采用外部格式的绝对 java.net.URL，也可以是类文件中的相对路径。（字符串）

2、name：指定配置文件中处理程序链的名称。

来源：http://yufenfei.iteye.com/blog/1685249

读懂WSDL

1. WSDL 是什么

WSDL 指网络服务描述语言 (Web Services Description Language)。 是一种使用 XML 编写的文档。这种文档可描述某个 Web service。它可规定服务的位置，以及此服务提供的 *** 作（或方法）。

2. WSDL 文档结构

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

元素

定义

<portType>

最重要的 WSDL 元素，它可描述一个 web service可被执行的 *** 作以及相关的消息。

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

<message>

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

<types>

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

<binding>

web service 使用的通信协议元素。为每个端口定义消息格式和协议细节。

一个 WSDL 文档的主要结构

l 抽象定义

Types 独立与机器和语言的类型定义

Messages 包括函数参数（输入与输出分开）或文档描述

PortTypes 引用消息部分中消息定义来描述函数签名（ *** 作名、输入参数、输出参数）

2 具体定义

Bindings PortTypes部分的每一 *** 作在此绑定实现

Services 确定每一绑定的端口地址

文档形式为：

<definitions>

<types>

definition of types........

</types>

<message>

definition of a message....

</message>

<portType>

definition of a port.......

</portType>

<binding>

definition of a binding....

</binding>

</definitions>

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

2.1.WSDL文档实例

欢迎光临DIY部落,点击这里查看更多文章教程......

参考地址：http://www.diybl.com/course/3_program/java/javajs/2008315/104672.html

WSDL概述

WSDL就是描述XML Web服务的标准XML格式，WSDL由Ariba、Intel、IBM和微软等开发商提出。它用一种和具体语言无关的抽象方式定义了给定Web服务收发的有关 *** 作和消息。就其定义来说，你还不能把WSDL当作一种对象接口定义语言，例如，CORBA或COM等应用程序体系结构就会用到对象接口定义语言。 WSDL保持协议中立，但它确实内建了绑定SOAP的支持，从而同SOAP建立了不可分割的联系。所以，当我在这篇文章中讨论晌桥WSDL的时候，我会假定你把SOAP作为了你的通讯协议。

————————————————————————————

WSDL协议已经被提交给了Internet标准组织W3C审批，目前还处于“确认提交”状态。W3C维持着正规的标准化系统同时提交提案必须经过确定的一套批准过程才能最终成为官方协议。在这种情况下，WSDL的地位，照外行看，至少标准组织在考虑让其成为将来可能标准中的一部分。如果你对这方面的情况感兴趣，或碰巧是一位特关心结果的“失眠症患者”，那么你不妨到W3C网站上去读读有关的建议标准。

用WSDL说明服务

作为一种基于XML的标准，如果你对XML具有一定的了解，那么WSDL的结构对你就不会陌生了。WSDL文档由服务用来描述数据类型的一组元素、服务可以收到的“消息”以及关联每条消息的SOAP绑定组成。

清单A就是一份简单的WSDL文档，该文档同W3C网站公布的WSDL示范文本是一样的，它说明了一种股票行情服务（这也是相当标准的一种Web服务）。

再仔细阅读清单A，你可以看到，文档首先以标准的XML头开头，其中包含了一个版本标识，而文档的根元素则被称为definitions。

Definitions元素可以采用若干种可选属性，这些属性说明文档同时定义文档其余部分使用的名称空间（namespace）。在这种情况下，定义被分配了一个名字（StockQuote），某些名称空间定义是根据以下常规前缀缩写制定的：

tns—“this namespace”的缩写，包含被定义服务的主名称空间

xsdl—XML Schema (XSD)名称空间，用于定义文档中的类型

soap—SOAP绑定采用的名称空间

接下来，为了定义服务的接口需要在type元素内定义所需要的任何复杂类型。这里你必须注意使用标准的XSD句法（属性），它是创造数据类型定义最为适合的方法。不过，如果你愿意，WSDL也能扩展使用不同的类型定义系统。

消息概述

按WSDL的用法，消息可以是传递给某一服务公布对象上的方法的任何参数或者方法被调用之后的任何返回结果。为了继续使用股票行情这个Web服务例子，单一定义方法多半如以下伪代码所示：

floatgetLastTradePrice(string tickerSymbol)

这样，就像你从清单A所看到的那样，文档中定义了两条消息，一条代表方法的输入参数tickerSymbol（GetLastTradePriceInput消息）另一条代表该方法的返回值（GetLastTradePriceResult消息）——最新的股票价格。

*** 作把消息组织到一起而且抽象地代表方法定义。在我们的例子中，这两条消息都在 GetLastTradePrice *** 作元素下的getLastTradePrice对象方法定义中组织起来。在一个 WSDL文件中的所有 *** 作又都挨个在portType元素内分组。

WSDL文档的余下部分采用服务器上的侦听端点（binding 元素）绑定消息同时把端口定义同单一服务实体（service元素）组合起来。清单A的例子就定义了通过SOAP采用服务所需要的绑定。

WSDL工具

你可以手工创建WSDL文件，不过，你还可以采用相当多的工具通过WSDL来为你自动处理和定义Web服务。推荐工具软件如下：

Omniopera—一图形用户界面的WSDL、XML和XSD编辑器

Microsoft的SOAP Toolkit—一种工具包，其中包括根据WSDL定义创建COM接口的向导程序，还包括根据COM接口创建WSDL的向导程序

IBM的Web Services Toolkit—一种工具包，其中包括产生WSDL和SOAP部署说明的向导程序

参考网址：

http://iask.sina.com.cn/b/11632650.html

---