在 WebForm 生態裡,若想讓頁面具備局部更新能力,早期常會借助 AjaxPro 這類元件。它雖然歷史悠久,但把「後端方法暴露成前端可呼叫」的過程封裝得相當完整,仍值得作為理解 Ajax 元件設計的素材。
AjaxPro 的價值不只是簡化呼叫,而是示範了如何透過 IHttpHandlerFactory、IHttpHandler、反射與前端腳本生成,把伺服器端方法包裝成 JavaScript 可使用的介面。
在 web.config 的 httpHandlers 中,加入一條規則,讓符合 ajaxpro 路徑且以 ashx 結尾的 GET 或 POST 請求,都交由 AjaxPro.AjaxHandlerFactory 處理。這個工廠類別負責產生對應的 IHttpHandler,是整個機制的入口。
接著於 Page_Load 中呼叫 AjaxPro.Utility.RegisterTypeForAjax,把目前頁面型別傳入。此方法會把必要的前端腳本註冊到頁面,因此 aspx 頁面中通常需要存在伺服器端 form 元素,否則腳本可能無法正確輸出。
需要被前端呼叫的後端方法,會加上 AjaxMethod 屬性。透過這個標記,AjaxPro 能判斷是否啟用快取、是否需要 Session、是否採非同步處理等行為。方法的回傳值可以是簡單型別,也可以是集合或複雜物件,前端會收到序列化後的結果。
AjaxPro 會依頁面類別的命名空間與類別名稱,在前端建立對應的 JavaScript 物件。開發者可以用「命名空間.頁面類別.方法名稱」的形式發起請求,並以回呼函式接收結果。回呼物件通常包含 value 與 error 等資訊,方便判斷成功或失敗。
頁面載入時,會看到數個以 ashx 結尾的腳本請求。這些資源有些內嵌在組件中,有些則動態產生,主要封裝 Ajax 請求所需的通用函式,以及頁面方法的呼叫代理。使用 ashx 而非直接提供 js 檔,是因為 ashx 可以被自訂處理程序攔截並輸出內容。
為了避免每次載入都重新下載,AjaxPro 會比對 If-None-Match 與 If-Modified-Since 等請求標頭,若內容未變,就回傳 304,讓瀏覽器使用快取。
ASP.NET 的 HttpModule 與 IHttpHandler 是擴充請求管線的關鍵。AjaxPro 透過 AjaxHandlerFactory 攔截符合規則的請求,再依請求方法與 AjaxMethod 的設定,決定要建立哪一種 Handler。
這些 Handler 會依是否使用非同步、是否需要 Session、是否只讀 Session,分成不同實作。GET 請求通常用來取得 JavaScript 資源,POST 請求則進入實際方法呼叫流程。
當 Handler 取得請求後,會從 URL 中解析出頁面類別的完全限定名,並從自訂標頭取得方法名稱。接著透過反射建立頁面物件或呼叫靜態方法,完成參數對應與方法執行。最後,執行結果會被序列化,若設定快取,也會寫入伺服器快取以便後續使用。
AjaxPro 的優點在於設定簡單、封裝完整,能讓前端不必自行打造 Ajax 請求函式,也能處理簡單或複雜回傳值。然而,它也有明顯限制,例如頁面會額外產生多個腳本請求、難以使用一般 GET 快取、與伺服器端 form 綁定,以及反射帶來的效能成本。
若從現代化角度回看,AjaxPro 的設計已不適合直接套用到新專案,但它對請求攔截、方法映射、序列化與前端代理生成的處理,仍是理解 Ajax 元件運作不可多得的參考教材。