在大量使用 jQuery Ajax 的專案中,如果每個功能都要新增一個 ashx 或 aspx 來處理,很快會產生大量零散的處理頁面。為了改善這個問題,可以設計一個通用的 AjaxHandler,透過反射呼叫後端方法,讓前端請求更集中、後端結構更清楚。
這個做法的核心,是讓前端只負責傳送方法名稱與參數,後端則依約定俗成的規則,找到對應的類別與方法並執行。這樣就不需要為每個小功能建立一個獨立處理程式。
首先建立一個實作 IHttpHandler 與 IRequiresSessionState 的處理程式。前端請求時,會帶入方法名稱與 DLL 名稱。方法名稱格式可約定為命名空間、類別名稱、方法名稱,例如 namespace.class.method。後端收到請求後,先解析出類別命名空間,再透過反射建立物件。
接著,後端會收集請求中的參數。為了避免與其他參數混淆,可為 Ajax 參數加上特殊前綴,例如 __DOTNET__。前綴後面接著參數型別,後端再依型別將字串轉換為對應的值。若參數是類別,則可將 JSON 字串反序列化為物件。
找到方法後,後端會取得 MethodInfo,並檢查該方法是否標記了自訂屬性,例如 AJaxMethod。只有標記了這個屬性的方法,才允許被前端呼叫。這個設計可以避免任意方法被外部直接觸發,提高安全性。
執行方法後,會得到回傳值。若回傳值是類別,通常會被序列化成 JSON;若是 DataTable,也可轉成 JSON 格式;若是 XML 文件,則可直接輸出 XML。若前端有指定 callback 參數,也可輸出 JSONP 格式,方便跨網域情境。
前端使用 jQuery Ajax 時,網址可帶入 METHAD 與 DLL 兩個參數。METHAD 表示命名空間、類別與方法;DLL 表示要載入的組件名稱。data 中則放入帶有前綴的參數,例如 __DOTNET__System.String 或 __DOTNET__System.Int32。
在 web.config 中,需要將 DotNet2.ashx 之類的路徑對應到 AjaxHandler。這樣前端就能以固定網址呼叫後端方法。實務上仍應注意輸入驗證、權限控管與例外處理,避免因為反射機制而暴露不必要的方法。
整體而言,這種 AjaxHandler 的做法,適合中小型專案快速整合大量非同步請求。它的優點是集中管理、易於擴充;缺點是必須自行處理型別轉換與安全性邊界,因此更適合在團隊有明確規範的情況下使用。