JAVA 注解校验神器@Valid@validated分组校验、条件校验、自定义校验

本文链接：https://blog.youkuaiyun.com/weixin_44248490/article/details/108779144

本文探讨了在Spring Boot应用中如何使用Lombok和Hibernate Validator实现用户注册表单的校验，包括公共字段和分组校验的策略，提高代码灵活性和可维护性。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

需要校验的实体类，在属性上标注相应的注解

import lombok.Data;
import org.apache.ibatis.annotations.Insert;
import org.apache.ibatis.annotations.Update;
import org.hibernate.validator.constraints.Length;

import javax.validation.constraints.NotBlank;

@Data
public class UserForm {
    @Length(min = 3, max = 20, message = "用户名长度在3到20个字符")
    private String username;

    @Length(min = 5, max = 20, message = "密码长度在5到20个字符", groups = {Insert.class})
    private String password;

    @NotBlank(message = "用户手机号不能为空")
    private String mobile;

    @NotBlank(message = "用户姓名不能为空", groups = {Update.class})
    private String name;

    @NotBlank(message = "用户描述不能为空")
    private String description;
}

controller里对该参数@valid校验

    @PostMapping
    public Result add(@Valid @RequestBody UserForm userForm) {
        //获取java默认的校验器。在spring项目中可以设为单例bean然后注入，本demo直接获取
        Validator validator = Validation.buildDefaultValidatorFactory().getValidator();
        //获得校验不通过的结果，保存到set
        Set<ConstraintViolation<Object>> set = validator.validate(userForm, Insert.class);
        if (set != null && set.size() > 0) 
            throw new ValidationException(set.iterator().next().getMessage());
        //todo 你的业务逻辑
        return Result.success();
    }

这里做了两层校验：
1、参数里的@Valid是对UserForm中没有标注group分组的属性（比如用户名、手机号、描述）进行校验；
2、validator.validate(userForm, Insert.class)，针对标注了Insert.class分组的属性进行校验（也就是password字段）。

这样做的好处是：
1、对于所有分组都需要校验的公共字段，就可以不添加任何groups；
2、公共参数校验通过后，使用validator.validate()方法再进行个性化的校验，可以更加灵活；
3、这里的validator可以使用java默认的，也可以使用自定义的，扩展性很强。