gSoap开发（三）——WSDL简介

gSoap开发（三）——WSDL简介

一、WSDL简介

1、WSDL简介

        WSDL（网络服务描述语言，Web Services Description Language）是一门基于XML的语言，用于描述WebService以及如何对它们进行访问。

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

2、WSDL文档

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

        WSDL文档通常包含7个重要的元素，即types、import、message、portType、operation、binding、service元素。所有元素嵌套在definitions元素中，definitions是WSDL文档的根元素。

    Types - 数据类型定义的容器，使用某种类型系统(一般地使用XML Schema中的类型系统)。

    Message - 通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。

    Operation - 对服务中所支持的操作的抽象描述，一般单个Operation描述了一个访问入口的请求/响应消息对。

    PortType - 对于某个访问入口点类型所支持的操作的抽象集合，这些操作可以由一个或多个服务访问点来支持。

    Binding - 特定端口类型的具体协议和数据格式规范的绑定。

    Port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。

    Service- 相关服务访问点的集合。

WSDL文档主要结构如下：

   definition of types........
   definition of a message....
   definition of a port.......
   definition of a binding....

WSDL文档实例：

        元素把"glossaryTerms"定义为某个端口的名称，把 "getTerm"定义为某个操作的名称。

    操作"getTerm"拥有一个名为"getTermRequest"的输入消息，以及一个名为"getTermResponse"的输出消息。

        元素可定义每个消息的部件，以及相关联的数据类型。

    对比传统的编程，glossaryTerms是一个函数库，而"getTerm"是带有输入参数"getTermRequest"和返回参数getTermResponse的一个函数。

3、WSDL文档阅读

    WSDL文档的阅读顺序从下往上读。

    每个WSDL有且只有一个Service节点。

    A、先找Service节点

    B、Service节点中找port节点。每个port对应一个PortType。

    C、Port节点对应一binding节点。每个binding节点对应一个PortType

    D、PortType中有operation 节点就是服务的方法。

    E、operation 中有Input（参数）和output（返回值）

    F、Input（参数）和output（返回值）对应message节点

    G、Message对应element节点。Element节点对应complexType节点描述了参数及返回值的数据类型。

二、WSDL文档解析

简单的Web Service的WSDL文档如下：

    服务支持名为sayHello的唯一操作，sayHello操作通过在http上运行SOAP协议来实现的。请求接受一个字符串name，经过处理后返回一个简单的字符串。

1、definitions元素

    所有的WSDL文档的根元素均是definitions元素。definitions元素封装了整个文档，同时通过其name提供了一个WSDL文档。除了提供一个命名空间外，definitions元素没有其他作用。

2、types元素

         WSDL采用了W3C XML模式内置类型作为其基本类型系统。types元素用作一个容器，用于定义XML模式内置类型中没有描述的各种数据类型。当声明消息部分的有效负载时，消息定义使用了在types元素中定义的数据类型和元素。在本文的WSDL文档中的types定义：

    数据定义部分定义了两个元素，一个是sayHello，一个是sayHelloResponse：

        sayHello：定义了一个复杂类型，仅仅包含一个简单的字符串，将来用来描述操作的参入传入部分；

        sayHelloResponse：定义了一个复杂类型，仅仅包含一个简单的字符串，将来用来描述操作的返回值；

3、import元素

        import元素使得可以在当前的WSDL文档中使用其他WSDL文档中指定的命名空间中的定义元素。本例中没有使用import元素。通常在用户希望模块化WSDL文档的时候，import功能是非常有效果的。

        import的格式如下：

    必须有namespace属性和location属性：

        namespace属性：值必须与正导入的WSDL文档中声明的targetNamespace相匹配；

        location属性：必须指向一个实际的WSDL文档，并且该文档不能为空。

4、message元素

        message元素描述了Web服务使用消息的有效负载。message元素可以描述输出或者接受消息的有效负载；还可以描述SOAP文件头和错误detail元素的内容。定义message元素的方式取决于使用RPC样式还是文档样式的消息传递。在本文中的message元素的定义，本文档使用了采用文档样式的消息传递：

    消息格式的抽象定义：定义了两个消息sayHelloResponse和sayHelloRequest：

        sayHelloRequest：sayHello操作的请求消息格式，由一个消息片断组成，名字为parameters,元素是我们前面定义的types中的元素；

        sayHelloResponse：sayHello操作的响应消息格式，由一个消息片断组成，名字为parameters,元素是我们前面定义的types中的元素；

     如果采用RPC样式的消息传递，只需要将文档中的element元素应以修改为type即可。

5、portType元素

        portType元素定义了Web服务的抽象接口。该接口有点类似Java的接口，都是定义了一个抽象类型和方法，没有定义实现。在WSDL中，portType元素是由binding和service元素来实现的，这两个元素用来说明Web服务实现使用的Internet协议、编码方案以及Internet地址。

    一个portType中可以定义多个operation，一个operation可以看作是一个方法，本文中WSDL文档的定义：

        portType定义了服务的调用模式的类型，包含一个操作sayHello方法，同时包含input和output表明该操作是一个请求／响应模式，请求消息是前面定义的sayHelloRequest，响应消息是前面定义的sayHelloResponse。input表示传递到Web服务的有效负载，output消息表示传递给客户的有效负载。

6、binding

        binding元素将一个抽象portType映射到一组具体协议(SOAO和HTTP)、消息传递样式、编码样式。通常binding元素与协议专有的元素和在一起使用，本文中的例子：

    binding元素将服务访问点的抽象定义与SOAP HTTP绑定，描述如何通过SOAP/HTTP来访问按照前面描述的访问入口点类型部署的访问入口。其中规定了在具体SOAP调用时，应当使用的soapAction是""。

7、service元素和port元素

        service元素包含一个或者多个port元素，其中每个port元素表示一个不同的Web服务。port元素将URL赋给一个特定的binding，甚至可以使两个或者多个port元素将不同的URL赋值给相同的binding。文档中的例子：

    这部分是具体的Web服务的定义，在这个名为HelloService的Web服务中，提供了一个服务访问入口，访问地址是http://localhost:8080/xfire/services/HelloService，使用的消息模式是由前面的binding所定义的。