Struts 2 表單驗證整合 DWR 實現 AJAX 即時校驗效果實戰

Struts 2 內建驗證框架支援服務端校驗，配合 DWR (Direct Web Remoting) 可實現無刷新 AJAX 即時校驗。本文完整演示 DWR Servlet 配置、dwr.xml 規則定義、Struts 2 Ajax Theme 啟用與前後端整合流程。

架構原理

瀏覽器 (JS 事件) 
    → DWR Engine (JS) 
    → HTTP POST /dwr/... 
    → DWR Servlet (Server) 
    → DWRValidator (Struts 2 內建) 
    → 調用 Action 驗證邏輯 (validateXxx / validateDoXxx) 
    → 返回錯誤信息 JSON 
    → DWR Engine 更新頁面 DOM 顯示錯誤

步驟 1: 引入依賴

    org.directwebremoting
    dwr
    3.0.2-RELEASE 


    org.apache.struts
    struts2-dwr-plugin
    2.5.30 



    org.apache.struts
    struts2-dojo-plugin
    2.5.30

步驟 2: 配置 web.xml - DWR Servlet

    dwr
    org.directwebremoting.servlet.DwrServlet
    
        debug
        true 
    
    
        activeReverseAjaxEnabled
        false
    
    1


    dwr
    /dwr/*

步驟 3: 編寫 dwr.xml - 暴露驗證器

位置：`WEB-INF/dwr.xml`

    
        
        
            
        
        
        
    
    
        );
        ]]>
    

步驟 4: Action 實現驗證邏輯

package com.example.action;

import com.opensymphony.xwork2.ActionSupport;
import com.opensymphony.xwork2.validator.annotations.*;

public class UserAction extends ActionSupport {
    private String username;
    private String email;
    private String password;
    
    // Getter/Setter 省略
    
    // 字段級驗證 (對應字段名)
    @Validations(
        requiredStrings = {
            @RequiredStringValidator(fieldName = "username", message = "用戶名不能為空"),
            @RequiredStringValidator(fieldName = "email", message = "Email 不能為空"),
            @RequiredStringValidator(fieldName = "password", message = "密碼不能為空")
        },
        emails = {
            @EmailValidator(fieldName = "email", message = "Email 格式不正確")
        },
        stringLengthFields = {
            @StringLengthFieldValidator(fieldName = "username", minLength = "3", maxLength = "20", message = "用戶名長度 3-20"),
            @StringLengthFieldValidator(fieldName = "password", minLength = "6", maxLength = "30", message = "密碼長度 6-30")
        }
    )
    public String register() {
        // 業務邏輯
        userService.register(username, email, password);
        return SUCCESS;
    }
    
    // 也可實現 validate() 方法進行複雜邏輯驗證
    public void validate() {
        if (userService.exists(username)) {
            addFieldError("username", "用戶名已存在");
        }
    }
}

步驟 5: JSP 頁面啟用 Ajax Theme

<%@ taglib prefix="s" uri="/struts-tags" %>
<%@ taglib prefix="sx" uri="/struts-dojo-tags" %>


    
    
    
    
    



    
    
    
    

關鍵配置解析

現代化遷移建議

Struts 2 Ajax Theme + DWR + Dojo 屬於 2008-2012 年代技術棧，現代項目建議：

1. 前端驗證優先：HTML5 原生驗證 (`required`、`pattern`、`type="email"`) + JavaScript 即時反饋
2. 後端 API 驗證：Spring MVC `@Valid` + `@RequestBody` + Bean Validation (Hibernate Validator) 返回結構化錯誤 JSON
3. 前端框架整合：React/Vue/Angular 表單庫 (React Hook Form、VeeValidate、Angular Reactive Forms) 管理狀態與顯示
4. 統一錯誤格式：RFC 7807 Problem Details / 自定義 `{field, message, code}` 結構
5. 移除 DWR/Dojo：雙向綁定框架 + REST API 完全替代 DWR 遠程調用模式

常見問題排查

總結

Struts 2 + DWR + Ajax Theme 實現了服務端驗證邏輯零重複、前端即時反饋的經典模式。雖技術棧老舊，但驗證邏輯後置、前後端複用、聲明式配置的設計思想在現代 React/Vue + Spring Boot 架構中依然閃光。理解此整合機制，有助於遺留系統維護、遷移決策與現代驗證架構設計。