Struts2 ModelDriven 機制詳解：表單數據自動封裝最佳實踐

Struts2 ModelDriven 接口深度解析

ModelDriven 是 Struts2 提供的一種模型驅動機制，讓 Action 直接操作領域模型對象，省去大量 setter/getter 代碼，實現表單數據自動封裝。

核心原理

1. Action 實現 ModelDriven<T> 接口
2. 實現 getModel() 返回模型實例
3. 攔截器 ModelDrivenInterceptor 在 paramsPrepareParamsStack 中執行，將請求參數自動注入模型對象
4. 模型對象需提供無參構造器及屬性 setter

標準實現範例

public class UserAction extends ActionSupport implements ModelDriven<User> {
    private User user = new User(); // 模型實例

    @Override
    public User getModel() { return user; }

    public String register() {
        // 直接使用 user 對象，屬性已自動填充
        userService.save(user);
        return SUCCESS;
    }
}

// 領域模型
public class User {
    private String username;
    private String password;
    private String email;
    // getter/setter 省略
}

進階用法與注意點

1. 複雜對象圖封裝

支持巢狀屬性：user.address.city 對應表單字段名 user.address.city，OGNL 會自動遍歷對象圖。

2. 結合 Validateable 接口驗證

public class UserAction extends ActionSupport 
    implements ModelDriven<User>, Validateable {
    // ...
    @Override
    public void validate() {
        if (user.getUsername() == null || user.getUsername().length() < 3) {
            addFieldError("user.username", "用戶名至少3位");
        }
    }
}

3. 多模型切換陷阱

一個 Action 只能綁定一個模型。若需多模型，可：

• 組合模式：創建包含多個子模型的父模型
• 放棄 ModelDriven，改用 Preparable 手動封裝

常見問題排查

最佳實踐建議

1. 模型類放在獨立 package，避免與 Action 耦合
2. 優先使用 Preparable 初始化關聯對象（如下拉選項）
3. 大表單拆分為多個 Action，各司其職
4. 配合 JSON 插件實現 RESTful API 同樣受益於自動封裝

ModelDriven 將「數據傳輸」與「業務邏輯」解耦，是 Struts2 開發效率的關鍵槓桿。掌握其攔截器鏈位置與 OGNL 表達式規則，能避開 90% 的封裝坑點。