萬盛學電腦網

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

Struts 2 单表單多提交按鈕處理:Action 多方法映射實戰

傳統表單單一提交按鈕無法滿足「新增/修改/刪除/匯出」等多操作需求。Struts 2 提供 **Dynamic Method Invocation (DMI)** 機制,允許單一 Action 類對應多個業務方法,透過請求參數 actionName!methodName 自動路由,無需配置多個 <action> 元素。本文詳細講解 DMI 原理、配置、安全限制與現代替代方案。

核心機制:! 語法與 Method 屬性

請求 URL/參數包含 actionName!methodName (或 actionName!methodName.action),Struts 2 ActionMapping 解析出 name=actionName、method=methodName,DefaultActionInvocation 反射調用對應方法。

完整實戰範例

1. JSP 表單:多個 Submit 按鈕帶入不同 method 參數

<%@ taglib prefix="s" uri="/struts-tags" %>
<s:form action="user" method="post">
    <s:textfield name="user.name" label="姓名" />
    <s:textfield name="user.email" label="Email" />
    
    <!-- 關鍵:按鈕 name 為 "actionName!methodName",value 任意 -->
    <s:submit name="user!save" value="儲存" />
    <s:submit name="user!delete" value="刪除" />
    <s:submit name="user!exportPdf" value="匯出 PDF" />
    
    <!-- 普通按鈕不提交 method,走預設 execute() -->
    <s:submit value="預設動作" />
</s:form>

生成 HTML:

<input type="submit" name="user!save" value="儲存" />
<input type="submit" name="user!delete" value="刪除" />
<input type="submit" name="user!exportPdf" value="匯出 PDF" />

用戶點擊「儲存」 → 瀏覽器送出 user!save=儲存 參數 → Struts 2 解析 action=「user」、method=「save」。

2. Action 類:定義多個公共方法,返回 Result 類型字串

package com.example.action;

import com.example.model.User;
import com.opensymphony.xwork2.ActionSupport;

public class UserAction extends ActionSupport {
    private User user; // 模型驅動或屬性驅動均可
    // getter/setter 略

    // 預設方法 (無 method 參數時調用)
    @Override
    public String execute() {
        return LIST; // 導向列表頁
    }

    public String save() {
        if (user != null) {
            userService.save(user);
            addActionMessage("儲存成功");
        }
        return SUCCESS; // 對應 struts.xml ...
    }

    public String delete() {
        if (user != null && user.getId() != null) {
            userService.delete(user.getId());
            addActionMessage("刪除成功");
        }
        return SUCCESS;
    }

    public String exportPdf() {
        // 生成 PDF 邏輯
        return "pdf"; // 對應 ...
    }
}

3. struts.xml 配置:單一 action 映射多結果

<package name="default" namespace="/" extends="struts-default">
    <action name="user" class="com.example.action.UserAction">
        <result name="success">/user/form.jsp</result>
        <result name="input">/user/form.jsp</result> <!-- 驗證失敗返回 -->
        <result name="list" type="redirectAction">
            <param name="actionName">userList</param>
        </result>
        <result name="pdf" type="stream">
            <param name="contentType">application/pdf</param>
            <param name="inputName">pdfStream</param>
            <param name="contentDisposition">attachment;filename="users.pdf"</param>
        </result>
    </action>
</package>

進階:Method 名稱驗證與安全限制

DMI 預設允許調用 Action 類**任意公共無參方法**,含繼承自 ActionSupport 的方法,存在風險 (如 user!logout 調用基類方法)。

1. 白名單限制 (struts.xml)

<action name="user" class="com.example.action.UserAction" method="execute">
    <allowed-methods>save,delete,exportPdf,execute</allowed-methods>
    <!-- 僅允許列表內方法,其他返回 404 -->
    <result ...>...</result>
</action>

2. 註解式配置 (Struts 2.3+)

@Action(value = "user", 
        allowedMethods = "save,delete,exportPdf,execute",
        results = {
            @Result(name = "success", location = "/user/form.jsp"),
            @Result(name = "pdf", type = "stream", params = {"contentType", "application/pdf"})
        })
public class UserAction extends ActionSupport { ... }

3. 全域預設拒絕 (struts.properties / struts.xml)

struts.action.extension=action,,
struts.enable.DynamicMethodInvocation=true  # 預設 true
struts.allowed.action.names=.*  # 正則限制 action 名稱
# 關鍵:全域預設拒絕所有方法,需在 action 級別显式 allowed-methods
struts.default.allowed.methods=execute  # 或 regex

替代方案對比:為何現代專案少用 DMI

方案優點缺點適用場景
DMI (! 語法)零配置多方法、單一 Action 類聚合相關操作安全風險、URL 醜陋、RESTful 不友善、難以單元測試單一方法傳統 Struts 2 專案維護、快速原型
多 Action 類 (CRUD 分離)單一職責、易測試、URL 語意清晰 (/user/save, /user/delete)類別數量多、共享邏輯需抽取基類/Service標準 MVC、RESTful API
REST Plugin (Struts 2 REST Plugin)標準 REST 對應 (GET/POST/PUT/DELETE → show/create/update/destroy)學習曲線、彈性較低純 REST API 專案
Spring MVC @RequestMapping類型安全、方法級映射、參數綁定強大、生態成熟需 Spring 環境現代 Spring Boot 專案 (首選)

最佳實踐總結

  1. 必須配置 allowed-methods 白名單,防止惡意調用內部方法。
  2. 方法命名語意化:save/update/delete/list/export*,避免通用名稱 (doIt/process)。
  3. 共享邏輯提取至 Service 層,Action 僅處理參數綁定、驗證、結果導向。
  4. 驗證邏輯:validate() 對應 execute();validateSave() 對應 save() (Struts 2 約定)。
  5. 避免在 JSP 硬編碼 method 名稱:使用 <s:url action="user!save"/> 生成連結,或 JS 動態構建。

結語

Struts 2 DMI 以 action!method 簡潔語法解決單表單多操作需求,配合 allowed-methods 白名單可有效控制暴露面。但隨著 RESTful 風潮與 Spring MVC 普及,**建議新專案採用每操作一個 Endpoint (Controller 方法) + HTTP Verb 語意** 設計,URL 清晰、可快取、可測試、符合 HTTP 標準,長期維護成本更低。

copyright © 萬盛學電腦網 all rights reserved