新聞中心
自動生成WSDL

公司主營業(yè)務(wù):成都網(wǎng)站制作、成都做網(wǎng)站、外貿(mào)營銷網(wǎng)站建設(shè)、移動網(wǎng)站開發(fā)等業(yè)務(wù)。幫助企業(yè)客戶真正實現(xiàn)互聯(lián)網(wǎng)宣傳,提高企業(yè)的競爭能力。創(chuàng)新互聯(lián)公司是一支青春激揚、勤奮敬業(yè)、活力青春激揚、勤奮敬業(yè)、活力澎湃、和諧高效的團隊。公司秉承以“開放、自由、嚴謹、自律”為核心的企業(yè)文化,感謝他們對我們的高要求,感謝他們從不同領(lǐng)域給我們帶來的挑戰(zhàn),讓我們激情的團隊有機會用頭腦與智慧不斷的給客戶帶來驚喜。創(chuàng)新互聯(lián)公司推出愛民免費做網(wǎng)站回饋大家。
在您寫好并部署了 WebMethod 之后,客戶端需要明確知道為了與它成功通訊而必須使 SOAP 消息具有什么樣的外觀。提供 Web 服務(wù)說明的標準方法是通過 WSDL(以及嵌入的 XSD 定義)進行的。為了幫助適應(yīng)這種情況,.asmx 處理程序自動生成可讀的文檔頁,以及能準確反映 WebMethod 接口的 WSDL 定義。如果您對 WebMethod 應(yīng)用了許多映射屬性,則它們都會反映在生成的文檔中。
如果您瀏覽 .asmx 文件,將會看到一個如圖 2 所示的可供人工讀取的文檔頁。此文檔頁是由一個名為 DefaultWsdlHelpGenerator.aspx(位于 C:\windows\Microsoft.NET\Framework\ v1.0.3705\config)的 .aspx 頁生成的。如果您打開這個文件,將會發(fā)現(xiàn)這僅僅是一個標準的 ASP.NET 頁,該頁使用 .NET 反射生成文檔。此功能允許您的文檔總是與代碼保持同步。您只需修改此文件即可自定義所生成的文檔。
還可以通過在 Web.config 文件中指定一個不同的文檔文件來避免在虛擬目錄中生成文檔:
- < configuration>
- < system.web>
- < webServices>
- < wsdlHelpGenerator href="MyDocumentation.aspx"/>
- < /webServices>
- ...
如果客戶端對 .asmx 終結(jié)點發(fā)出 GET 請求,而且查詢字符串中有 “?wsdl”,那么,.asmx 處理程序會生成 WSDL 定義,而不生成可供人工讀取的文檔??蛻舳丝梢允褂?WSDL 定義來生成代理類,這些類可自動了解如何與 Web 服務(wù)通訊(例如,使用 .NET 中的 Wsdl.exe)。
自動生成WSDL:自定義過程
要自定義 WSDL 生成過程,可以編寫一個 SoapExtensionReflector 類,并在 Web.config 文件中向 WebMethod 框架注冊該類。然后,當 .asmx 處理程序生成 WSDL 定義時,它將調(diào)用反射器類,并使您有機會自定義向客戶端提供的最終定義。有關(guān)如何編寫 SoapExtensionReflector 類的更多信息,請查看 SoapExtensionReflectors in ASP.NET Web Services。
您還可以使用兩種不同的方法來完全跳過 WSDL 生成過程。***種方法是,在虛擬目錄中提供一個可供客戶端訪問的靜態(tài) WSDL 文檔,然后通過將文檔生成器從 Web.config 文件中刪除來禁用它,如下所示:
- < configuration>
- < system.web>
- < webServices>
- < protocols>
- < remove name="Documentation"/>
- < /protocols>
- ...
另一種自動化程度較之稍高的方法是,使用 [WebServicesBinding] 屬性來指定由 WebMethod 類實現(xiàn)的靜態(tài) WSDL 文檔在虛擬目錄中的位置。您還必須使用 [SoapDocumentMethod] 屬性為每個 WebMethod 實現(xiàn)的 WSDL 綁定指定名稱。這樣做之后,WSDL自動生成過程將導(dǎo)入靜態(tài) WSDL 文件,并在它周圍包裝一個新的服務(wù)說明。
目前,因為仍沒有太多可用的 WSDL 編輯器,所以手工編寫 WSDL 是極其困難的。因此,文檔/WSDL 的自動生成是 WebMethod 框架中很有價值的一部分,沒有它,許多開發(fā)人員的日子會很難過。
文章名稱:.asmx處理程序提供的功能之自動生成WSDL
網(wǎng)頁鏈接:http://m.fisionsoft.com.cn/article/dhgdhgc.html


咨詢
建站咨詢
