【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进行相互验证