Struts2 類型轉換完整指南：全局/局部配置、錯誤處理、自定義轉換器

類型轉換雙向機制

• convertFromString：HTTP 參數（String） → Action 屬性（目標類型）
• convertToString：Action 屬性 → JSP 顯示（String）

兩種配置範圍

自定義轉換器開發步驟

1. 繼承 StrutsTypeConverter
2. 實現 convertFromString(Map, String[], Class)
3. 實現 convertToString(Map, Object)
4. 配置屬性/類型映射

實戰案例：Point 類型全局轉換

模型類

public class Point {
    private int left, right;
    // getter/setter 省略
}

轉換器

public class PointConverter extends StrutsTypeConverter {
    @Override
    public Object convertFromString(Map context, String[] values, Class toType) {
        String[] parts = values[0].split(",");
        Point p = new Point();
        p.setLeft(Integer.parseInt(parts[0]));
        p.setRight(Integer.parseInt(parts[1]));
        return p;
    }
    @Override
    public String convertToString(Map context, Object o) {
        Point p = (Point) o;
        return p.getLeft() + "-" + p.getRight();
    }
}

全局配置 xwork-conversion.properties

cn.com.leadfar.model.Point=cn.com.leadfar.struts2.actions.PointConverter

局部轉換案例：同類型不同格式

UserAction.beginDate 用 yyyy-MM-dd，User.endDate 用 yyyy/MM/dd

兩個轉換器

public class BeginDateConverter extends StrutsTypeConverter {
    private SimpleDateFormat fmt = new SimpleDateFormat("yyyy-MM-dd");
    // 實現 parse/format 邏輯
}
public class EndDateConverter extends StrutsTypeConverter {
    private SimpleDateFormat fmt = new SimpleDateFormat("yyyy/MM/dd");
    // 實現 parse/format 邏輯
}

局部配置文件

# UserAction-conversion.properties
beginDate=cn.com.leadfar.struts2.actions.BeginDateConverter

# User-conversion.properties
endDate=cn.com.leadfar.struts2.actions.EndDateConverter

轉換錯誤處理與顯示

覆蓋默認錯誤消息

# ActionClassName.properties
invalid.fieldvalue.age=年齡必須為數字

簡單主題下顯示錯誤

• EL：${fieldErrors.age[0]}
• 標簽：<s:fielderror fieldName="age"/>
• 去除 ul/li/span：覆蓋 template/simple/fielderror.ftl

進階場景

• 集合類型轉換：批量錄入，配合 TypeConversionInterceptor
• 復雜屬性：嵌套對象屬性鏈式轉換
• 初始化參數：可在 web.xml 配置