3. 分組校驗

一個VO對象在新增的時候某些字段為必填，在更新的時候又非必填。如上面的ValidVO中 id`` 和 appId 屬性在新增操作時都是 非必填 ，而在編輯操作時都為 必填 ，name在新增操作時為 必填 ，面對這種場景你會怎么處理呢？ 在實際開發中我見到很多同學都是建立兩個VO對象，ValidCreateVO，ValidEditVO來處理這種場景，這樣確實也能實現效果，但是會造成類膨脹。

其實Validator校驗框架已經考慮到了這種場景并且提供了解決方案，就是 分組校驗 ，只不過很多同學不知道而已。

要使用分組校驗，只需要三個步驟。

3.1. 第一步，定義分組接口

public interface ValidGroup extends Default {

    interface Crud extends ValidGroup{
        interface Create extends Crud{

        }

        interface Update extends Crud{

        }

        interface Query extends Crud{

        }

        interface Delete extends Crud{

        }
    }
}

這里我們定義一個分組接口ValidGroup讓其繼承javax.validation.groups.Default，再在分組接口中定義出多個不同的操作類型，Create，Update，Query，Delete。

3.2. 第二步，在模型中給參數分配分組

@Data
public class ValidVO {
    @Null(groups = ValidGroup.Crud.Create.class)
    @NotNull(groups = ValidGroup.Crud.Update.class, message = "應用ID不能為空")
    private String id;

    @Length(min = 6,max = 12,message = "appId長度必須位于6到12之間")
    @Null(groups = ValidGroup.Crud.Create.class)
    @NotNull(groups = ValidGroup.Crud.Update.class, message = "應用ID不能為空")
    private String appId;

    @NotBlank(message = "名字為必填項")
    @NotBlank(groups = ValidGroup.Crud.Create.class,message = "名字為必填項")
    private String name;

    @Email(message = "請填寫正確的郵箱地址")
    private String email;

    @EnumString(value = {"F","M"}, message="性別只允許為F或M")
    private String sex;

    @NotEmpty(message = "級別不能為空")
    private String level;
}

給參數指定分組，對于未指定分組的則使用的是默認分組。

3.3. 第三步，給需要參數校驗的方法指定分組

@PostMapping(value = "/valid/add")
public String add(@Validated(value = ValidGroup.Crud.Create.class) ValidVO validVO){
 log.info("validEntity is {}", validVO);
 return "test3 valid success";
}

@PostMapping(value = "/valid/update")
public String update(@Validated(value = ValidGroup.Crud.Update.class) ValidVO validVO){
 log.info("validEntity is {}", validVO);
 return "test4 valid success";
}

這里我們通過value屬性給add()和update()方法分別指定Create和Update分組

3.4. 測試

POST http://localhost:8080/valid/add
Content-Type: application/x-www-form-urlencoded

name=javadaily&level=12&email=476938977@qq.com&sex=F

• Create操作

在Create時我們 沒有傳遞id和appId參數 ，校驗通過。

{
  "status": 100,
  "message": "操作成功",
  "data": "test3 valid success",
  "timestamp": 1652186105359
}

• update操作

使用同樣的參數調用update方法時則提示參數校驗錯誤

{
  "status": 400,
  "message": "ID不能為空; 應用ID不能為空",
  "data": null,
  "timestamp": 1652186962377
}
復制代碼

• 默認校驗生效操作

由于email屬于默認分組，而我們的分組接口ValidGroup已經繼承了Default分組，所以也是可以對email字段作參數校驗的。故意寫錯email格式

POST http://localhost:8080/valid/add
Content-Type: application/x-www-form-urlencoded

/valid/update?name=javadaily&level=12&email=476938977&sex=F

{
  "status": 400,
  "message": "請填寫正確的郵箱地址; ID不能為空; 應用ID不能為空",
  "data": null,
  "timestamp": 1652187273865
}

4. 業務規則校驗

業務規則校驗指接口需要滿足某些特定的業務規則，舉個例子：業務系統的用戶需要保證其唯一性，用戶屬性不能與其他用戶產生沖突，不允許與數據庫中任何已有用戶的用戶名稱、手機號碼、郵箱產生重復。 這就要求在 創建用戶時需要校驗用戶名稱、手機號碼、郵箱是否被注冊 ； 編輯用戶時不能將信息修改成已有用戶的屬性 。最優雅的實現方法應該是參考 **Bean Validation** 的標準方式，借助自定義校驗注解完成業務規則校驗。

4.1. 自定義注解

首先我們需要創建兩個自定義注解，用于業務規則校驗：

• UniqueUser:表示一個用戶是唯一的，唯一性包含：用戶名，手機號碼、郵箱

@Documented
@Retention(RUNTIME)
@Target({FIELD, METHOD, PARAMETER, TYPE})
@Constraint(validatedBy = UserValidation.UniqueUserValidator.class)
public @interface UniqueUser {

    String message() default "用戶名、手機號碼、郵箱不允許與現存用戶重復";

    Class?[] groups() default {};

    Class? extends Payload[] payload() default {};
}

• NotConflictUser:表示一個用戶的信息是無沖突的，無沖突是指該用戶的敏感信息與其他用戶不重合

@Documented
@Retention(RUNTIME)
@Target({FIELD, METHOD, PARAMETER, TYPE})
@Constraint(validatedBy = UserValidation.NotConflictUserValidator.class)
public @interface NotConflictUser {
    String message() default "用戶名稱、郵箱、手機號碼與現存用戶產生重復";

    Class?[] groups() default {};

    Class? extends Payload[] payload() default {};
}

4.2. 實現業務校驗規則

想讓自定義驗證注解生效，需要實現 ConstraintValidator 接口。接口的第一個參數是 自定義注解類型 ，第二個參數是 被注解字段的類 ，因為需要校驗多個參數，我們直接傳入用戶對象。 需要提到的一點是 ConstraintValidator 接口的實現類無需添加 @Component 它在啟動的時候就已經被加載到容器中了。

@Slf4j
public class UserValidation<T extends Annotation> implements ConstraintValidator<T, User> {

    protected Predicate

這里使用Predicate函數式接口對業務規則進行判斷。

4.3. 測試代碼

@RestController
@RequestMapping("/senior/user")
@Slf4j
@Validated
public class UserController {
    @Autowired
    private UserRepository userRepository;


    @PostMapping
    public User createUser(@UniqueUser @Valid User user){
        User savedUser = userRepository.save(user);
        log.info("save user id is {}",savedUser.getId());
        return savedUser;
    }

    @SneakyThrows
    @PutMapping
    public User updateUser(@NotConflictUser @Valid @RequestBody User user){
        User editUser = userRepository.save(user);
        log.info("update user is {}",editUser);
        return editUser;
    }
}

使用很簡單，只需要在方法上加入自定義注解即可，業務邏輯中不需要添加任何業務規則的代碼。

POST http://localhost:8080/valid/add
Content-Type: application/json

    /senior/user

{
    "userName" : "100001"
}

{
	"status": 400,
	"message": "用戶名、手機號碼、郵箱不允許與現存用戶重復",
	"data": null,
	"timestamp": 1652196524725
}

5. 總結

通過上面幾步操作，業務校驗便和業務邏輯就完全分離開來，在需要校驗時用@Validated注解自動觸發，或者通過代碼手動觸發執行，可根據你們項目的要求，將這些注解應用于控制器、服務層、持久層等任何層次的代碼之中。 這種方式比任何業務規則校驗的方法都優雅，推薦大家在項目中使用。在開發時可以將不帶業務含義的格式校驗注解放到 Bean 的類定義之上，將帶業務邏輯的校驗放到 Bean 的類定義的外面。這兩者的區別是放在類定義中的注解能夠自動運行，而放到類外面則需要像前面代碼那樣，明確標出注解時才會運行。