SpringMVC使用@Valid註解實現數據驗證

一、@Valid 註解的作用

　　@Valid 註解是 javax.validation 包中的一個註解，它可以用來標註需要驗證的數據對象。當一個帶有 @Valid 註解的對象傳遞給 SpringMVC 的控制器方法時，SpringMVC 會自動調用驗證器來驗證這個對象。

二、數據驗證的流程

SpringMVC 中的數據驗證流程如下：

1. 客戶端發起請求。
2. DispatcherServlet 接收到請求後，根據請求的 URL 映射到對應的 Controller。
3. Controller 中的方法接收到請求後，如果有需要驗證的數據，就使用 @Valid 註解進行標註。
4. 如果數據驗證失敗，會拋出 MethodArgumentNotValidException 異常，SpringMVC 會自動將錯誤信息封裝成 JSON 格式返回給客戶端。
5. 如果數據驗證通過，Controller 方法會繼續執行。

三、如何使用 @Valid 註解

　　在 SpringMVC 中，我們可以在 Controller 方法的參數中使用 @Valid 註解來標註需要驗證的數據對象。例如：

@RequestMapping("/user")
public String addUser(@Valid User user, BindingResult result) {
    if (result.hasErrors()) {
        // 處理驗證失敗的情況
    }
    // 處理驗證成功的情況
}

　　在上面的例子中，我們使用 @Valid 註解標註了 User 對象，當這個對象傳遞給 addUser 方法時，SpringMVC 會自動調用驗證器來驗證這個對象。驗證結果會被封裝成一個 BindingResult 對象，我們可以通過它來獲取驗證結果。

四、數據驗證的規則

　　在使用 @Valid 註解進行數據驗證時，我們需要定義驗證規則。驗證規則可以通過在對應的數據對象中添加 javax.validation.constraints 包中的註解來實現。例如，我們可以在 User 類中添加如下註解：

public class User {
    @NotNull(message = "用戶名不能為空")
    private String username;
    @Size(min = 6, max = 20, message = "密碼長度必須在 6 到 20 個字元之間")
    private String password;
    @Email(message = "郵箱格式不正確")
    private String email;
    // 省略 getter 和 setter 方法
}

　　在上面的例子中，我們使用 @NotNull、@Size 和 @Email 註解來定義了用戶名、密碼和郵箱的驗證規則。如果這些規則被違反了，驗證器會自動將錯誤信息封裝成 BindingResult 對象返回給客戶端。

五、自定義驗證規則

　　除了使用 javax.validation.constraints 包中的註解來定義驗證規則外，我們還可以自定義驗證規則。自定義驗證規則需要實現 ConstraintValidator 介面，例如：

public class CheckCaseValidator implements ConstraintValidator<CheckCase, String> {
    private CaseMode caseMode;
    @Override
    public void initialize(CheckCase constraintAnnotation) {
        this.caseMode = constraintAnnotation.value();
    }
    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        if (value == null) {
            return true;
        }
        if (caseMode == CaseMode.UPPER) {
            return value.equals(value.toUpperCase());
        } else {
            return value.equals(value.toLowerCase());
        }
    }
}

　　在上面的例子中，我們實現了一個 CheckCaseValidator 驗證器，它可以用來驗證一個字元串是否全是大寫或全是小寫。這個驗證器需要使用 @CheckCase 註解來標註，例如：

public class User {
    @CheckCase(CaseMode.UPPER)
    private String name;
    // 省略 getter 和 setter 方法
}