• <ins id="pjuwb"></ins>
    <blockquote id="pjuwb"><pre id="pjuwb"></pre></blockquote>
    <noscript id="pjuwb"></noscript>
          <sup id="pjuwb"><pre id="pjuwb"></pre></sup>
            <dd id="pjuwb"></dd>
            <abbr id="pjuwb"></abbr>
            隨筆 - 60  文章 - 5  trackbacks - 0
            <2009年6月>
            31123456
            78910111213
            14151617181920
            21222324252627
            2829301234
            567891011

            常用鏈接

            留言簿(2)

            隨筆分類(42)

            隨筆檔案(60)

            文章檔案(2)

            我收藏的博客

            搜索

            •  

            最新評論

            閱讀排行榜

            評論排行榜

            WSDL (Web Services Description Language,Web服務(wù)描述語言)是一種XML Application,他將Web服務(wù)描述定義為一組服務(wù)訪問點,客戶端可以通過這些服務(wù)訪問點對包含面向文檔信息或面向過程調(diào)用的服務(wù)進行訪問(類似遠程過程調(diào)用)。WSDL首先對訪問的操作和訪問時使用的請求/響應(yīng)消息進行抽象描述,然后將其綁定到具體的傳輸協(xié)議和消息格式上以最終定義具體部署的服務(wù)訪問點。相關(guān)的具體部署的服務(wù)訪問點通過組合就成為抽象的Web服務(wù)。 本文將詳細講解WSDL文檔的結(jié)構(gòu),并分析每個元素的作用。
            一:WSDL定義

                WSDL是一個用于精確描述Web服務(wù)的文檔,WSDL文檔是一個遵循WSDL XML模式的XML文檔。WSDL 文檔將Web服務(wù)定義為服務(wù)訪問點或端口的集合。在 WSDL 中,由于服務(wù)訪問點和消息的抽象定義已從具體的服務(wù)部署或數(shù)據(jù)格式綁定中分離出來,因此可以對抽象定義進行再次使用:消息,指對交換數(shù)據(jù)的抽象描述;而端口類型,指操作的抽象集合。用于特定端口類型的具體協(xié)議和數(shù)據(jù)格式規(guī)范構(gòu)成了可以再次使用的綁定。將Web訪問地址與可再次使用的綁定相關(guān)聯(lián),可以定義一個端口,而端口的集合則定義為服務(wù)。

               一個WSDL文檔通常包含7個重要的元素,即types、import、message、portType、operation、binding、 service元素。這些元素嵌套在definitions元素中,definitions是WSDL文檔的根元素。文章的下一部分將會詳細介紹WSDL 的基本結(jié)構(gòu)。

            二:WSDL的基本結(jié)構(gòu)--概述

            如第一部分最后描述的那樣,一個基本的WSDL文檔包含7個重要的元素。下面將分別介紹這幾個元素以及他們的作用。

            WSDL 文檔在Web服務(wù)的定義中使用下列元素:

            Types - 數(shù)據(jù)類型定義的容器,它使用某種類型系統(tǒng)(一般地使用XML Schema中的類型系統(tǒng))。
            Message - 通信消息的數(shù)據(jù)結(jié)構(gòu)的抽象類型化定義。使用Types所定義的類型來定義整個消息的數(shù)據(jù)結(jié)構(gòu)。
            Operation - 對服務(wù)中所支持的操作的抽象描述,一般單個Operation描述了一個訪問入口的請求/響應(yīng)消息對。
            PortType - 對于某個訪問入口點類型所支持的操作的抽象集合,這些操作可以由一個或多個服務(wù)訪問點來支持。
            Binding - 特定端口類型的具體協(xié)議和數(shù)據(jù)格式規(guī)范的綁定。
            Port - 定義為協(xié)議/數(shù)據(jù)格式綁定與具體Web訪問地址組合的單個服務(wù)訪問點。
            Service- 相關(guān)服務(wù)訪問點的集合。
              可以參考下圖來理解一下WSDL的文檔結(jié)構(gòu)圖:

            WSDL的xml schema可以參照如下網(wǎng)址:http://schemas.xmlsoap.org/wsdl/

            三:WSDL的基本結(jié)構(gòu)--詳述

            本節(jié)將通過一個例子詳細描述WSDL文檔每個元素的作用。下面一個例子是一個簡單的WSDL文檔的內(nèi)容,該文檔的產(chǎn)生可以參見我的另外一篇文章:xfire開發(fā)實例--HelloWorld篇 。

            一個簡單的Web Service的WSDL文檔,該服務(wù)支持名為sayHello的唯一操作,該操作通過在http上運行SOAP協(xié)議來實現(xiàn)的。該請求接受一個字符串name,經(jīng)過處理后返回一個簡單的字符串。文檔如下:

            <?xml version="1.0" encoding="UTF-8" ?>
            <wsdl:definitions
                targetNamespace="    xmlns:tns="    xmlns:wsdlsoap="    xmlns:soap12="    xmlns:xsd="    xmlns:soapenc11="    xmlns:soapenc12="    xmlns:soap11="    xmlns:wsdl="    <wsdl:types>
                    <xsd:schema xmlns:xsd="
                        attributeFormDefault="qualified" elementFormDefault="qualified"
                        targetNamespace="
                        <xsd:element name="sayHello">
                            <xsd:complexType>
                                <xsd:sequence>
                                    <xsd:element maxOccurs="1" minOccurs="1"
                                        name="name" 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>
                <wsdl:message name="sayHelloResponse">
                    <wsdl:part name="parameters" element="tns:sayHelloResponse" />
                </wsdl:message>
                <wsdl:message name="sayHelloRequest">
                    <wsdl:part name="parameters" element="tns:sayHello" />
                </wsdl: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>
                <wsdl:binding name="HelloServiceHttpBinding"
                    type="tns:HelloServicePortType">
                    <wsdlsoap:binding style="document"
                        transport="
                    <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>
                <wsdl:service name="HelloService">
                    <wsdl:port name="HelloServiceHttpPort"
                        binding="tns:HelloServiceHttpBinding">
                        <wsdlsoap:address
                            location="
            http://localhost:8080/xfire/services/HelloService" />
                    </wsdl:port>
                </wsdl:service>
            </wsdl:definitions>
            ♦ types元素使用XML模式語言聲明在WSDL文檔中的其他位置使用的復(fù)雜數(shù)據(jù)類型與元素;

            ♦ import元素類似于XML模式文檔中的import元素,用于從其他WSDL文檔中導(dǎo)入WSDL定義;

            ♦ message元素使用在WSDL文檔的type元素中定義或在import元素引用的外部WSDL文檔中定義的XML模式的內(nèi)置類型、復(fù)雜類型或元素描述了消息的有效負載;

            ♦ portType元素和operation元素描述了Web服務(wù)的接口并定義了他的方法。portType元素和operation元素類似于 java接口和接口中定義的方法聲明。operation元素使用一個或者多個message類型來定義他的輸入和輸出的有效負載;

            ♦ Binding元素將portType元素和operation元素賦給一個特殊的協(xié)議和編碼樣式;

            ♦ service元素負責將Internet地址賦給一個具體的綁定;

            1、definitions元素

            所有的WSDL文檔的根元素均是definitions元素。該元素封裝了整個文檔,同時通過其name提供了一個WSDL文檔。除了提供一個命名空間外,該元素沒有其他作用,故不作詳細描述。

            下面的代碼是一個definitions元素的結(jié)構(gòu):

            <wsdl:definitions
                targetNamespace="    xmlns:tns="    xmlns:wsdlsoap="    xmlns:soap12="    xmlns:xsd="    xmlns:soapenc11="    xmlns:soapenc12="    xmlns:soap11="    xmlns:wsdl="</wsdl:definitions>
            2、types元素

             WSDL采用了W3C XML模式內(nèi)置類型作為其基本類型系統(tǒng)。types元素用作一個容器,用于定義XML模式內(nèi)置類型中沒有描述的各種數(shù)據(jù)類型。當聲明消息部分的有效負載時,消息定義使用了在types元素中定義的數(shù)據(jù)類型和元素。在本文的WSDL文檔中的types定義:

             

            <wsdl:types>
                    <xsd:schema xmlns:xsd="
                        attributeFormDefault="qualified" elementFormDefault="qualified"
                        targetNamespace="
                        <xsd:element name="sayHello">
                            <xsd:complexType>
                                <xsd:sequence>
                                    <xsd:element maxOccurs="1" minOccurs="1"
                                        name="name" 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>
            上面是數(shù)據(jù)定義部分,該部分定義了兩個元素,一個是sayHello,一個是sayHelloResponse:

            sayHello:定義了一個復(fù)雜類型,僅僅包含一個簡單的字符串,將來用來描述操作的參入傳入部分;

            sayHelloResponse:定義了一個復(fù)雜類型,僅僅包含一個簡單的字符串,將來用來描述操作的返回值;

            3、import元素

            import元素使得可以在當前的WSDL文檔中使用其他WSDL文檔中指定的命名空間中的定義元素。本例子中沒有使用import元素。通常在用戶希望模塊化WSDL文檔的時候,該功能是非常有效果的。

            import的格式如下:

            <wsdl:import namespace="        <wsdl:part name="parameters" element="tns:sayHelloResponse" />
                </wsdl:message>
                <wsdl:message name="sayHelloRequest">
                    <wsdl:part name="parameters" element="tns:sayHello" />
                </wsdl:message>
            該部分是消息格式的抽象定義:定義了兩個消息sayHelloResponse和sayHelloRequest:

            sayHelloRequest:sayHello操作的請求消息格式,由一個消息片斷組成,名字為parameters,元素是我們前面定義的types中的元素;

            sayHelloResponse:sayHello操作的響應(yīng)消息格式,由一個消息片斷組成,名字為parameters,元素是我們前面定義的types中的元素;

             如果采用RPC樣式的消息傳遞,只需要將文檔中的element元素應(yīng)以修改為type即可。

            5、portType元素

            portType元素定義了Web服務(wù)的抽象接口。該接口有點類似Java的接口,都是定義了一個抽象類型和方法,沒有定義實現(xiàn)。在WSDL中, portType元素是由binding和service元素來實現(xiàn)的,這兩個元素用來說明Web服務(wù)實現(xiàn)使用的Internet協(xié)議、編碼方案以及 Internet地址。

            一個portType中可以定義多個operation,一個operation可以看作是一個方法,本文中WSDL文檔的定義:

                <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>
            portType定義了服務(wù)的調(diào)用模式的類型,這里包含一個操作sayHello方法,同時包含input和output表明該操作是一個請求/響應(yīng)模式,請求消息是前面定義的sayHelloRequest,響應(yīng)消息是前面定義的sayHelloResponse。input表示傳遞到Web服務(wù)的有效負載,output消息表示傳遞給客戶的有效負載。

            6、binding

            binding元素將一個抽象portType映射到一組具體協(xié)議(SOAO和HTTP)、消息傳遞樣式、編碼樣式。通常binding元素與協(xié)議專有的元素和在一起使用,本文中的例子:

                <wsdl:binding name="HelloServiceHttpBinding"
                    type="tns:HelloServicePortType">
                    <wsdlsoap:binding style="document"
                        transport="
                    <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>
            這部分將服務(wù)訪問點的抽象定義與SOAP HTTP綁定,描述如何通過SOAP/HTTP來訪問按照前面描述的訪問入口點類型部署的訪問入口。其中規(guī)定了在具體SOAP調(diào)用時,應(yīng)當使用的soapAction是""。

            具體的使用需要參考特定協(xié)議定義的元素。

            7、service元素和port元素

            service元素包含一個或者多個port元素,其中每個port元素表示一個不同的Web服務(wù)。port元素將URL賦給一個特定的binding,甚至可以使兩個或者多個port元素將不同的URL賦值給相同的binding。文檔中的例子:

                <wsdl:service name="HelloService">
                    <wsdl:port name="HelloServiceHttpPort"
                        binding="tns:HelloServiceHttpBinding">
                        <wsdlsoap:address
                            location="
            http://localhost:8080/xfire/services/HelloService" />
                    </wsdl:port>
                </wsdl:service>
            這部分是具體的Web服務(wù)的定義,在這個名為HelloService的Web服務(wù)中,提供了一個服務(wù)訪問入口,訪問地址是http://localhost:8080/xfire/services/HelloService,使用的消息模式是由前面的binding所定義的。

              本文簡單介紹了WSDL規(guī)范的用途,基本結(jié)構(gòu)和使用方法,希望對大家學(xué)習(xí)WSDL有幫助。


            本文來自CSDN博客,轉(zhuǎn)載請標明出處:http://blog.csdn.net/sunchaohuang/archive/2008/10/14/3076375.aspx

            posted on 2009-11-05 12:24 黃劍父 閱讀(388) 評論(0)  編輯 收藏 引用 所屬分類: C/C++
            亚洲伊人久久大香线蕉苏妲己| 国产精品综合久久第一页| 精品国产91久久久久久久| 国产精品久久久天天影视| 国产亚州精品女人久久久久久| 日本加勒比久久精品| 青青草原精品99久久精品66| 久久国产精品99精品国产987| 久久精品国产一区二区| 蜜臀久久99精品久久久久久小说| 久久久久久毛片免费播放| 亚洲精品成人网久久久久久| 潮喷大喷水系列无码久久精品| 污污内射久久一区二区欧美日韩| 久久不见久久见免费视频7| 久久亚洲中文字幕精品一区四| 国内精品伊人久久久久av一坑 | 久久亚洲国产精品成人AV秋霞| 久久久av波多野一区二区| 一本久久免费视频| 欧美综合天天夜夜久久| 久久棈精品久久久久久噜噜| 99久久香蕉国产线看观香| 久久久久人妻精品一区三寸蜜桃| 97久久天天综合色天天综合色hd| 国内高清久久久久久| 亚洲国产成人久久笫一页 | 亚洲欧美日韩精品久久亚洲区| 91精品观看91久久久久久| 精品久久久久久无码专区不卡| 一本一本久久a久久精品综合麻豆| 婷婷综合久久狠狠色99h| 激情伊人五月天久久综合| 午夜久久久久久禁播电影| 狠狠色噜噜色狠狠狠综合久久| 中文国产成人精品久久亚洲精品AⅤ无码精品 | 99久久精品免费| 久久精品夜色噜噜亚洲A∨| 国产香蕉97碰碰久久人人| 久久久久成人精品无码| 国产精品无码久久四虎|