平常业务中肯定少不了校验，如果我们把大量的校验代码夹杂到业务中，肯定是不优雅的，对于一些简单的校验，我们可以使用java为我们提供的api进行处理，同时对于一些较为复杂的关联校验，spring也为我们提供了一些处理方式。更加复杂校验的话，只能进行代码逻辑处理了。

@Valid

Java定义的一套基于注解的数据校验规范，比如@Null、@NotNull、@Pattern等，它们位于
javax.validation.constraints这个包下，它是JSR 303规范的一部分，主要用于Hibernate Validation等场景。

@Valid注解是支持嵌套验证，同时可以配合BindingResult可以直接提供参数验证结果。

@Valid注解可以用在方法、构造函数、方法参数和成员属性上（方法, 构造器, 参数,字段, 泛型）

@Validated

Spring框架特有的注解，属于Spring的一部分，也是JSR 303的一个变种。在JSR 303基础上增加了一些其他校验注解，如 @NotBlank、@NotEmpty、@Length等，它们位于
org.hibernate.validator.constraints这个包下。

@Validated注解在
org.springframework.validation.annotation包下。

@Validated注解对@Valid进行了二次封装，在使用上并没有区别。支持分组校验，不支持嵌套验证。

@Validated注解可以用在类型、方法和方法参数上（类, 方法, 参数）。但不能用于成员属性。

依赖

hibernate validator框架已经集成在 spring-boot-starter-web中，所以无需再添加其他依赖。如果不是Spring Boot项目，需要添加如下依赖。

  org.hibernate.validator
  hibernate-validator
  6.0.9.Final

BindingResult

BindingResult用在实体类校验信息返回结果绑定。

该类作为方法入参，要写在实体对象后面。

@PostMapping(value = "/test")
public String test(@RequestBody @Validated ValidTest validTest, BindingResult bindingResult, HttpServletResponse httpServletResponse){
    if (bindingResult.hasErrors()) {
        List allErrors = bindingResult.getAllErrors();
        for (ObjectError allError : allErrors) {
            return allError.getDefaultMessage();
        }
    }
    return "成功";
}

@Valid中的常用注解

@Digits(integer, fraction)举例：

//最大支持99.99，因为整数位最多两位，小数位最多两位
@Digits(integer = 2,fraction = 2)
private Integer name;

@Validate中的常用注解

自定义校验

《自定义validation注解的应用》

分组校验

这一篇文章里写的是我们动态的指定那些校验生效

《使用Hibernate的validator做多字段联合校验》

实际上我们可以在校验入库处指定哪个分组的校验生效，在每一个校验注解中，都有一个Class[] groups() default { }字段，这个字段不写呢默认就是Default分组，但是我们也可以对这些校验指定分组，然后在校验入口处@Validated注解中指定校验的分组。

使用

• 单参数校验

@RestController
//
@Validated
public class ValidController {
    @GetMapping(value = "/test1")
    public String test(@NotBlank(message = "name字段不能为空") String name){
        return "success";
    }
}

• 多参数校验

被校验参数实体类

public class ValidTest {
    @Length
    private String name;
  	//注意这里要使用@Valid而不是@Validated
  	//@Validated不支持嵌套校验
    @Valid
    private Inner inner;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
    public static class Inner{
        @NotBlank(message = "地址不能为空!")
        private String address;

        public String getAddress() {
            return address;
        }

        public void setAddress(String address) {
            this.address = address;
        }
    }
}

@RestController
public class ValidController {
    @PostMapping(value = "/test")
  	//这里使用@Validated或者@Valid都可以
    public String test(@RequestBody @Validated ValidTest validTest, BindingResult bindingResult, HttpServletResponse httpServletResponse){
        httpServletResponse.setHeader("content-type","application/json;charset=UTF-8");
        if (bindingResult.hasErrors()) {
            List allErrors = bindingResult.getAllErrors();
            for (ObjectError allError : allErrors) {
                return allError.getDefaultMessage();
            }
        }
        return "success";
    }
}

• 分组校验

//新建新增分组
public interface Add {
}
//新建变更分组
public interface Update {
}

被校验参数实体类

public class ValidTest {
  	//只有新增分组的时候校验
    @Length(groups = Add.class,max = 3,message = "name length is too long")
    private String name;
  	//只有变更分组的时候校验
    @NotBlank(message = "path is blank!",groups = Update.class)
    private String path;
    @Valid
    private Inner inner;

    public String getPath() {
        return path;
    }

    public void setPath(String path) {
        this.path = path;
    }

    public Inner getInner() {
        return inner;
    }

    public void setInner(Inner inner) {
        this.inner = inner;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
    public static class Inner{
      	//只有变更分组的时候校验
        @NotBlank(message = "address is blank!",groups = Update.class)
        private String address;

        public String getAddress() {
            return address;
        }

        public void setAddress(String address) {
            this.address = address;
        }
    }
}

@RestController
public class ValidController {
    @PostMapping(value = "/group")
  	//增加变更分组
    public String group(@RequestBody @Validated(Update.class) ValidTest validTest, BindingResult bindingResult, HttpServletResponse httpServletResponse){
        httpServletResponse.setHeader("content-type","application/json;charset=UTF-8");
        if (bindingResult.hasErrors()) {
            List allErrors = bindingResult.getAllErrors();
            for (ObjectError allError : allErrors) {
                return allError.getDefaultMessage();
            }
        }
        return "success";
    }
}

• 统一字段多个校验

public class ValidTest {
  	//大部分注解都是支持这么做的，在同一个字段上使用集合进行多次校验
    @Length.List(value = {
            @Length(min = 1,message = "name length is too short"),
            @Length(max = 4,message = "name length is too long")
    })
    private String name;
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
   
}

• 组序列

默认情况下 不同级别的约束验证是无序的，但是在一些情况下，顺序验证却是很重要。一个组可以定义为其他组的序列，使用它进行验证的时候必须符合该序列规定的顺序。在使用组序列验证的时候，如果序列前边的组验证失败，则后面的组将不再给予验证。

举个例子，这三个参数校验，我想先校验不能为空，如果再校验正则信息，一般情况下，校验是无序的，可能会先校验格式错误，在校验不能为空，这是不符合规定的，那么我们该怎么办呢？

//使用@GroupSequence定义分组顺序，校验执行顺序先执行Default分组，再执行Order1分组
@GroupSequence({Default.class,Order1.class})
public interface IGroup {
}

@Pattern(regexp = "^[0-9]+(\\.[0-9]{1,2})?$",message = "视联网能力收入金额（含税）（万元）格式错误",groups = Order1.class)
@NotBlank(message = "视联网能力收入金额（含税）（万元） 不能为空")
private String videoNetInfoAmount;

@Pattern(regexp = "^[0-9]+(\\.[0-9]{1,2})?$",message = "视联网能力收入占比 格式错误",groups = Order1.class)
@NotBlank(message = "视联网能力收入占比 不能为空")
private String incomeRate;

@Pattern(regexp = "^[0-9]{1,12}$",message = "连接数 格式错误",groups = Order1.class)
@NotBlank(message = "连接数 不能为空")
private String connectionsNum;

这样的话，会先校验Default分组的，校验通过以后，再校验Order1分组的。

获取校验器

如果我们不想使用注解@Valid或者@Validate进行校验的话，可以使用Validator进行编程式校验。

• spring

//使用spring注入一个Validator
@Bean
public Validator validator() {
    LocalValidatorFactoryBean factoryBean = new LocalValidatorFactoryBean();
    factoryBean.setProviderClass(HibernateValidator.class);
    factoryBean.afterPropertiesSet();
    return factoryBean.getValidator();
}

@Autowired
private Validator validator;
//然后进行校验，默认分组下可以使用Default.class分组
validator.validate(videoNetInfo, IGroup.class);

• 自定义

public class ValidationUtils {
		//创建一个校验器
    private final static Validator validator = Validation.buildDefaultValidatorFactory().getValidator();

    public static  void validate(T t) {
        validate(t,Default.class);
    }
    public static  void validate(T t,Class clazz) {
        if (t != null) {
            Set<ConstraintViolation> validationSet = validator.validate(t, clazz);
            if (validationSet != null && validationSet.size() > 0) {
                ConstraintViolation violation = validationSet.iterator().next();
                String errorMsg = "[" + violation.getPropertyPath() + "]" + violation.getMessage();
                throw new BusinessException(BusiOpportunityEnum.BUSI_OPPORTUNITY_ENUM_99.getCode(), errorMsg);
            }
        }
    }
}

备注：
org.hibernate.validator.internal.metadata.core.ConstraintHelper