一个完整的WSDL文档及各标签详解

<?xml version="1.0" encoding="UTF8" ?>

<wsdl:definitions targetNamespace="http://www.57market.com.cn/HelloService" 
    xmlns:soapenc12="http://www.w3.org/2003/05/soapencoding" 
    xmlns:tns="http://www.57market.com.cn/HelloService" 
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" 
    xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
    xmlns:soap11="http://schemas.xmlsoap.org/soap/envelope/" 
    xmlns:wsdlsoap="http://schemas.xmlsoap.org/wsdl/soap/" 
    xmlns:soapenc11="http://schemas.xmlsoap.org/soap/encoding/" 
    xmlns:soap12="http://www.w3.org/2003/05/soapenvelope">

 


/**
 * types元素,定义了交换信息的数据格式。
 * 为了实现最大的互操作性（interoperability）和平台中立性（neutrality），
 * WSDL选用XML Schema DataTypes简称XSD作为标准类型系统，并将它作为固有类型系统。
 *
 * 下面是数据定义部分，该部分定义了两个元素，一个是sayHello，一个是sayHelloResponse：
 * sayHello：定义了一个复杂类型，仅仅包含一个简单的字符串，将来用来描述操作的参入传入部分；
 * sayHelloResponse：定义了一个复杂类型，仅仅包含一个简单的字符串，将来用来描述操作的返回值；
 */


<wsdl:types>

    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                attributeFormDefault="qualified" 
                elementFormDefault="qualified" 
                targetNamespace="http://www.57market.com.cn/HelloService">
                

        <xsd:element name="sayHello">
            <xsd:complexType>
                <xsd:sequence>
                    <xsd:element maxOccurs="1" minOccurs="1" name="in0" nillable="true" type="xsd:string" />
                </xsd:sequence>
            </xsd:complexType>
        </xsd:element>


        <xsd:element name="sayHelloResponse">
            <xsd:complexType>
                <xsd:sequence>
                    <xsd:element maxOccurs="1" minOccurs="1" name="out" nillable="true" type="xsd:string" />
                </xsd:sequence>
            </xsd:complexType>
        </xsd:element>

 
    </xsd:schema>
  </wsdl:types>

 

/**
 * message元素是交换信息的抽象定义。
 * 需要分别定义用于作为输入参数的消息和输出参数的消息。
 *
 * 定义了两个消息 sayHelloRequest 和 sayHelloResponse：
 * sayHelloRequest：sayHello操作的请求消息格式。由一个消息片断（part）组成。
 * 片段的名字为 parameters, 片段的元素是我们前面定义的types中的元素；
 * sayHelloResponse：sayHello操作的响应消息格式。由一个消息片断（part）组成。
 * 片段的名字为 parameters, 片段的元素是我们前面定义的types中的元素；
 *
 * 如果采用RPC样式的消息传递，只需要将文档中的element元素应以修改为type即可。
 *
 * - message：用來定義消息的結構
 * - part：指定引用types中定義的標籤片斷
 *
 */

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

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

 

/**

 * portType元素中定义了Web服务的操作。一些抽象操作的集合。
 * 操作定义了输入和输出数据流中可以出现的XML消息。
 * 每个操作关联一个输入消息和一个输出消息。

 * 这里包含一个操作（operation）：sayHello方法，
 * 同时包含input和output表明该操作是一个 请求／响应模式，
 * 
 * input请求的消息体是前面定义的 sayHelloRequest。
 * output响应的消息体是前面定义的 sayHelloResponse。

 *  - portType：用來定義服務端的SEI
 *  - operation：用來指定SEI中的處理請求的方法
 *  - input：指定客戶端應用傳過來的數據，會引用上面的而定義的message
 *  - output:指定服務端返回給客戶端的數據，會引用上面的而定義的message
 */

<wsdl:portType name="HelloServicePortType">

    <wsdl:operation name="sayHello">
        <wsdl:input name="sayHelloRequest" message="tns:sayHelloRequest" />
        <wsdl:output name="sayHelloResponse" message="tns:sayHelloResponse" />
    </wsdl:operation>

</wsdl:portType>

 

/**
 * binding 元素描述特定服务接口的协议、数据格式、安全性和其它属性。
 * 针对operation和portType中使用的message指定实际的协议和数据格式规范。
 *
 * binding:用于定义SEI的实现类
 *  - type：引用上面的 portType
 *  - style：document 绑定的数据是一个document（XML）
 *  - operation：用来定义实现的方法
 *  - input: 指定客户端应传过来的数据
 *  - output：指定服务器端返回客户端的数据
 *  - literal：文本数据
 */

<wsdl:binding name="HelloServiceHttpBinding" type="tns:HelloServicePortType">

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

        <wsdl:operation name="sayHello">
            <wsdlsoap:operation soapAction="" />
            <wsdl:input name="sayHelloRequest">
                <wsdlsoap:body use="literal" />
            </wsdl:input>
            <wsdl:output name="sayHelloResponse">
                <wsdlsoap:body use="literal" />
            </wsdl:output>
        </wsdl:operation>

</wsdl:binding>

 

 

/**
 * service元素包含一组port元素。
 *
 * port将端点与来自服务接口定义的 binding 元素关联起来。
 * port指定一个绑定的地址，这样定义一个通信的终端。
 *
 * - service：一個webservice的容器
 * - name：它用以指定一個服務器端處理請求的入口（就是SEI的實現）
 * - binding：引用上面定义的 binding
 * - address:当前 webservice 的请求地址
 *
 */

<wsdl:service name="HelloService">

    <wsdl:port name="HelloServiceHttpPort" binding="tns:HelloServiceHttpBinding">
        <soap:address location="http://localhost:8080/xfire/services/HelloService" />
    </wsdl:port>

</wsdl:service>

 


</wsdl:definitions>

WSDL文档可以分为两部分。
顶部分由抽象定义组成，而底部分则由具体描述组成。
抽象部分以独立于平台和语言的方式定义SOAP消息，它们并不包含任何随机器或语言而变的元素。


1、抽象定义（接口）

types     - 独立与机器和语言的类型定义
messages  - 包括函数参数（输入与输出分开）或文档描述
portTypes - 引用消息部分中消息定义来描述函数签名（操作名、输入参数、输出参数）


2、具体定义（实现类）

bindings - PortTypes部分的每一操作在此绑定实现
services - 确定每一绑定的端口地址



问题：
如何发送 SOAP 消息？
SOAP 消息的结构/构成？














http://www.cnblogs.com/ChrisMurphy/p/5224314.html

http://staff.ustc.edu.cn/~shizhu/DotNet/WSDLxj.htm






-