萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

Struts 1 中 JSP 多選框數據綁定與回顯機制詳解

問題場景

編輯用戶/角色權限頁面,多選框組對應數據庫多對多關係。需求:

  1. 新建時:默認未選中
  2. 編輯時:自動回顯已授權項目 (預選中)
  3. 提交時:將勾選值綁定到 Form Bean 集合屬性

Struts 1 原生機制

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; }
}

JSP 頁面實現

<%@ 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__"> <!-- 關鍵:未勾選也提交 -->
  • Struts 控制器檢測到 __UNCHECKED__ 會從數組中移除對應值,實現「取消勾選=移除」
  • value 屬性對應數組元素值,property 對應 Form Bean 集合屬性名

Controller 處理流程

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 直接輸出分頁/虛擬滾動/改用雙向選擇器組件

現代化替代:前端組件 + REST API

<!-- Vue + Element UI 示例 -->
<el-transfer
    v-model="form.roleIds"
    :data="roleOptions"
    titles="可用角色,已授角色"
    filterable
    format="角色: ${name} (${code})"
/>

// 提交時 form.roleIds 直接是選中的 ID 數組,無需 hidden 技巧

前後端分離架構下,多選綁定由前端框架 (Vue/React/Angular) 管理,後端僅接收 JSON 數組,更靈活高效。

copyright © 萬盛學電腦網 all rights reserved