編輯用戶/角色權限頁面,多選框組對應數據庫多對多關係。需求:
Struts 1 ActionForm 支持數組/集合類型屬性自動綁定多選框值:
public class UserForm extends ActionForm {
private String[] roleIds; // 或 List roleIds
public String[] getRoleIds() { return roleIds; }
public void setRoleIds(String[] roleIds) { this.roleIds = roleIds; }
}
<%@ taglib uri="https://struts.apache.org/tags-html" prefix="html" %>
<%@ taglib uri="https://java.sun.com/jsp/jstl/core" prefix="c" %>
<html:form action="/user/save">
<table>
<c:forEach items="${allRoles}" var="role" varStatus="vs">
<tr>
<td>
<html:multibox property="roleIds" value="${role.id}" />
</td>
<td>${role.name}</td>
</tr>
</c:forEach>
</table>
<html:submit value="保存"/>
</html:form>
<html:multibox property="roleIds" value="1001" /> 生成:
<input type="checkbox" name="roleIds" value="1001">
<input type="hidden" name="roleIds" value="__UNCHECKED__"> <!-- 關鍵:未勾選也提交 -->
__UNCHECKED__ 會從數組中移除對應值,實現「取消勾選=移除」value 屬性對應數組元素值,property 對應 Form Bean 集合屬性名public class UserAction extends DispatchAction {
public ActionForward edit(ActionMapping mapping, ActionForm form,
HttpServletRequest request, HttpServletResponse response) {
UserForm uf = (UserForm) form;
Long userId = Long.valueOf(request.getParameter("id"));
User user = userService.findById(userId);
// 關鍵:設置已授權角色 ID 數組,JSP 自動回顯
uf.setRoleIds(user.getRoleIds().toArray(new String[0]));
request.setAttribute("allRoles", roleService.findAll());
return mapping.findForward("edit");
}
public ActionForward save(ActionMapping mapping, ActionForm form, ...) {
UserForm uf = (UserForm) form;
// uf.getRoleIds() 已自動包含所有勾選的 roleId
userService.updateRoles(uf.getId(), Arrays.asList(uf.getRoleIds()));
return mapping.findForward("success");
}
}
| 問題 | 原因 | 解決 |
|---|---|---|
| 編輯頁全不勾選 | Form Bean 屬性為 null 或類型不匹配 | 確保屬性初始化為空數組 new String[0],類型一致 |
| 提交後丟失未勾選項 | 缺少 hidden 欄位或表單未正確提交 | 必須使用 <html:multibox> 自動生成 hidden |
| 類型轉換異常 | Form 屬性為 List,提交為數組 | 統一用 String[],或在 Action 中轉換 Arrays.asList(arr) |
| 大量數據渲染慢 | 幾千個 checkbox 直接輸出 | 分頁/虛擬滾動/改用雙向選擇器組件 |
<!-- Vue + Element UI 示例 -->
<el-transfer
v-model="form.roleIds"
:data="roleOptions"
titles="可用角色,已授角色"
filterable
format="角色: ${name} (${code})"
/>
// 提交時 form.roleIds 直接是選中的 ID 數組,無需 hidden 技巧
前後端分離架構下,多選綁定由前端框架 (Vue/React/Angular) 管理,後端僅接收 JSON 數組,更靈活高效。