傳統表單單一提交按鈕無法滿足「新增/修改/刪除/匯出」等多操作需求。Struts 2 提供 **Dynamic Method Invocation (DMI)** 機制,允許單一 Action 類對應多個業務方法,透過請求參數 actionName!methodName 自動路由,無需配置多個 <action> 元素。本文詳細講解 DMI 原理、配置、安全限制與現代替代方案。
請求 URL/參數包含 actionName!methodName (或 actionName!methodName.action),Struts 2 ActionMapping 解析出 name=actionName、method=methodName,DefaultActionInvocation 反射調用對應方法。
<%@ 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」。
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"; // 對應 ...
}
}
<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>
DMI 預設允許調用 Action 類**任意公共無參方法**,含繼承自 ActionSupport 的方法,存在風險 (如 user!logout 調用基類方法)。
<action name="user" class="com.example.action.UserAction" method="execute">
<allowed-methods>save,delete,exportPdf,execute</allowed-methods>
<!-- 僅允許列表內方法,其他返回 404 -->
<result ...>...</result>
</action>
@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 { ... }
struts.action.extension=action,,
struts.enable.DynamicMethodInvocation=true # 預設 true
struts.allowed.action.names=.* # 正則限制 action 名稱
# 關鍵:全域預設拒絕所有方法,需在 action 級別显式 allowed-methods
struts.default.allowed.methods=execute # 或 regex
| 方案 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| 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 專案 (首選) |
allowed-methods 白名單,防止惡意調用內部方法。save/update/delete/list/export*,避免通用名稱 (doIt/process)。validate() 對應 execute();validateSave() 對應 save() (Struts 2 約定)。<s:url action="user!save"/> 生成連結,或 JS 動態構建。Struts 2 DMI 以 action!method 簡潔語法解決單表單多操作需求,配合 allowed-methods 白名單可有效控制暴露面。但隨著 RESTful 風潮與 Spring MVC 普及,**建議新專案採用每操作一個 Endpoint (Controller 方法) + HTTP Verb 語意** 設計,URL 清晰、可快取、可測試、符合 HTTP 標準,長期維護成本更低。