学习 WebService 第二步：知识准备——WSDL文件解析

原文地址：https://www.cnblogs.com/yzw23333/p/7245104.html

Web service中一个 WSDL 对应一个 web service地址。

可以想象成一个商店，商店里面出售很多手机（portTypes）,每个手机上有很多功能(opeations),每个功能对应很多输入和输出参数（message）  

• 这里没有类，只有端口。portTypes
• 没有方法，只有端口里面的操作。opeations
• 没有参数，只有传递给端口中某个操作的消息。message

---

一、WSDL文件解析

xml文档第一句：

definitions--WSDL文档的根元素，该元素的属性指明了WSDL文档的名称name，

文档的目标名字空间targetNamespace，以及WSDL文档应用的名字空间的速记定义。

它指明了此WebService的名称为：HelloWorldService

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

<wsdl:definitions xmlns:ns1="http://schemas.xmlsoap.org/soap/http" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="http://test.demo1/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" name="HelloWorldService" targetNamespace="http://test.demo1/">

<wsdl:types>

<xs:schema xmlns:tns="http://test.demo1/" xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="unqualified" targetNamespace="http://test.demo1/" version="1.0">

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

• sayHello(请求参数的类型): 将该元素定义为包含一个字符串string元素(arg0)的复合类型元素。
• sayHelloResponse(响应参数的类型):  将该元素定义为包含一个字符串string元素(return)的复合类型元素。

其中的name="arg0", name="return"中的“arg0”，“return”是可以指定的，因为HelloWorld输入输出参数都是使用的默认的参数名，所以生成的xml是这样子。

<xs:element name="sayHello" type="tns:sayHello"/>

<xs:element name="sayHelloResponse" type="tns:sayHelloResponse"/>

<xs:complexType name="sayHello">

<xs:sequence>

　　<xs:element minOccurs="0" name="arg0" type="xs:string"/>

</xs:sequence>

</xs:complexType>

<xs:complexType name="sayHelloResponse">

<xs:sequence>

　　<xs:element minOccurs="0" name="return" type="xs:string"/>

</xs:sequence>

</xs:complexType>

</xs:schema>

</wsdl:types>

其中的name="arg0", name="return"中的“arg0”，“return”是可以指定的，因为HelloWorld输入输出参数都是使用的默认的参数名，所以生成的xml是这样子。

如果HelloWorld接口中的方法修改成：

1 public @WebResult(name="responseResult")String sayHello(@WebParam(name="name")String name) ;  

 也就是给输入参数与返回结果指定一个选定的名字，则生成的xml如下所示：

 1 <xs:complexType name="sayHello">  
 2 　　<xs:sequence>  
 3 　　　　<xs:element minOccurs="0" name="name" type="xs:string"/>  
 4 　　</xs:sequence> 
 5 </xs:complexType>  
 6 <xs:complexType name="sayHelloResponse">  
 7 　　<xs:sequence>  
 8 　　　　<xs:element minOccurs="0" name="responseResult" type="xs:string"/>  
 9 　　</xs:sequence>  
10 </xs:complexType> 

下面这部分是消息格式的抽象定义，其中定义了两个消息格式：

• sayHelloResponse( 响应消息格式 ): 由一个消息片断组成，该消息片断的名字是parameters，包含的具体元素类型是sayHelloResponse。
• sayHello( 请求消息格式 ) : 由一个消息片断组成，该消息片断的名字是 parameters，包含的具体元素类型是sayHello。

<wsdl:message name="sayHelloResponse">

<wsdl:part element="tns:sayHelloResponse" name="parameters">

</wsdl:part>

</wsdl:message>

<wsdl:message name="sayHello">

<wsdl:part element="tns:sayHello" name="parameters">

</wsdl:part>

</wsdl:message>

portType---描述服务逻辑接口的operation元素的集合。HelloWorld只有一个操作sayHello.

这部分定义了服务访问点的调用模式的类型，表明 HelloWorld Service的sayHello入口类型是请求/响应模式，请求消息是sayHello，而响应消息是sayHelloResponse。

<wsdl:portType name="HelloWorld">

<wsdl:operation name="sayHello">

<wsdl:input message="tns:sayHello" name="sayHello">

</wsdl:input>

<wsdl:output message="tns:sayHelloResponse" name="sayHelloResponse">

</wsdl:output>

</wsdl:operation>

</wsdl:portType>

binding---一个endpoint的实际数据格式说明，一个binding元素定义如何将一个抽象消息映射到一个具体数据格式。该元素指明诸如参数顺序，返回值等信息。           

每个被支持的信息格式和信息传送方式组合，就叫做 binding  （soap:binding 就是用 soap语言通话  ）

这段xml定义的操作“sayHello”使用的是SoapDocumentProtocol消息格式（style="document"）。输入和输出参数格式都是“Literal”（use="literal"）

<wsdl:binding name="HelloWorldServiceSoapBinding" type="tns:HelloWorld">

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

<wsdl:operation name="sayHello">

<soap:operation soapAction="" style="document"/>

<wsdl:input name="sayHello">

　　<soap:body use="literal"/>

</wsdl:input>

<wsdl:output name="sayHelloResponse">

　　<soap:body use="literal"/>

</wsdl:output>

</wsdl:operation>

</wsdl:binding>

找到名为“HelloWorldService”的service具体定义如下所示：

service---相关port元素的集合，用户组织endpoint定义。

port--通过binding和物理地址定义的endpoint，这个元素将所有抽象定义聚集在一起。

这部分是具体的Web服务的定义，在这个名为 HelloWorldService的Web服务中，

提供了一个服务访问入口，访问地址是"http://localhost:8080/helloWorld"，

使用的消息模式是由前面的binding “HelloWorldServiceSoapBindin”所定义的。

<wsdl:service name="HelloWorldService">

　　<wsdl:port binding="tns:HelloWorldServiceSoapBinding" name="HelloWorldPort">

　　　　<soap:address location="http://localhost:8080/helloWorld"/>

　　</wsdl:port>

</wsdl:service>

</wsdl:definitions>

二、请求及响应的具体消息格式解析

• 请求消息

- <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:q0="http://test.demo1/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">  
- <soapenv:Body>  
- <q0:sayHello>  
  <arg0>xxl</arg0>   
  </q0:sayHello>  
  </soapenv:Body>  
  </soapenv:Envelope>

• 响应消息

- <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">  
- <soap:Body>  
- <sayHelloResponse xmlns:ns2="http://test.demo1/">  
  <return>hello xxl</return>   
  </sayHelloResponse>  
  </soap:Body>  
  </soap:Envelope>