WSDL文档中的节点与java类的联系

WSDL：是web service description language的首字母缩写。意思是web服务描述语言。 

那么他到底描述了什么东西呢？ 

根据我这几天在网上的各种信息收录。它主要描述了三方面的内容 即 what， how， where 

what：描述了web service能够做什么 

how：描述我们应该如何访问web service 

where：描述我们的服务在哪里 

为了讲解WSDL文件的结构以及java类的关系，我们必然要先看看WSDL文档长得如何。 

我们利用myeclipse创建一个wsdl文件  步骤如图： 


 


 


 


 
创建后的文件内容如下： 

Java代码  


<?xml version="1.0" encoding="UTF-8" standalone="no"?>  

<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://www.example.org/NewWSDLFile/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="NewWSDLFile" targetNamespace="http://www.example.org/NewWSDLFile/">  

    

  <wsdl:types>  

    <xsd:schema targetNamespace="http://www.example.org/NewWSDLFile/">  

      <xsd:element name="NewOperation">  

        <xsd:complexType>  

          <xsd:sequence>  

            <xsd:element name="in" type="xsd:string"/>  

          </xsd:sequence>  

        </xsd:complexType>  

      </xsd:element>  

      <xsd:element name="NewOperationResponse">  

        <xsd:complexType>  

          <xsd:sequence>  

            <xsd:element name="out" type="xsd:string"/>  

          </xsd:sequence>  

        </xsd:complexType>  

      </xsd:element>  

    </xsd:schema>  

  </wsdl:types>  

   

  <wsdl:message name="NewOperationRequest">  

    <wsdl:part element="tns:NewOperation" name="parameters"/>  

  </wsdl:message>  

  <wsdl:message name="NewOperationResponse">  

    <wsdl:part element="tns:NewOperationResponse" name="parameters"/>  

  </wsdl:message>  

   

  <wsdl:portType name="NewWSDLFile">  

    <wsdl:operation name="NewOperation">  

      <wsdl:input message="tns:NewOperationRequest"/>  

      <wsdl:output message="tns:NewOperationResponse"/>  

    </wsdl:operation>  

  </wsdl:portType>  

   

  <wsdl:binding name="NewWSDLFileSOAP" type="tns:NewWSDLFile">  

     

    <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>  

     

    <wsdl:operation name="NewOperation">  

      <soap:operation soapAction="http://www.example.org/NewWSDLFile/NewOperation"/>  

      <wsdl:input>  

        <soap:body use="literal"/>  

      </wsdl:input>  

      <wsdl:output>  

        <soap:body use="literal"/>  

      </wsdl:output>  

    </wsdl:operation>  

  </wsdl:binding>  

   

  <wsdl:service name="NewWSDLFile">  

    <wsdl:port binding="tns:NewWSDLFileSOAP" name="NewWSDLFileSOAP">  

      <soap:address location="http://www.example.org/"/>  

    </wsdl:port>  

  </wsdl:service>  

</wsdl:definitions>  

通过myeclipse帮我们创建的wsdl文档，我们观察它的结构发现： 

一份WSDL文档definitions基本上有以下部分： 

types，message，portType，binding，service。 

知道包含了这些元素，我们先解释这些元素都是干嘛的，然后在说与java类的对应关系，那时候你会惊叹——“哦，原来是这样”。 好吧，不扯了。 

types：定义了文档中要用的类型，由于web service跟编程语言是没有关系的，那么我们这里的类型必然是公用的，而XML是独立于平台的语言。所以，这里使用的是XML Schema的类型，在我们刚刚创建的文档中，他包含了两个元素，分别是newOperation和newOperationResponse，这两个元素都是复杂类型的，如果你对xml的schema还不怎么了解，可以到网上找找。必要的情况下，我也会写成简单的博客了。 

message：通信消息数据结构的抽象类型化定义。（好吧，这个确实很抽象） 

portType：对于某个访问入口点类型所支持操作的抽象集合 

binding：包含了如何将抽象接口的元素（portType）转变为具体表示的细节，具体表示也就是指特定的数据格式和协议的结合；特定端口类型的具体协议和数据格式规范的绑定。 

service：这是一个粗糙命名的元素，代表端口的集合；相关服务点的集合。 

看完上面的定义，貌似很复杂，确实很不好理解。但是把他对应到java类的关系会好理解很多。下面的讲解都跟上面的文档关联起来讲的。 

types这个跟xml的schema有关的。在schema定义里面的element是代表可以在xml文档中写的元素。牵强一点说，类似于我们java中的变量。 

message，上面说的是数据结构的抽象化定义，其实就是参数的定义。在而参数的具体信息则由part表示，我们在上面的文档中已然看到在message元素的子元素中有part元素。而part元素就是我们的参数定义。不管输入参数还是输出参数，我们都是用一个part表示一个参数。好比我们的java类中。有一个方法有四个参数，那么我们就需要定义四个part来表示这四个参数，然后将这是个part定义在一个message中，而这个message则表示这个java方法的输入参数。 但是，我们在契约优先的开发模式中，有一种是基于封装的模式，也就是说，把所有的输入参数都当成一个复杂类型，而这个复杂类型用一个element表示。然后在将这个element作为part的属性。
这种方式也是可行的。甚至是推荐的。 

portType：简单的说就是接口的定义。我们在java中，每一个接口可能会声明多个方法，对应的，在portType我们也可以声明多个方法，而方法的在WSDL中是用<operation>来表示的、 

Java代码  


<wsdl:operation name="NewOperation">  

      <wsdl:input message="tns:NewOperationRequest"/>  

      <wsdl:output message="tns:NewOperationResponse"/>  

    </wsdl:operation>  

operation可以包含input，output，fault。在我们创建的文档中包含了input和output分别代表输入参数和输出参数（即我们的返回值）。input的message属性就指向我们所定义的输入参数同理，output指的就是我们的返回值（引申义就是我们的代表返回值得message应该只有一个part） 

参考：http://www.w3.org/TR/wsdl.html