wsdl类,wsdl生成代理类
什么是wsdl
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部署说明的向导程序
什么是WSDL?
·服务做些什么——服务所提供的操作(方法)·如何访问服务——和服务交互的数据格式以及必要协议·服务位于何处——协议相关的地址,如URLWSDL文档以端口集合的形式来描述Web服务,WSDL 服务描述包含对一组操作和消息的一个抽象定义,绑定到这些操作和消息的一个具体协议,和这个绑定的一个网络端点规范。WSDL 文档被分为两种类型:服务接口(service interface )和 服务实现(service implementations),文档基本结构框架如下:
服务接口文档中的主要元素作用分别为:types:定义了Web服务使用的所有数据类型集合,可被元素的各消息部件所引用。它使用某种类型系统(一般地使用XML Schema中的类型系统)。 message:通信消息数据结构的抽象类型化定义。
wsdl文件生成的java类怎么用
根据wsdl文件生成webservice代码下边我们可以根据这个Axis2Demo.wsdl文件生成java代码,这些代码用于客户端和服务器端进行连接,也有客户端的代码。生成代码的具体步骤如下:选择菜单“File-New-Other”,从对话框中选取“Axis2Wizards”下面的“Axis2CodeGenerator”点击Next下一步进入如下页面:点击Next下一步进入如下页面:在该页面选择刚才建好的Axis2Demo.wsdl文件点击Next下一步进入如下页面:在上边的图中选中custom和GenrateAll注意:上图中的Custompackagename是客户端代码的包名字这里把它改为:com.neusoft.axis2demo.client做为客户端的包名。然后点击Next下一步:进入如下图在OoutputPath这项选中工程的根目录作为这些自动生成代码的目录.然后点击finish完成代码生成工作.下图为生成代码后的工程目录结构下边介绍一下生成的代码的用途其中包(1):com.neusoft.axis2demo.client是客户端代码,第三方使用的.(2):com.neusoft.axis2demo.services.xsd是第三方调用webservice的传入参数和返回参数.(3):com.neusoft.axis2demo.common.xsd中的类是(2)的参数。其中第三方只需要调用com.neusoft.axis2demo.client中的Axis2DemoStub类中的nameConvertToContext方法就行了这个类的雏形是下边这样的。publiccom.neusoft.axis2demo.services.xsd.NameConvertToContextResponsenameConvertToContext(com.neusoft.axis2demo.services.xsd.NameConvertToContextparam22)throwsjava.rmi.RemoteException{return(com.neusoft.axis2demo.services.xsd.NameConvertToContextResponse)object;//TODO}其中红色部分是(2)包中的类他们作为参数传入和返回,同时红色的类中也有set和get方法用来存储(3)com.neusoft.axis2demo.common.xsd包中的类.
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 :对一组消息的输入和输出参数的定义。