.asmx處理程序提供的功能之自動生成WSDL
自動生成WSDL
在您寫好并部署了 WebMethod 之后，客戶端需要明確知道為了與它成功通訊而必須使 SOAP 消息具有什么樣的外觀。提供 Web 服務說明的標準方法是通過 WSDL（以及嵌入的 XSD 定義）進行的。為了幫助適應這種情況，.asmx 處理程序自動生成可讀的文檔頁，以及能準確反映 WebMethod 接口的 WSDL 定義。如果您對 WebMethod 應用了許多映射屬性，則它們都會反映在生成的文檔中。
如果您瀏覽 .asmx 文件，將會看到一個如圖 2 所示的可供人工讀取的文檔頁。此文檔頁是由一個名為 DefaultWsdlHelpGenerator.aspx（位于 C:\windows\Microsoft.NET\Framework\ v1.0.3705\config）的 .aspx 頁生成的。如果您打開這個文件，將會發現這僅僅是一個標準的 ASP.NET 頁，該頁使用 .NET 反射生成文檔。此功能允許您的文檔總是與代碼保持同步。您只需修改此文件即可自定義所生成的文檔。
還可以通過在 Web.config 文件中指定一個不同的文檔文件來避免在虛擬目錄中生成文檔：
- < configuration>
- < system.web>
- < webServices>
- < wsdlHelpGenerator href="MyDocumentation.aspx"/>
- < /webServices>
- ...
如果客戶端對 .asmx 終結點發出 GET 請求，而且查詢字符串中有 “?wsdl”，那么，.asmx 處理程序會生成 WSDL 定義，而不生成可供人工讀取的文檔?？蛻舳丝梢允褂?WSDL 定義來生成代理類，這些類可自動了解如何與 Web 服務通訊（例如，使用 .NET 中的 Wsdl.exe）。
自動生成WSDL：自定義過程
要自定義 WSDL 生成過程，可以編寫一個 SoapExtensionReflector 類，并在 Web.config 文件中向 WebMethod 框架注冊該類。然后，當 .asmx 處理程序生成 WSDL 定義時，它將調用反射器類，并使您有機會自定義向客戶端提供的最終定義。有關如何編寫 SoapExtensionReflector 類的更多信息，請查看 SoapExtensionReflectors in ASP.NET Web Services。
您還可以使用兩種不同的方法來完全跳過 WSDL 生成過程。***種方法是，在虛擬目錄中提供一個可供客戶端訪問的靜態 WSDL 文檔，然后通過將文檔生成器從 Web.config 文件中刪除來禁用它，如下所示：
- < configuration>
- < system.web>
- < webServices>
- < protocols>
- < remove name="Documentation"/>
- < /protocols>
- ...
另一種自動化程度較之稍高的方法是，使用 [WebServicesBinding] 屬性來指定由 WebMethod 類實現的靜態 WSDL 文檔在虛擬目錄中的位置。您還必須使用 [SoapDocumentMethod] 屬性為每個 WebMethod 實現的 WSDL 綁定指定名稱。這樣做之后，WSDL自動生成過程將導入靜態 WSDL 文件，并在它周圍包裝一個新的服務說明。
目前，因為仍沒有太多可用的 WSDL 編輯器，所以手工編寫 WSDL 是極其困難的。因此，文檔/WSDL 的自動生成是 WebMethod 框架中很有價值的一部分，沒有它，許多開發人員的日子會很難過。
【編輯推薦】
