Struts 1 解決 Action/ActionForm 膨脹：DispatchAction、DynaActionForm、DynaValidatorForm 實戰指南

Struts 1 專案隨著功能增長，易陷入「Action 類別爆炸」與「ActionForm 類別爆炸」雙重困境。本文系統介紹三大內建機制：DispatchAction 合併同業務 Action、DynaActionForm 動態減少 Form Bean 類別、DynaValidatorForm 整合驗證框架，並給出完整配置步驟與最佳實踐。

1. 解決 Action 過多：DispatchAction

核心原理

單一 Action 類別包含多個業務方法（insert()、update()、delete()...），透過請求參數指定執行哪個方法。

實作步驟

1. 建立繼承 DispatchAction 的類別：

   public class UserDispatchAction extends DispatchAction {
       public ActionForward insert(ActionMapping mapping, ActionForm form,
                                   HttpServletRequest req, HttpServletResponse resp) {
           // 新增邏輯
           return mapping.findForward("success");
       }
       public ActionForward update(...) { ... }
       public ActionForward delete(...) { ... }
       public ActionForward query(...) { ... }
   }

2. JSP 表單加入隱藏域指定方法名：

   <html:form action="/userDispatch">
       <html:hidden property="method" value="insert"/> <-- 或 update/delete/query -->
       ... 其他欄位 ...
   </html:form>

3. struts-config.xml 配置 parameter 屬性：

   <action path="/userDispatch"
           type="com.example.UserDispatchAction"
           parameter="method"       <-- 對應隱藏域名稱 -->
           name="userForm"
           scope="request"
           validate="true">
       <forward name="success" path="/userList.do"/>
   </action>

提交表單時，DispatchAction 會根據 method 參數值動態調用對應方法。

2. 解決 ActionForm 過多：DynaActionForm

核心原理

無需編寫 Java 類別，直接在 struts-config.xml 宣告屬性名稱與型別，框架自動建立動態 Form Bean 實例。

配置步驟

<form-beans>
    <form-bean name="userForm"
               type="org.apache.struts.action.DynaActionForm">
        <form-property name="userId"   type="java.lang.Long"/>
        <form-property name="username" type="java.lang.String"/>
        <form-property name="email"    type="java.lang.String"/>
        <form-property name="age"      type="java.lang.Integer"/>
    </form-bean>
</form-beans>

Action 中取值：

DynaActionForm form = (DynaActionForm) actionForm;
Long userId = (Long) form.get("userId");
String username = (String) form.get("username");

3. 解決動態 Form 驗證：DynaValidatorForm + Validator 框架

配置步驟

1. struts-config.xml 宣告 DynaValidatorForm：

   <form-bean name="userForm"
              type="org.apache.struts.validator.DynaValidatorForm">
       <form-property name="userId"   type="java.lang.Long"/>
       <form-property name="username" type="java.lang.String"/>
       <form-property name="email"    type="java.lang.String"/>
   </form-bean>

2. 建立 validation.xml 定義驗證規則：

   <form-validation>
       <formset>
           <form name="userForm">
               <field property="username" depends="required,minlength,maxlength">
                   <arg key="user.username" resource="true"/>
                   <arg key="${var:minlength}" resource="false" position="1"/>
                   <arg key="${var:maxlength}" resource="false" position="2"/>
                   <var><var-name>minlength</var-name><var-value>2</var-value></var>
                   <var><var-name>maxlength</var-name><var-value>20</var-value></var>
               </field>
               <field property="email" depends="required,email">
                   <arg key="user.email" resource="true"/>
               </field>
           </form>
       </formset>
   </form-validation>

3. 資源檔 ApplicationResources.properties 定義錯誤訊息：

   user.username=用戶名
   user.email=電子郵件
   errors.required={0} 不能為空
   errors.minlength={0} 長度不能少於 {1} 字元
   errors.maxlength={0} 長度不能超過 {1} 字元
   errors.email={0} 格式不正確

4. Action 啟用驗證：

   <action path="/userDispatch"
           ...
           validate="true"          <-- 關鍵：啟用驗證 -->
           input="/userForm.jsp">   <-- 驗證失敗返回頁面 -->

5. 註冊 ValidatorPlugIn：

   <plug-in className="org.apache.struts.validator.ValidatorPlugIn">
       <set-property property="pathnames"
           value="/WEB-INF/validator-rules.xml,/WEB-INF/validation.xml"/>
   </plug-in>

最佳實踐總結

進階建議

• 組合使用：DispatchAction + DynaValidatorForm 可同時解決 Action 與 Form 膨脹並內建驗證。
• 遷移考量：Struts 1 維護模式，新專案建議直接採用 Spring MVC / Struts 2，原生支援註解、泛型、REST、類型安全表單綁定。

總結

DispatchAction、DynaActionForm、DynaValidatorForm 是 Struts 1 時代應對類別爆炸的三板斧。合理運用可大幅減少樣板代碼，將開發焦點集中在業務邏輯。但隨著框架演進，現代 MVC 框架已從根本上解決此類問題，建議新專案直接採用現代化技術棧。