在後台用戶管理模組裡,「所屬單位 → 單位名稱」這種上下級關聯的下拉選單幾乎是標配。用戶先挑一級類別,二級選單要跟著刷新出對應的選項,這就是所謂的二級聯動。本文以 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 二級聯動」的完整實作,提供給需要的朋友參考。