`

WebService CXF学习(入门篇3):WSDL描述

 
阅读更多

 由于网上有很多相关这方面的资料,在这里我就转载http://www.ibm.com/developerworks/cn/webservices/ws-wsdl/index.html一篇,不再重新讲述了。 
    本文初步介绍了Web Service 'stack'中对于Web服务即时装配,自动集成起着关键作用的WSDL规范,首先介绍了WSDL的作用和意义,其次对WSDL文档的结构作出概要地介绍,对每个元素的作用作了探讨,分析了其开放和复用的体系设计的思想,最后通过一个实例详细说明了WSDL的工作模式。 

    本文所引用的资源主要包括两类,一类是Web服务的技术资源网站,包含了大量Web服务的技术信息,另一类是Web服务“stack"系列技术规范,他们是一个整体的技术体系,包括UDDI、SOAP、WSDL、XML等。本文的最后给出了这些资源的链接,有兴趣的读者可以通过这些资源链接找到所需的内容。 

Web Service "Stack" 

    在我的先前的文章中,我已经介绍过Web服务的整个技术体系Web Service "stack",如下图: 

Figure 1. Web Service "stack" 

 
其中,绿色部分是先前已经定义好的并且广泛使用的传输层和网络层的标准:IP、HTTP、SMTP等。而蓝色部分是目前开发的Web服务的相关标准协议,包括服务调用协议SOAP、服务描述协议WSDL和服务发现/集成协议UDDI,以及服务工作流描述语言WSFL。而橙色部分描述的是更高层的待开发的关于路由、可靠性以及事务等方面的协议。黄色部分是各个协议层的公用机制,这些机制一般由外部的正交机制来完成。 

其中,一个可以使用的Web服务应当按照需要选用若干层次的功能,而无需所有的特性。但是无论如何为了实现一个一般意义上的Web服务,具备Web服务的基础特性:跨平台调用和接口可机器识别,那么必需使用WSDL和SOAP。SOAP是用来最终完成Web服务调用的,而WSDL则是用于描述如何使用 SOAP来调用Web服务的。 

    WSDL 是一种XML Application,他将Web服务描述定义为一组服务访问点,客户端可以通过这些服务访问点对包含面向文档信息或面向过程调用的服务进行访问(类似远程过程调用)。WSDL首先对访问的操作和访问时使用的请求/响应消息进行抽象描述,然后将其绑定到具体的传输协议和消息格式上以最终定义具体部署的服务访问点。相关的具体部署的服务访问点通过组合就成为抽象的Web服务。 

    在具体使用中,我们可以对 WSDL 进行扩展(类似SOAP的可扩展性),这样无论通信时使用何种消息格式或网络协议,都可以对服务访问点及其使用的消息格式进行描述。在WSDL的框架中,可以使用任意的消息格式和网络协议,如同SOAP中可以使用任意的网络协议一样。在WSDL规范中,定义了如何使用SOAP消息格式、HTTP GET/POST消息格式以及MIME格式来完成Web服务交互的规范。 
WSDL概述 
    由于通信协议和消息格式在 Web 技术圈子里已经达到了标准化,我们知道在通常的开发过程中,对于对象的Interface一定具备相应的SDK描述文档,Web服务也是一种对象,只不过它是被部署在Web上而已。很自然的,我们也完全需要有对Web服务这个对象的界面的SDK描述文档。然而这两者又不尽相同,一来目前在Web上的应用已经完全接受了XML这个基本的标准,基本上所有新出台的技术都是基于XML标准的,二来Web服务的目标是即时装配,松散耦合以及自动集成的,这意味着 SDK描述文档应当是具备被机器识别的能力的。 

    也就是说,对于使用标准化的消息格式/通信协议的Web服务,它需要以某种结构化的方式(即XML)对Web服务的调用/通信加以描述,而且实现这一点也显得非常重要,这是Web服务即时装配的基本保证。WSDL正是这样一种描述语言,WSDL 定义了一套基于 XML的语法,将Web服务描述为能够进行消息交换的服务访问点的集合,从而满足了这种需求。WSDL 服务定义为分布式系统提供了可机器识别的SDK文档,并且可用于描述自动执行应用程序通信中所涉及的细节。 

    WSDL 文档将Web服务定义为服务访问点或端口的集合。在 WSDL 中,由于服务访问点和消息的抽象定义已从具体的服务部署或数据格式绑定中分离出来,因此可以对抽象定义进行再次使用:消息,指对交换数据的抽象描述;而端口类型,指操作的抽象集合。用于特定端口类型的具体协议和数据格式规范构成了可以再次使用的绑定。将Web访问地址与可再次使用的绑定相关联,可以定义一个端口,而端口的集合则定义为服务。因此,WSDL 文档在Web服务的定义中使用下列元素: 

    * Types - 数据类型定义的容器,它使用某种类型系统(一般地使用XML Schema中的类型系统)。 
    * Message - 通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。 
    * Operation - 对服务中所支持的操作的抽象描述,一般单个Operation描述了一个访问入口的请求/响应消息对。
    * PortType - 对于某个访问入口点类型所支持的操作的抽象集合,这些操作可以由一个或多个服务访问点来支持。 
    * Binding - 特定端口类型的具体协议和数据格式规范的绑定。 
    * Port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。 
    * Service - 相关服务访问点的集合。 

大家可以参考下图,来理解一下WSDL文档的结构组织: 

Figure 2. WSDL元素的对象结构示意图 

 
    其中,Types是一个数据类型定义的容器,包含了所有在消息定义中需要的XML元素的类型定义,我将在今后的文章中结合XML Schema来详细说明如何进行类型定义。 

    Message具体定义了在通信中使用的消息的数据结构,Message元素包含了一组Part元素,每个Part元素都是最终消息的一个组成部分,每个 Part都会引用一个DataType来表示它的结构。Part元素不支持嵌套(可以使用DataType来完成这方面的需要),都是并列出现。 

    PortType具体定义了一种服务访问入口的类型,何谓访问入口的类型呢?就是传入/传出消息的模式及其格式。一个PortType可以包含若干个 Operation,而一个Operation则是指访问入口支持的一种类型的调用。在WSDL里面支持四种访问入口调用的模式: 

   1. 单请求; 
   2. 单响应; 
   3. 请求/响应; 
   4. 响应/请求。 

    在这里请求指的是从客户端到Web服务端,而响应指的是从Web服务端到客户端。PortType的定义中会引用消息定义部分的一个到两个消息,作为请求或响应消息的格式。比如,一个股票查询的访问入口可能就会支持两种请求消息,一种请求消息中指明股票代码,而另一种请求消息中则会指明股票的名称,响应消息可能都是股票的价格等等。 

    以上三种结构描述了调用Web服务的抽象定义,这三部分与具体Web服务部署细节无关,是可复用的描述(每个层次都可以复用)。如果与一般的对象语言做比较的话,这部分可以堪称是IDL描述的对象,描述了对象的接口标准,但是到底对象是用哪种语言实现,遵从哪种平台的细节规范,被部署在哪台机器上则是后面的元素所描述的。

    Service描述的是一个具体的被部署的Web服务所提供的所有访问入口的部署细节,一个Service往往会包含多个服务访问入口,而每个访问入口都会使用一个Port元素来描述。 

    Port描述的是一个服务访问入口的部署细节,包括通过哪个Web地址(URL)来访问,应当使用怎样的消息调用模式来访问等。其中消息调用模式则是使用Binding结构来表示。 

    Binding结构定义了某个PortType与某一种具体的网络传输协议或消息传输协议相绑定,从这一层次开始,描述的内容就与具体服务的部署相关了。比如可以将PortType与SOAP/HTTP绑定,也可以将PortType与MIME/SMTP相绑定等。 

    在介绍了WSDL的主要元素之后,大家会发现,WSDL的设计理念完全继承了以XML为基础的当代Web技术标准的一贯设计理念:开放。WSDL允许通过扩展使用其他的类型定义语言(不光是XML Schema),允许使用多种网络传输协议和消息格式(不光是在规范中定义的这些:SOAP/HTTP,HTTP-GET/POST以及MIME等)。同时WSDL也应用了当代软件工程中的复用理念,分离了抽象定义层和具体部署层,使得抽象定义层的复用性大大增加。比如我们可以先使用抽象定义层为一类 Web服务进行抽象定义(比如UDDI Registry,抽象定义肯定是完全一致的遵循了UDDI规范),而不同的运营公司可以采用不同的具体部署层的描述结合抽象定义完成其自身的Web服务的描述。 
WSDL文档示例 
    下例是一个提供股票报价的简单Web服务的 WSDL 定义。该服务支持名为 GetLastTradePrice 的单一操作,这个操作是通过在 HTTP 上运行 SOAP 1.1 协议来实现的。该请求接受一个类型为字符串的 tickerSymbol,并返回类型为浮点数的价格。 

Java代码  收藏代码
  1. <?xml version="1.0"?>  
  2. <definitions name="StockQuote"   
  3.              targetNamespace="http://example.com/stockquote.wsdl"  
  4.              xmlns:tns="http://example.com/stockquote.wsdl"  
  5.              xmlns:xsd1="http://example.com/stockquote.xsd"  
  6.              xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"  
  7.              xmlns="http://schemas.xmlsoap.org/wsdl/">  
  8.                
  9.    
  10.   <types>  
  11.     <schema targetNamespace="http://example.com/stockquote.xsd"  
  12.             xmlns="http://www.w3.org/1999/XMLSchema">  
  13.       <element name="TradePriceRequest">  
  14.         <complexType>  
  15.           <all>  
  16.             <element name="tickerSymbol" type="string"/>  
  17.           </all>  
  18.         </complexType>  
  19.       </element>  
  20.       <element name="TradePriceResult">  
  21.         <complexType>  
  22.           <all>  
  23.             <element name="price" type="float"/>  
  24.           </all>  
  25.         </complexType>  
  26.       </element>  
  27.     </schema>  
  28.   </types>  


    上面这部分是数据类型的定义,其中为定义了两个元素的结构: 

    * TradePriceRequest(交易价格请求): 将该元素定义为包含一个字符串元素(tickerSymbol)的复合类型元素。 
    * TradePriceResult(交易价格): 将该元素定义为一个包含一个浮点数元素(price)的复合类型元素。 

Java代码  收藏代码
  1. <message name="GetLastTradePriceInput">  
  2.     <part name="body" element="xsd1:TradePriceRequest"/>  
  3.   </message>  
  4.    
  5.   <message name="GetLastTradePriceOutput">  
  6.     <part name="body" element="xsd1:TradePriceResult"/>  
  7.   </message>  


    这部分是消息格式的抽象定义,其中定义了两个消息格式: 

    * GetlastTradePriceInput(获取最后交易价格的请求消息格式): 由一个消息片断组成,该消息片断的名字是body,包含的具体元素类型是TradePriceRequest。(前面已经定义过了) 
    * GetLastTradePriceOutput(获取最后交易价格的响应消息格式) : 由一个消息片断组成,该消息片断的名字是body,包含的具体元素类型是TradePriceResult。(前面已经定义过了) 

Java代码  收藏代码
  1. <portType name="StockQuotePortType">  
  2.    <operation name="GetLastTradePrice">  
  3.      <input message="tns:GetLastTradePriceInput"/>  
  4.      <output message="tns:GetLastTradePriceOutput"/>  
  5.    </operation>  
  6.  </portType>  


    这部分定义了服务访问点的调用模式的类型,表明StockQuoteService的某个入口类型是请求/响应模式,请求消息是GetlastTradePriceInput,而响应消息是GetLastTradePriceOutput。 

Java代码  收藏代码
  1. <binding name="StockQuoteSoapBinding" type="tns:StockQuotePortType">  
  2.     <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>  
  3.       <operation name="GetLastTradePrice">  
  4.         <soap:operation soapAction="http://example.com/GetLastTradePrice"/>  
  5.           <input>  
  6.             <soap:body use="literal" namespace="http://example.com/stockquote.xsd"  
  7.                        encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>  
  8.           </input>  
  9.           <output>  
  10.             <soap:body use="literal" namespace="http://example.com/stockquote.xsd"  
  11.                        encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>  
  12.           </output>  
  13.         </soap:operation>  
  14.       </operation>  
  15.     </soap:binding>  
  16.   </binding>  


    这部分将服务访问点的抽象定义与SOAP HTTP绑定,描述如何通过SOAP/HTTP来访问按照前面描述的访问入口点类型部署的访问入口。其中规定了在具体SOAP调用时,应当使用的 soapAction是"http://example.com/GetLastTradePrice",而请求/响应消息的编码风格都应当采用SOAP 规范默认定义的编码风格" http://schemas.xmlsoap.org/soap/encoding/"。 

Java代码  收藏代码
  1. <service name="StockQuoteService">  
  2.     <documentation>股票查询服务</documentation>   
  3.     <port name="StockQuotePort" binding="tns:StockQuoteBinding">  
  4.     <soap:address location="http://example.com/stockquote"/>  
  5.     </port>  
  6.   </service>  
  7.    
  8. </definitions>  


    这部分是具体的Web服务的定义,在这个名为StockQuoteService的Web服务中,提供了一个服务访问入口,访问地址是"http://example.com/stockquote",使用的消息模式是由前面的binding所定义的。 

    按照这个WSDL文档的描述,在具体Web服务的使用中,具体发生的SOAP交互可能如下面所示: 

SOAP消息请求: 

Java代码  收藏代码
  1. POST /StockQuote HTTP/1.1  
  2. Host: example.com  
  3. Content-Type: text/xml; charset="utf-8"  
  4. Content-Length: nnnn  
  5. SOAPAction: "http://example.com/GetLastTradePrice"  
  6.   
  7. <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"  
  8.                    SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">  
  9.   <SOAP-ENV:Body>  
  10.     <m:TradePriceRequest xmlns:m="http://example.com/stockquote.xsd">  
  11.       <tickerSymbol>MSFT</tickerSymbol >  
  12.     </m:TradePriceRequest>  
  13.   </SOAP-ENV:Body>  
  14. </SOAP-ENV:Envelope>  


SOAP消息响应: 

Java代码  收藏代码
  1. HTTP/1.1 200 OK  
  2. Content-Type: text/xml; charset="utf-8"  
  3. Content-Length: nnnn  
  4.   
  5. <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"  
  6.                    SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>  
  7.   <SOAP-ENV:Body>  
  8.     <m:TradePriceResult xmlns:m=" http://example.com/stockquote.xsd ">  
  9.       <price>74.5</price>  
  10.     </m:TradePriceResult >  
  11.   </SOAP-ENV:Body>  
  12. </SOAP-ENV:Envelope>  


小结 
    在本文中,我简单介绍了WSDL规范的用途 

下面提供几个相关资料的网址 
理解 UDDI 注册中心的 WSDL 
http://www.ibm.com/developerworks/cn/webservices/ws-uwsdl/part1/index.html 
Web 服务的(革)创新 
http://www.ibm.com/developerworks/cn/webservices/ws-peer4/index.html 

 

分享到:
评论
发表评论

文章已被作者锁定,不允许评论。

相关推荐

    WebService CXF学习文档

    WebService CXF学习——入门篇 1.CXF由来 2.HelloWorld 3.WSDL描述 WebService CXF学习——进阶篇 1.SOAP讲解 2.JAX-WS讲解 3.对象传递 WebService CXF学习——高级篇(一)(二) 1.整合Spring框架 2.CXF...

    WebService CXF学习-入门篇.pdf

    **WebService CXF 学习——入门篇** **一、WebService CXF 由来与目标** Apache CXF 是一个流行的开源框架,它源自 ObjectWeb Celtix 和 CodeHaus XFire 的合并,这两个项目分别由 IONA 公司和业界知名SOAP堆栈...

    WebService CXF --- 由WSDL文件开发Client端

    在本篇中,我们将深入探讨如何利用CXF从WSDL文件开发客户端。 一、Web服务基础 Web服务是一种通过HTTP协议进行通信的应用程序接口(API)。WSDL是XML格式的规范,用于定义Web服务的接口,包括服务的位置、操作方法...

    WebService CXF 详细教程

    **WebService CXF 详解** **一、WebService简介** WebService是一种基于标准的,可以在不同操作系统、编程语言之间交换数据的Web应用程序。它通过WSDL(Web服务描述语言)定义了服务接口,利用SOAP(简单对象访问...

    webService(基于cxf)的完整例子

    6. **CXF的WSDL第一方式**:CXF也支持WSDL第一方式,即先有WSDL描述服务,然后根据WSDL自动生成Java代码。这种方式适合于已有WSDL描述的服务,或者需要严格遵循WSDL规范的情况。 7. **CXF与Spring集成**:CXF与...

    cxf实现webservice 常用注解总结

    CXF 实现WebService常用注解总结 ...使用这些注解,可以简化WebService的开发和部署,因为它们可以定义一些通常从部署描述符文件和WSDL文件中获得的附加信息,或者将元数据从XML和WSDL映射至源工件中。

    webservice cxf.jar 相关包

    3. 插件支持:CXF有丰富的插件系统,可以集成到IDE如Eclipse中,方便开发和调试。 4. 编码解码:CXF支持多种数据绑定技术,如JAXB(Java Architecture for XML Binding)和Aegis,用于XML与Java对象之间的转换。 5. ...

    使用cxf wsdl2java生成webservice客户端

    使用cxf wsdl2java生成webservice客户端命令

    webservice cxf集成servlet

    ### WebService CXF与Servlet集成详解 #### 一、项目准备与搭建 ##### 1. 创建Web Project - **项目命名**:首先,在开发环境中创建一个新的Web项目,并将其命名为`cxf_bigdata`。 ##### 2. 目录结构 - 项目的...

    Webservice-CXF实用手册学习大全

    WebService-CXF实用手册学习大全的知识点涵盖了WebService技术的多个方面,主要分为以下几个部分: 1. WebService基础: - WebService是一种通过网络提供服务的技术,使用HTTP作为传输协议,SOAP作为消息格式,...

    根据wsdl生成webservice服务端(3种方式)

    本文将详细介绍三种基于WSDL生成WebService服务端的方法:使用`wsdl2java`命令、通过SOAPUI工具及借助MyEclipse的Web Service项目功能。 #### 方法一:使用`wsdl2java`命令生成 `wsdl2java`是Apache CXF提供的一个...

    WebService CXF 对象传递 附

    **WebService CXF 对象传递详解** 在Web服务领域,CXF是一个非常重要的开源框架,它允许开发者创建和消费各种Web服务。CXF支持SOAP、RESTful等多种通信模式,并且能够处理复杂的对象传递,使得Web服务的数据交换...

    webservice cxf 客户端创建

    3. **生成客户端代码:** 完成WSDL导入后,CXF将根据WSDL生成代理类和配置文件。这些类和配置文件提供了与服务交互的接口,而无需编写复杂的SOAP消息处理代码。 4. **运行客户端:** 编写测试代码以调用生成的...

    WSDl生成WebService接口及调用

    3. 实现WebService 在Java中,使用CXF等库,可以将一个Java接口和实现类映射到WSDL定义的服务上。通过@WebService注解标记接口,@WebMethod标记服务方法,然后使用服务发布工具暴露这个接口,如CXF的JAX-WS服务器。...

    webservice_cxf Demo

    总结来说,"webservice_cxf Demo" 是一个学习 Apache CXF 开发 Web 服务的实践项目,涵盖了从服务定义、实现、部署到客户端调用的全过程。通过这个示例,开发者可以深入理解 CXF 的工作原理和使用方法,为构建自己的...

    webservice使用cxf的实例

    【描述】:虽然描述为空,但我们可以从中推断出这篇文章可能是一个关于如何使用CXF框架来创建和部署Web服务的实际操作指南。通常,这样的教程会涵盖基本概念、环境设置、代码编写、服务部署以及测试等步骤。 【标签...

    webService CXF集成例子

    CXF允许开发者以Java编程模型的方式编写服务,同时也支持XML-first的方法,即从WSDL(Web服务描述语言)开始构建服务。 2. **CXF与Spring的关系**: 虽然CXF通常与Spring框架一起使用,因为它可以很好地集成到...

    WebService_CXF范例.

    【WebService CXF详解与入门】 WebService是一种允许不同系统之间进行通信和交互的标准协议,它基于HTTP协议,使得应用程序可以无视具体实现细节地调用互联网上的服务。这种技术使得分布式应用程序的发展成为可能,...

    Java webservice cxf客户端调用demo和服务端

    3. 配置服务:使用CXF提供的注解(如`@WebService`)标记接口和实现类,指定服务的元数据,如服务名、端点地址等。 4. 发布服务:通过CXF的Server类实例化并启动服务,使其可供客户端调用。 **客户端调用:** 1. ...

Global site tag (gtag.js) - Google Analytics