圖 10 現代自行車的發展
圖 10 現代自行車的發展


Ajax 依靠伺服器作為中介來分發與處理請求。為完成這件事,.NET 封裝類依賴客戶端的請求物件,而 XMLHttpRequest 被大部分瀏覽器支援,因此是個不錯的選擇。既然封裝的目的就是隱藏 XMLHttpRequest 的實作細節,這裡不討論它的內部機制。
封裝類的運作方式是:在 .NET 的方法上加上 Ajax 屬性標記;一旦被標記,Ajax 就會建立對應的客戶端 JavaScript 函數(形式類似你手寫的函數),並用 XMLHttpRequest 建立伺服器代理,把客戶端的函數映射到伺服器端的處理函數。
聽起來複雜?其實不然。看一個簡單例子,以下是一個 .NET 的加法函數:
' VB.Net
Public Function Add(ByVal firstNumber As Integer, _
ByVal secondNumber As Integer) As Integer
Return firstNumber + secondNumber
End Function
// C#
public int Add(int firstNumber, int secondNumber)
{
return firstNumber + secondNumber;
}
Ajax.NET 會自動建立一個有兩個參數、名為 Add 的 JavaScript 函數。當客戶端呼叫這個函數時,請求會從後台送到伺服器端,再把計算結果回傳給客戶端。
先從把 .dll 掛進專案開始(熟悉這一步的讀者可以跳過)。如果你還沒有 Ajax.dll,先下載最新版本,解壓後放到專案能引用的位置,在 .NET 專案中加上參考,就可以開始用這個封裝開發了。
要讓它運作,第一步是在 web.config 中註冊封裝包的 HttpHandler。我們不深入解釋 HttpHandler 的原理,只需知道它們用來處理 ASP.NET 的請求。舉例來說,所有指向 *.aspx 的請求會由 System.Web.UI.PageHandlerFactory 處理;同理,我們把任何指向 Ajax/*.ashx 的請求交給 Ajax.PageHandlerFactory:
<configuration>
<system.web>
<httpHandlers>
<add verb="POST,GET" path="ajax/*.ashx" type="Ajax.PageHandlerFactory, Ajax" />
</httpHandlers>
...
</system.web>
</configuration>
這段設定告訴 ASP.NET:凡是符合 Ajax/*.ashx 路徑的請求,都改由 Ajax.PageHandlerFactory 產生的 HttpHandler 處理,而不是預設的 handler factory。你不需要真的建立 Ajax 這個子目錄——它只是一個虛擬路徑,其他 HttpHandler 也可以用自己的路徑去使用 .ashx 副檔名。
把 verb 限制成 "POST,GET" 而非 "*" 是個好習慣:這些代理端點只該接受這兩種方法,其餘(例如 PUT、DELETE)應當直接落空。
現在可以開始寫程式了。開啟一個新頁面或既有頁面,在 codebehind 的 Page_Load 中加入:
' VB.Net
Public Class Index
Inherits System.Web.UI.Page
Private Sub Page_Load(sender As Object, e As EventArgs) Handles MyBase.Load
Ajax.Utility.RegisterTypeForAJax(GetType(Index))
' ...
End Sub
' ...
End Class
這一行會讓頁面輸出兩個 script 標籤:一個載入 Ajax 的公共程式,另一個則指向「命名空間.類別,組件.ashx」,也就是這個頁面被開放給客戶端呼叫的方法清單。之後只要在特定方法上標記 AjaxMethod,它就會出現在客戶端代理裡。
值得留意的是,一旦某個方法被開放給客戶端呼叫,它就等於一個公開端點。頁面原本受表單驗證與 postback 流程保護的那些方法,在這裡並不適用——身分驗證、授權與輸入驗證都要在方法內部自己再做一次。