當然,我們不會只把這種能力用來跳 alert。所有客戶端代理(例如 Sample.ServerSideAdd 函數)都接受額外參數,用來指定處理伺服器回應的回呼函數:
Sample.ServerSideAdd(100, 99, ServerSideAdd_CallBack);
function ServerSideAdd_CallBack(response) {
if (response.error != null) {
alert(response.error);
return;
}
alert(response.value);
}
回呼函數會收到一個 response 物件,它公開幾個主要屬性:
先檢查 error 是否為 null,就知道這次呼叫有沒有出錯;只要在伺服器端函數中丟出例外,error 屬性就會被填好。request 屬性則可取得更多細節。
Ajax 包裝器不只處理 ServerSideAdd 回傳的整數,還支援 integers、strings、double、booleans、DateTime、DataSet、DataTable,以及自訂類別與陣列;其他型別一律回傳其 ToString() 結果。
回傳的 DataSet 與真正的 .NET DataSet 幾乎一樣,在客戶端可以直接走訪其中的表格與資料列來渲染。
Ajax 也能回傳自訂類別,唯一要求是必須標上 Serializable 屬性:
[Serializable()]
public class User {
private int _userId;
private string _firstName;
private string _lastName;
public int userId {
get { return _userId; }
}
public string FirstName {
get { return _firstName; }
}
public string LastName {
get { return _lastName; }
}
public User(int _userId, string _firstName, string _lastName) {
this._userId = _userId;
this._firstName = _firstName;
this._lastName = _lastName;
}
public User() {}
[AjaxMethod()]
public static User GetUser(int userId) {
// 這裡可以換成實際的資料庫查詢
return new User(userId, "Michael", "Schwarz");
}
}
接著用 RegisterTypeForAJax 註冊 GetUser 的代理:
private void Page_Load(object sender, EventArgs e) {
Utility.RegisterTypeForAJax(typeof(User));
}
之後即可在客戶端非同步呼叫 GetUser,回應中的值是一個物件,公開與伺服器端相同的屬性(FirstName、LastName、userId)。
包裝器能處理大量 .NET 型別,但對不在此列且無法正確序列化的型別,它只會呼叫 ToString()。為了避免這種粗暴的降级,Ajax.NET 允許開發者建立物件轉換器,在伺服器與用戶端之間平滑傳遞複雜物件。
前面的範例把伺服器端函數放在頁面背後的程式碼裡,但沒有理由不能放到獨立類別檔。包裝器的運作方式是:在指定類中找出所有帶 AjaxMethod 特性的方法;需要哪些類,就透過第二個 script 標籤指定,並以 Ajax.Utility.RegisterTypeForAJax 註冊。把伺服器端函數獨立成一個類是相當合理的做法:
Public Class AjaxFunctions
<Ajax.AjaxMethod()> _
Public Function Validate(username As String, passWord As String) As Boolean
' 執行驗證邏輯
' 回傳結果
End Function
End Class
註冊時傳入類的型別而非頁面即可:
private void Page_Load(object sender, EventArgs e) {
Ajax.Utility.RegisterTypeForAjax(typeof(AjaxFunctions));
// ...
}
請注意,客戶端代理的名稱是「類名.伺服器端函數名」。因此若把 ServerSideAdd 放進 AjaxFunctions 類,客戶端呼叫就該寫成 AjaxFunctions.ServerSideAdd(1, 2)。
Ajax 工具產生的第二個 script 標籤(也可以手寫)會帶上頁面的命名空間、類名與組件名稱。根據這些資訊,Ajax.PageHandlerFactory 就能用反射取得帶有特定特性的函數細節:找出所有標了 AjaxMethod 的方法,讀取它們的簽章(回傳型別、名稱、參數),據此產生必要的客戶端代理。
具體來說,包裝器會建立一個與類同名的 JavaScript 物件,由它提供代理。也就是說,給定一個含 AjaxMethod 的 ServerSideAdd 的伺服器端類 AjaxFunctions,你就會得到一個公開 ServerSideAdd 函數的 AjaxFunctions JavaScript 物件。把瀏覽器指向第二個 script 標籤的路徑,就能直接看到這個動作的成果。