【WebService】WebService之WSDL文档深入分析（三）

WSDL概念

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

WSDL 文档结构

　　首先发布一个简单的WebService（参照：【WebService】使用JDK开发WebService（二）），在发布的WebService地址后面加上'?wsdl'，得到wsdl文件地址（http://127.0.0.1:8989/test-webservice/hellows?wsdl），使用浏览器打开。

　　重要标签说明：　　

　　　　types - 数据类型(标签)定义的容器，里面使用schema定义了一些标签结构供message引用
　　　　message - 通信消息的数据结构的抽象类型化定义。引用types中定义的标签
　　　　operation - 对服务中所支持的操作的抽象描述，一个operation描述了一个访问入口的请求消息与响应消息对。
　　　　portType - 对于某个访问入口点类型所支持的操作的抽象集合，这些操作可以由一个或多个服务访问点来支持。
　　　　binding - 特定端口类型的具体协议和数据格式规范的绑定。
　　　　service- 相关服务访问点的集合
　　　　port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。

　　1、文档结构

 <definitions>

     <types>

         <schema>

             <element>

     </types>

     <message>

         <part>

     </message>

     <portType>

         <operation>

             <input>

             <output>

     </portType>

     <binding>

         <operation>

             <input>

             <output>

     </binding>

     <service>

         <port>

             <address>

     </service>

 </definitions>

　　2、文档详解

　　　　http://127.0.0.1:8989/test-webservice/hellows?wsdl文件详解

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

 <definitions

     xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd"

     xmlns:wsp="http://www.w3.org/ns/ws-policy"

     xmlns:wsp1_2="http://schemas.xmlsoap.org/ws/2004/09/policy"

     xmlns:wsam="http://www.w3.org/2007/05/addressing/metadata"

     xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"

     xmlns:tns="http://ws.test.com/"

     xmlns:xsd="http://www.w3.org/2001/XMLSchema"

     xmlns="http://schemas.xmlsoap.org/wsdl/"

     targetNamespace="http://ws.test.com/"

     name="HelloWSImplService">

     <!--

         types

             schema : 定义了一些标签结构

     -->

     <types>

         <xsd:schema>

             <!-- 此处引用的sehemaLocation地址，可以使用浏览器打开，获取schema约束 -->

             <xsd:import namespace="http://ws.test.com/"

                 schemaLocation="http://127.0.0.1:8989/test-webservice/hellows?xsd=1"></xsd:import>

         </xsd:schema>

     </types>

     <!--

         message : 用于定义消息的结构 soap消息

             part ：指定引用types中定义的标签片段

     -->

     <message name="sayHello">

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

     </message>

     <message name="sayHelloResponse">

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

     </message>

     <!--

         portType : 用来定义服务器端的SEI

             operation ： 用来指定SEI中处理请求的方法

                 input ： 指定客户端应用传过来的数据，会引用上面的定义的<message>

                 output : 指定服务器端返回给客户端的数据，会引用上面定义的<message>

     -->

     <portType name="HelloWSImpl">

         <operation name="sayHello">

             <input wsam:Action="http://ws.test.com/HelloWSImpl/sayHelloRequest" message="tns:sayHello"></input>

             <output wsam:Action="http://ws.test.com/HelloWSImpl/sayHelloResponse" message="tns:sayHelloResponse"></output>

         </operation>

     </portType>

     <!--

         binding : 用于定义SEI的实现类

             type属性：引用上面的<portType>

             <soap:binding style="document"> ：绑定的数据是一个document（xml）

             operation ： 用来定义实现的方法

                 <soap:operation style="document" /> 传输的是document（xml）

                 input ： 指定客户端引用传过来的数据

                     <soap:body use="literal"> ：文本数据

                 output ： 指定服务端返回给客户端的数据

                     <soap:body use="literal"> ：文本数据

     -->

     <binding name="HelloWSImplPortBinding" type="tns:HelloWSImpl">

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

         <operation name="sayHello">

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

             <input>

                 <soap:body use="literal"></soap:body>

             </input>

             <output>

                 <soap:body use="literal"></soap:body>

             </output>

         </operation>

     </binding>

     <!--

         service ： 一个webservice的容器

             name属性 ： 它用已指定客户端容器类

             port ： 用来指定一个服务器端处理请求的入口（就是SEI的实现）

                 binding属性 ： 引用上面定义的<binding>

                 address ： 当前webservice的请求地址

     -->

     <service name="HelloWSImplService">

         <port name="HelloWSImplPort" binding="tns:HelloWSImplPortBinding">

             <soap:address location="http://127.0.0.1:8989/test-webservice/hellows"></soap:address>

         </port>

     </service>

 </definitions>

　　　　引用的http://127.0.0.1:8989/test-webservice/hellows?xsd=1， schema约束如下：

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

 <!-- Published by JAX-WS RI at http://jax-ws.dev.java.net. RI's version is JAX-WS RI 2.2.4-b01. -->

 <!--

     shecma约束

     用于请求：

         <sayHello>

             <arg0>string</arg0>

         </sayHello>

     用于响应：

         <sayHelloResponse>

             <return>string</return>

         </sayHelloResponse>

 -->

 <xs:schema xmlns:tns="http://ws.test.com/"

     xmlns:xs="http://www.w3.org/2001/XMLSchema"

     version="1.0"

     targetNamespace="http://ws.test.com/">

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

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

     <xs:complexType name="sayHello">

         <xs:sequence>

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

         </xs:sequence>

     </xs:complexType>

     <xs:complexType name="sayHelloResponse">

         <xs:sequence>

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

         </xs:sequence>

     </xs:complexType>

 </xs:schema>

　　3、文档图解图
　　　　　　

　　　　　　注：可以通过查看webservice的请求消息和响应消息（【WebService】使用JDK开发WebService（二）--》使用JDK开发WebService--》a、开发WebService服务端--》7、查看发送消息和响应消息的具体内容），来与wsdl文件中的message进行相互验证