1. 程式人生 > >webservice wsdl檔案標籤講解

webservice 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">
	<!--
	 * type元素,定義了交換資訊的資料格式。
	 * 為了實現最大的互操作性(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元素指定XML資料型別組成訊息的各個部分。message元素用於定義操作的輸入和輸出引數。
	* 該部分是資訊格式的抽象定義:定義了兩個訊息sayHelloResponse和sayHelloRequest:
	* sayHelloRequest:sayHello操作的請求訊息格式,由一個訊息片斷組成,名字為parameters,
	* 元素是我們前面定義的types中的元素;
	* sayHelloResponse:sayHello操作的響應訊息格式,由一個訊息片斷組成,名字為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訊息。
	* 一些抽象操作的集合。每個操作關聯一個輸入訊息和一個輸出訊息。
	* portType定義了服務的呼叫模式的型別,這裡包含一個操作sayHello方法,同時包含input和output表明
	* 該操作是一個請求/響應模式,請求訊息是前面定義的sayHelloRequest,
	* 響應訊息是前面定義的sayHelloResponse。input表示傳遞到Web服務的有效負載,
	* output: 訊息表示傳遞給客戶的有效負載。
	* 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元素描述特定服務介面的協議、資料格式、安全性和其它屬性。
	* 針對操作和portType中使用的訊息指定實際的協議和資料格式規範。
	* binding: 用於定義SEI的實現類
	* type屬性:引用上面的<portType>
	* <soap:operation style="document" />繫結的資料是一個document(xml)
	* operation:用來定義實現的方法
	* <soap:operation style="document" />傳輸的是document(xml)
	* input:指定客戶端應用傳過來的資料
	* <soap:body use="literal" />:文字資料
	* output:指定伺服器端返回客戶端的資料
	* <soap:body use="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元素。埠將端點與來自服務介面定義的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>