@validated 注解的用法并非如其表面般簡(jiǎn)單。它在 spring 框架中扮演著數(shù)據(jù)校驗(yàn)的關(guān)鍵角色，但實(shí)際應(yīng)用中常常會(huì)遇到一些細(xì)微的難題。

@Validated 注解用于啟用 Spring 的校驗(yàn)功能。它并非直接校驗(yàn)數(shù)據(jù)，而是依賴于 JSR 380 (Bean Validation) 規(guī)范，配合注解如 @NotNull、@Min、@Max、@Size 等，對(duì)對(duì)象屬性進(jìn)行約束。 理解這一點(diǎn)至關(guān)重要，因?yàn)樵S多新手會(huì)誤以為 @Validated 本身就具備校驗(yàn)?zāi)芰Α?我曾經(jīng)就因?yàn)檫@個(gè)誤解，在項(xiàng)目早期花費(fèi)了大量時(shí)間排查問(wèn)題，最終才發(fā)現(xiàn)是缺少了必要的約束注解。

讓我們來(lái)看一個(gè)具體的例子。假設(shè)我們有一個(gè) User 對(duì)象：

public class User {
    @NotNull(message = "用戶名不能為空")
    private String username;

    @Size(min = 6, max = 20, message = "密碼長(zhǎng)度必須在6到20之間")
    private String password;

    // ... getters and setters ...
}

登錄后復(fù)制

在控制器中，我們可以這樣使用 @Validated 注解：

@RestController
public class UserController {

    @PostMapping("/users")
    public ResponseEntity<User> createUser(@Validated @RequestBody User user) {
        // ...  業(yè)務(wù)邏輯 ...
        return ResponseEntity.ok(user);
    }
}

登錄后復(fù)制

這段代碼中，@Validated 注解確保了 User 對(duì)象在進(jìn)入 createUser 方法之前，會(huì)根據(jù) @NotNull 和 @Size 注解進(jìn)行校驗(yàn)。如果校驗(yàn)失敗，Spring 會(huì)自動(dòng)拋出 MethodArgumentNotValidException 異常，其中包含所有校驗(yàn)錯(cuò)誤信息。 我曾經(jīng)在處理這個(gè)異常時(shí)，發(fā)現(xiàn)直接返回異常信息給前端不夠友好，于是增加了自定義異常處理機(jī)制，將錯(cuò)誤信息轉(zhuǎn)換成更易于理解的 JSON 格式返回給客戶端。這避免了用戶看到技術(shù)細(xì)節(jié)，提升了用戶體驗(yàn)。

然而，實(shí)際應(yīng)用中，你可能需要更精細(xì)的控制。例如，你可能只想校驗(yàn)部分字段，而不是所有字段。這時(shí)，你可以結(jié)合 @Valid 注解使用。 @Valid 注解會(huì)遞歸校驗(yàn)嵌套對(duì)象。 舉個(gè)例子，如果 User 對(duì)象包含一個(gè) Address 對(duì)象，并且 Address 對(duì)象也有自己的校驗(yàn)規(guī)則，那么 @Valid 注解就可以確保 Address 對(duì)象也得到校驗(yàn)。

另一個(gè)容易被忽略的點(diǎn)是自定義校驗(yàn)規(guī)則。 標(biāo)準(zhǔn)的注解可能無(wú)法滿足所有需求。這時(shí)，你可以創(chuàng)建自定義注解和校驗(yàn)器，來(lái)實(shí)現(xiàn)更復(fù)雜的校驗(yàn)邏輯。 我曾經(jīng)需要校驗(yàn)一個(gè)用戶輸入的郵箱格式是否符合公司內(nèi)部的規(guī)范，標(biāo)準(zhǔn)的郵箱校驗(yàn)注解無(wú)法滿足，于是編寫了一個(gè)自定義注解和校驗(yàn)器，成功解決了這個(gè)問(wèn)題。

總而言之，@Validated 注解是 Spring 中強(qiáng)大的數(shù)據(jù)校驗(yàn)工具，但其有效應(yīng)用需要對(duì) JSR 380 規(guī)范、異常處理以及自定義校驗(yàn)規(guī)則有深入的理解。 切勿掉以輕心，細(xì)致的處理才能保證應(yīng)用的穩(wěn)定性和健壯性。

路由網(wǎng)(www.lu-you.com)您可以查閱其它相關(guān)文章！