Web Service学习小结——WSDL文档中的节点与java类的联系

WSDL：是web service description language的首字母缩写。意思是web服务描述语言。 
那么他到底描述了什么东西呢？ 
根据我这几天在网上的各种信息收录。它主要描述了三方面的内容 即 what， how， where 
what：描述了web service能够做什么 
how：描述我们应该如何访问web service 
where：描述我们的服务在哪里 

为了讲解WSDL文件的结构以及java类的关系，我们必然要先看看WSDL文档长得如何。 
我们利用myeclipse创建一个wsdl文件  步骤如图：  
 
 
 
 
创建后的文件内容如下：  

Java代码  

1. <?xml version="1.0" encoding="UTF-8" standalone="no"?>  
2. <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/">  
3.     
4.   <wsdl:types>  
5.     <xsd:schema targetNamespace="http://www.example.org/NewWSDLFile/">  
6.       <xsd:element name="NewOperation">  
7.         <xsd:complexType>  
8.           <xsd:sequence>  
9.             <xsd:element name="in" type="xsd:string"/>  
10.           </xsd:sequence>  
11.         </xsd:complexType>  
12.       </xsd:element>  
13.       <xsd:element name="NewOperationResponse">  
14.         <xsd:complexType>  
15.           <xsd:sequence>  
16.             <xsd:element name="out" type="xsd:string"/>  
17.           </xsd:sequence>  
18.         </xsd:complexType>  
19.       </xsd:element>  
20.     </xsd:schema>  
21.   </wsdl:types>  
22.    
23.   <wsdl:message name="NewOperationRequest">  
24.     <wsdl:part element="tns:NewOperation" name="parameters"/>  
25.   </wsdl:message>  
26.   <wsdl:message name="NewOperationResponse">  
27.     <wsdl:part element="tns:NewOperationResponse" name="parameters"/>  
28.   </wsdl:message>  
29.    
30.   <wsdl:portType name="NewWSDLFile">  
31.     <wsdl:operation name="NewOperation">  
32.       <wsdl:input message="tns:NewOperationRequest"/>  
33.       <wsdl:output message="tns:NewOperationResponse"/>  
34.     </wsdl:operation>  
35.   </wsdl:portType>  
36.    
37.   <wsdl:binding name="NewWSDLFileSOAP" type="tns:NewWSDLFile">  
38.      
39.     <soap:binding style="document" transport="http://schemas.xmlsoap.org/soap/http"/>  
40.      
41.     <wsdl:operation name="NewOperation">  
42.       <soap:operation soapAction="http://www.example.org/NewWSDLFile/NewOperation"/>  
43.       <wsdl:input>  
44.         <soap:body use="literal"/>  
45.       </wsdl:input>  
46.       <wsdl:output>  
47.         <soap:body use="literal"/>  
48.       </wsdl:output>  
49.     </wsdl:operation>  
50.   </wsdl:binding>  
51.    
52.   <wsdl:service name="NewWSDLFile">  
53.     <wsdl:port binding="tns:NewWSDLFileSOAP" name="NewWSDLFileSOAP">  
54.       <soap:address location="http://www.example.org/"/>  
55.     </wsdl:port>  
56.   </wsdl:service>  
57. </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代码  

1. <wsdl:operation name="NewOperation">  
2.       <wsdl:input message="tns:NewOperationRequest"/>  
3.       <wsdl:output message="tns:NewOperationResponse"/>  
4.     </wsdl:operation>  

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

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