Ajax.NET 包裝器能從伺服器向用戶端回傳 Unicode 字元,但資料在送出之前必須先在伺服器端做 HTML 編碼:
[Ajax.AjaxMethod()]
public string Test1(string name, string email, string comment) {
string html = "";
html += "Hello " + name + "<br>";
html += "Thank you for your comment <b>";
html += System.Web.HttpUtility.HtmlEncode(comment);
html += "</b>.";
return html;
}
這個 HtmlEncode 不是裝飾:使用者輸入的 comment 若不編碼就拼進 HTML 回傳,等於在頁面上製造一個反射型 XSS。伺服器端組字串時務必對每一段外部輸入編碼。
伺服器端函數很可能需要存取工作階段資訊。做法是透過傳給 Ajax.AjaxMethod 特性的一個參數,告訴 Ajax 要啟用這項功能。
用一個文件管理系統來說明:使用者編輯文件時會對它加鎖,其他人可以請求「文件可用時通知我」。若沒有 Ajax,我們只能等使用者再回來一次,手動檢查他關注的文件是否已釋放——體驗顯然不理想。有了支援工作階段狀態的 Ajax,這件事就簡單了。
先寫伺服器端函數:走訪使用者關注的 documentId(存在工作階段中),回傳所有已釋放的文件。
[Ajax.AjaxMethod(HttpSessionStateRequirement.Read)]
public ArrayList DocumentReleased() {
if (HttpContext.Current.Session["DocumentsWaiting"] == null) {
return null;
}
ArrayList readyDocuments = new ArrayList();
int[] documents = (int[])HttpContext.Current.Session["DocumentsWaiting"];
for (int i = 0; i < documents.Length; ++i) {
Document document = Document.GetDocumentById(documents[i]);
if (document != null && document.Status == DocumentStatus.Ready) {
readyDocuments.Add(document);
}
}
return readyDocuments;
}
注意我們指定了 HttpSessionStateRequirement.Read(另有 Write 與 ReadWrite 可選)。宣告成 Read 而不隨手用 ReadWrite,是因為讀取工作階段的請求會觸發工作階段載入,不必要的寫入則會讓每一個非同步請求都去搶工作階段鎖——在並發呼叫的場景下,這是效能與死鎖風險的來源。
接著在客戶端呼叫這個方法:伺服器端函數在頁面載入時呼叫一次,之後每十秒呼叫一次。回呼函數檢查回應是否有值,有的話就把使用者可用的新文件顯示在 div 中。因為整個輪詢是非同步的,使用者可以繼續手邊的工作,不必被反覆的頁面刷新打斷。
Ajax 技術催生了過去只有桌面開發才具備的健壯而豐富的 Web 介面,而 Ajax.NET 包裝器讓你能相當省力地用上這項能力:伺服器端只要照平常的方式寫方法、掛上 AjaxMethod 特性,客戶端立刻得到一支對應的代理函數。
不過要留意兩點。第一,這個包裝器與其文件仍在演進中,API 可能變動。第二,也是更根本的:非同步呼叫不會自動帶來安全性。工作階段、型別轉換、HTML 編碼、例外處理,這些事情在 Ajax 場景下不會消失,只是換了位置——伺服器端的最終驗證永遠不能省。