DIV CSS 佈局教程網

jQuery + Ajax 實現二級聯動下拉框(Struts2 JSON 插件實戰)
編輯:JQuery入門技巧     

在後台用戶管理模組裡,「所屬單位 → 單位名稱」這種上下級關聯的下拉選單幾乎是標配。用戶先挑一級類別,二級選單要跟著刷新出對應的選項,這就是所謂的二級聯動。本文以 Struts2 搭配 JSON 插件為後端,前端用 jQuery 異步取數,把整個流程走一遍。

先看效果

一、引入 Struts2 的 JSON 插件包

後端要能把 Java 集合直接序列化成 JSON,第一步就是把 struts2-json-plugin 這類整合包放進依賴裡,並在配置中啟用 json-default 父套件,後面第四節會再回到這一步。

二、前端:用 jQuery 異步請求二級資料

核心思路很簡單:取到一級下拉框當前選中項的文字,把它當作查詢條件丟給後端,回來之後清空二級下拉框再逐項填充。清空時要注意保留「請選擇」這類佔位項,這裡示範的是全清後重建。

// 二級聯動:根據所選的「貨物所屬單位」查詢其下對應的單位名稱列表
function findJctUnit(o){
  // 取得所選 option 的文字內容作為查詢關鍵字
  var jct = $(o).find("option:selected").text();
  $.post("elecUserAction_findJctUnit.do", {"jctID": jct}, function(data, textStatus){
    // 先清空單位名稱下拉框(實務上可保留「請選擇」一項)
    $("#jctUnitID option").remove();
    if(data != null && data.length > 0){
      for(var i = 0; i < data.length; i++){
        var ddlCode = data[i].ddlCode;
        var ddlName = data[i].ddlName;
        // 逐項組裝 option 並附加到二級下拉框
        var $option = $("<option></option>");
        $option.attr("value", ddlCode);
        $option.text(ddlName);
        $("#jctUnitID").append($option);
      }
    }
  });
}

三、後端:Action 中定義 findJctUnit 方法

這裡的關鍵是「把 List 壓到值棧頂」,剩下的序列化工作交給 JSON 插件完成。

/**
 * @Name: findJctUnit
 * @Description: 使用 jQuery 的 ajax 完成二級聯動,以所屬單位關聯單位名稱
 * @Return: 由 struts2 的 json 插件負責輸出
 */
public String findJctUnit(){
  // 1. 取得頁面提交的一級單位值(注意這是業務欄位 jctID,不是字典的 ddlCode)
  String jctID = elecUser.getJctID();
  // 2. 以該值作為字典類型,查詢對應的數據字典項,回傳 List<ElecSystemDDL>
  List<ElecSystemDDL> list = elecSystemDDLService.findSystemDDLListByKeyword(jctID);
  // 3. 把集合放到值棧頂,由 json 插件轉成陣列
  ValueUtils.pushValueStack(list);
  return "findJctUnit";
}

其中 findSystemDDLListByKeyword(jctID) 定義在數據字典的 Service 層,作用是以字典類型名稱為條件撈出清單並回傳 List。ValueUtils 只是一個小工具類,負責把物件壓進 Struts2 值棧:

public class ValueUtils {
  public static void pushValueStack(Object object) {
    ServletActionContext.getContext().getValueStack().push(object);
  }
}

壓入值棧之後,JSON 插件會把集合內每個物件的所有屬性都序列化出來。

四、struts.xml 的兩處調整

(1)把 package 的 extends 從 struts-default 換成 json-default:

<!-- 修改前 -->
<package name="system" extends="struts-default" namespace="/system">

<!-- 修改後 -->
<package name="system" extends="json-default" namespace="/system">

(2)加上 result 映射,型別標為 json:

<!-- List 會轉成 json 陣列,單一物件會轉成 json 物件 -->
<result name="findJctUnit" type="json"></result>

做完這四步,選定一級下拉框後,二級下拉框就會同步出現對應的單位名稱。

直接在瀏覽器位址列拜訪該 Action,可以看到插件吐出的原始 JSON:

補充:只序列化需要的欄位

如果不想把物件的每個屬性都丟給前端,可以用 includeProperties 參數配合正則運算式做白名單:

<result name="findJctUnit" type="json">
  <param name="includeProperties">\[\d+\]\.ddlCode,\[\d+\]\.ddlName</param>
</result>

這段正則攔截了集合中每一項的 ddlCode 與 ddlName,輸出的 JSON 就只保留這兩個欄位,資料量更小、也更不容易把敏感欄位外洩。

以上就是「用戶管理的設計 + jQuery Ajax 二級聯動」的完整實作,提供給需要的朋友參考。

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