做過企業系統的人大概都遇過這個需求:使用者不肯乖乖填固定格式的查詢表單,他要自己選欄位、自己挑運算子、還要能把好幾個條件用「並且/或者」串起來。傳統做法要嘛寫死一堆查詢欄位,要嘛做一個複雜的進階查詢頁。本文示範的是另一條路:把欄位定義抽到 XML,用 Ajax 在瀏覽器端動態長出整個查詢介面。
運行效果如下:
伺服器端只負責回答問題,不負責畫介面。整個類別對外只暴露三個方法,每個都掛上 [AjaxPro.AjaxMethod],讓 AjaxPro 自動產生可從 JavaScript 呼叫的代理:
GetFields(table):回傳該表的欄位清單。GetOpts(table, field):回傳該欄位適用的運算子。GetEnums(table, field):回傳型別與可能的列舉值。運算子表以三組字串陣列維護,格式統一為「顯示文字|實際運算子」:
private string[] CHAR_OP = new string[]{"等於|=", "不等於|<>", "相似於|Like", "不相似於|Not Like"};
private string[] NUM_OP = new string[]{"大於|>", "大於或等於|>=", "等於|=", "不等於|<>", "小於|<", "小於或等於|<="};
private string[] DATE_OP = new string[]{"等於|=", "不等於|<>", "先於|<", "後於|>"};
GetOpts 的判斷邏輯颇见巧思:先查欄位型別,字元欄位給字串運算子;數值欄位再看有沒有列舉定義——如果這個整數欄位其實是「狀態碼」之類的列舉,就只給「是/不是」,因為對狀態比大小沒有意義;日期欄位給日期運算子;其他一律退回「等於」。
[AjaxPro.AjaxMethod]
public string[] GetOpts(string table, string field) {
string type = GetTypeofField(table, field);
switch (type) {
case "char": return CHAR_OP;
case "int": return GetEnumField(table, field) == null
? NUM_OP : new string[]{"是|=", "不是|<>"};
case "decimal": return NUM_OP;
case "datetime": return DATE_OP;
default: return new string[]{"等於|="};
}
}
GetEnums 的回傳值有個小約定:第 0 個元素放型別,之後才是列舉項目。客戶端因此可以用 enums.length <= 1 一句話判斷「這個欄位該用文字框還是下拉選單」。
LoadXml:以 HttpContext.Current.Request.PhysicalApplicationPath 拼出 XML 絕對路徑後載入,失敗時丟出清楚的錯誤訊息。GetTypeofField:用 XPath descendant::Field[@Value='...'] 取出 DataType 屬性。GetEnumField:讀取欄位下的 <Enum> 節點,取出 SqlSyntax、TextField、ValueField 三個屬性,再查資料庫填成「文字|值」陣列。這裡要特別提醒一個原始碼裡的壞示範:範例把資料庫連線字串(含 sa 帳號與密碼)直接寫死在 C# 檔案中。任何正式專案都不該這樣做,請改用 web.config 的 <connectionStrings> 區段並加密,連線字串一旦進了版本控制就等於外洩。
整個查詢器之所以「通用」,關鍵就在這份 XML。要支援新表,只要加一段 <Table> 節點,不必重新編譯。
<?xml version="1.0" encoding="utf-8" ?>
<Fields>
<Table Name="員工表" value="employee">
<Field Name="雇傭號" Value="emp_id" DataType="char">
</Field>
<Field Name="名字" Value="fname" DataType="char">
<Enum SqlSyntax="" TextField="" ValueField=""></Enum>
</Field>
<Field Name="工作號" Value="job_id" DataType="int">
<Enum SqlSyntax="SELECT job_id, job_desc FROM jobs"
TextField="job_desc" ValueField="job_id"></Enum>
</Field>
<Field Name="工作等級" Value="job_lvl" DataType="int">
</Field>
<Field Name="雇傭日期" Value="hire_date" DataType="datetime">
</Field>
</Table>
</Fields>
三個設計細節值得留意:
把兩端拼起來看,一次查詢的完整流程是:
GetFields 取得欄位清單,快取在用戶端。GetOpts 與 GetEnums,決定運算子選項與輸入控制項的形態。整段過程中,只有第 1、2 步真的需要伺服器參與,而且傳輸量都在數百 bytes 等級。這正是 Ajax 「用什麼取什麼、用多少取多少」的價值所在。
這個案例最值得借鏡的不是 Ajax 語法,而是它把「查詢條件的描述」抽成一份資料驅動的設定檔:欄位、型別、列舉來源全部宣告式管理,介面則完全依宣告結果動態生成。下篇我們會看客戶端腳本如何把這些資訊變成真正的 DOM。