早在 RTM 版本發布之前,我差不多就把 Web Service Proxy 的分析寫完了,可惜一場「驚天地、泣鬼神」的 RTM 一出,這篇文章的誕生晚了二十多天。
使用 Web Service Proxy 應該是 ASP.NET Ajax 存取 Web Service 最常用的方法了。伺服器端會依 ScriptManager 中加入的 Service 參照去分析 Web Service 類別,並產生對應的客戶端腳本,讓開發者能在客戶端方便且直觀地呼叫 Web Services 方法。這是 ASP.NET 中一項相當重要的功能。
從官方文件看來,CTP 與 RTM 在腳本使用上似乎沒有太大變化,只要在伺服器端調整一些 CustomAttribute 即可。使用方式上的確只有這點細微差異,但就「產生腳本」本身而言,CTP 與 RTM 的做法卻大相逕庭,主要差別有兩點:
其一:對於產生伺服器端類型的腳本(例如可用 new Jeffz.WebServiceProxyDemo.Employee() 建構物件),CTP 可以自訂,RTM 則不行。
其二:對於 WebService 方法的代理,CTP 產生的程式碼很少,RTM 產生的則多得多,但更貼近客戶端「類別」的標準。也就是說,RTM 完全把一個伺服器端類別「映射」到客戶端——當然只限於需要產生代理的方法,也不含其實作。此外,RTM 還新增了以回應 status code 304 實作的快取功能。
我在標題中的「可歎」,多半指第一點。RTM 取消了客戶端 Serialize 方法對自訂序列化的支援,伺服器端相應的自訂類別腳本功能也隨之消失。原本能透過自訂方式「完美」處理伺服器端與客戶端間複雜物件的「循環參照」問題,如今已行不通。這一點究竟算進步還是退步實在難說——雖仍能以 JavaScriptConverter 擴充,但從「美學」角度看,現今做法只能算是 workaround。因此本文僅就客戶端的 Proxy 腳本進行分析與比較。
至於第二點,個人認為是為了配合目前的 Web Service 存取方式而調整,它遵循了以下規範與特點:使用 ASP.NET Ajax 的「類別」規範把伺服器端 Web Service 類別映射到客戶端;提供客戶端呼叫 Web Service 方法所需的 proxy;並支援 defaultUserContext、defaultSucceededCallback 與 defaultFailedCallback。
為了更清楚理解 CTP 與 RTM 的差異,以及 RTM 建構 Proxy 的形式,我們先定義一個相同的複雜型別 Employee:
namespace Jeffz.WebServicesProxyDemo
{
public class Employee
{
public string Name;
public int Age;
}
}