DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
原創通用組合查詢器(上篇):用 Ajax 打造免刷新的查詢條件建構器
編輯:AJAX詳解     

做過企業系統的人大概都遇過這個需求:使用者不肯乖乖填固定格式的查詢表單,他要自己選欄位、自己挑運算子、還要能把好幾個條件用「並且/或者」串起來。傳統做法要嘛寫死一堆查詢欄位,要嘛做一個複雜的進階查詢頁。本文示範的是另一條路:把欄位定義抽到 XML,用 Ajax 在瀏覽器端動態長出整個查詢介面。

設計要點

  1. 全程無回傳(no postback)更新,條件列的生成與輸入控制都在用戶端完成。
  2. 欄位中介資料存在 XML 檔裡,換資料庫、換專案只要改設定,不必動程式碼。
  3. 透過 JavaScript 呼叫 Ajax 框架(此例為 AjaxPro)取得欄位資訊。
  4. 由 JavaScript 拼出條件字串,交回伺服器使用。

運行效果如下:

一、AJaxSearchMethod.cs:三個對外開放的 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> 區段並加密,連線字串一旦進了版本控制就等於外洩。

二、AJaxSearchDataCollection.XML:把欄位定義變成設定檔

整個查詢器之所以「通用」,關鍵就在這份 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>

三個設計細節值得留意:

  • Name 與 Value 分離:Name 是給使用者看的中文標題,Value 才是真正進 SQL 的欄位名。介面友善與程式正確兩者兼得。
  • DataType 驅動一切:型別同時決定了運算子清單、輸入控制項、值的包裝方式(要不要加引號)。
  • <Enum> 用 SQL 撈列舉:像「工作號」這種對應到 jobs 表的欄位,不必手寫選項,直接一行 SELECT 就把下拉選單餵飽。設定的成本極低,擴充性極高。

三、串起上下的資料流

把兩端拼起來看,一次查詢的完整流程是:

  1. 查詢頁載入,JavaScript 呼叫 GetFields 取得欄位清單,快取在用戶端。
  2. 使用者新增一列條件,前端依欄位型別呼叫 GetOpts 與 GetEnums,決定運算子選項與輸入控制項的形態。
  3. 使用者操作條件,前端即時做數字/金額的按鍵過濾。
  4. 按下確定,前端拼出條件字串,寫入隱藏欄位。
  5. 伺服器取走字串,存入 Session 或直接套用於查詢。

整段過程中,只有第 1、2 步真的需要伺服器參與,而且傳輸量都在數百 bytes 等級。這正是 Ajax 「用什麼取什麼、用多少取多少」的價值所在。

小結

這個案例最值得借鏡的不是 Ajax 語法,而是它把「查詢條件的描述」抽成一份資料驅動的設定檔:欄位、型別、列舉來源全部宣告式管理,介面則完全依宣告結果動態生成。下篇我們會看客戶端腳本如何把這些資訊變成真正的 DOM。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved