Bean Validator

一、jdk内置标签

Bean Validation 中内置的 constraint：
@Null 被注释的元素必须为 null
@NotNull 被注释的元素必须不为 null
@AssertTrue 被注释的元素必须为 true
@AssertFalse 被注释的元素必须为 false
@Min(value) 被注释的元素必须是一个数字，其值必须大于等于指定的最小值
@Max(value) 被注释的元素必须是一个数字，其值必须小于等于指定的最大值
@DecimalMin(value) 被注释的元素必须是一个数字，其值必须大于等于指定的最小值
@DecimalMax(value) 被注释的元素必须是一个数字，其值必须小于等于指定的最大值
@Size(max=, min=) 被注释的元素的大小必须在指定的范围内
@Digits (integer, fraction) 被注释的元素必须是一个数字，其值必须在可接受的范围内
@Past 被注释的元素必须是一个过去的日期
@Future 被注释的元素必须是一个将来的日期
@Pattern(regex=,flag=) 被注释的元素必须符合指定的正则表达式
Hibernate Validator 附加的 constraint
@NotBlank(message =) 验证字符串非null，且长度必须大于0
@Email 被注释的元素必须是电子邮箱地址
@Length(min=,max=) 被注释的字符串的大小必须在指定的范围内
@NotEmpty 被注释的字符串必须非空
@Range(min=,max=,message=) 被注释的元素必须在合适的范围内

同时，还可以使用hibernate扩展的validator标签：

使用样例：

public class UserVo{//大于0.01，不包含0.01
@NotNull
@DecimalMin(value = "0.01", inclusive = false)
private Integer greaterThan;//大于等于0.01
@NotNull
@DecimalMin(value = "0.01", inclusive = true)
private BigDecimal greatOrEqualThan;@NotEmpty(message = "message不能为空")
@Length(min = 1, max = 20, message = "message不能为空")
//不能将Length错用成Range
//@Range(min = 1, max = 20, message = "message不能为空")
private String message;
}

二、集成spring boot

spring-boot-starter-web已经默认帮我们声明、集成了validation-api和hibernate-validator，所以引入spring-boot-starter-web即可。
1、pom配置：

<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId>#如果parent为spring-boot-starter-parent，那version可以省略#<version>${latest.version}</version>
</dependency>

2、校验模式配置：

@Configuration
public class ValidatorConfiguration {@Beanpublic Validator validator(){ValidatorFactory validatorFactory = Validation.byProvider( HibernateValidator.class ).configure()//false：普通模式(会校验完所有的属性，然后返回所有的验证失败信息)//true：快速失败返回模式(只要有一个验证失败，则返回).failFast( true ).buildValidatorFactory();Validator validator = validatorFactory.getValidator();return validator;}
}

3、定义统一异常处理：

@ControllerAdvice
public class ExceptionAspect {/*** 统一处理入参异常 MethodArgumentNotValidException* @param e* @return*/@ResponseBody@ExceptionHandler(MethodArgumentNotValidException.class)public BaseResponseVo methodArgumentNotValidExceptionHandler(MethodArgumentNotValidException e) {List<String> errorInformation = e.getBindingResult().getAllErrors().stream().map(ObjectError::getDefaultMessage).collect(Collectors.toList());return BaseResponseVo.builder().code(BaseConstant.INVALID_PARAMETER_CODE).message(errorInformation.toString()).build();}
}

4、业务校验：

@PostMapping("/something")
public void doSomething(@RequestBody @Valid UserVo uservo) {//do somethig
}

三、特殊场景

1、联级校验

当某个vo对象中又嵌套另一个vo对象时，如果想要同时校验两个vo，就需要使用联级校验，方式为在属性vo上添加@Valid即可：

@Data
public class Demo2 {@Size(min = 3,max = 5,message = "list的Size在[3,5]")private List<String> list;@NotNull@Validprivate Demo3 demo3;@Datapublic static class Demo3 {@Length(min = 5, max = 17, message = "length长度在[5,17]之间")private String extField;}
}

2、分组校验

有这样一种场景，我们定义了一个统一的requestVo，新增用户信息的时候，不需要验证userId（因为系统生成）；修改的时候需要验证userId，此时就可以使用到validator的分组验证功能。如下：

定义分组场景：

/*** 插入校验分组*/
public interface InsertValidatorGroup {}/*** 列表查询校验分组*/
public interface ListValidatorGroup {}/*** 单体查询校验分组*/
public interface QueryValidatorGroup {}/*** 更新校验分组*/
public interface UpdateValidatorGroup {}/*** 删除校验分组*/
public interface DeleteValidatorGroup {}

配置requestVo的校验：

@Data
public class UserRequestVo {@NotBlank@Range(min = 1,max = Integer.MAX_VALUE,message = "必须大于0",groups = {UpdateValidatorGroup.class,DeleteValidatorGroup.class})/**用户id*/private Integer userId;@NotBlank@Length(min = 4,max = 20,message = "必须在[4,20]",groups = {QueryValidatorGroup.class,UpdateValidatorGroup.class,InsertValidatorGroup.class})/**用户名*/private String userName;@NotBlank@Range(min = 0,max = 100,message = "年龄必须在[0,100]",groups={ListValidatorGroup.class,UpdateValidatorGroup.class,InsertValidatorGroup.class})/**年龄*/private Integer age;@Range(min = 0,max = 2,message = "性别必须在[0,2]",groups = {ListValidatorGroup.class,UpdateValidatorGroup.class,InsertValidatorGroup.class})/**性别 0：未知；1：男；2：女*/private Integer sex;
}

如上UserRequestVo所示，可以根据不同场景设置不同的验证属性。

3.开启验证：
jdk自带的@Valid并不支持group配置，所以需要使用spring的@Validated标签

@RequestMapping("/query")public void query(@RequestBody @Validated({QueryValidatorGroup.class}) UserRequestVo u){}
@RequestMapping("/list")public void list(@RequestBody @Validated({ListValidatorGroup.class}) UserRequestVo u){}
@RequestMapping("/update")public void update(@RequestBody @Validated({UpdateValidatorGroup.class}) UserRequestVo u){}
@RequestMapping("/insert")public void insert(@RequestBody @Validated({UpdateValidatorGroup.class}) UserRequestVo u){}@RequestMapping("/delete")public void delete(@RequestBody @Validated({DeleteValidatorGroup.class}) UserRequestVo u){}

3、序列校验

除了按组指定是否验证之外，还可以指定组的验证顺序，前面组验证不通过的，后面组不进行验证：

配置校验顺序：

@GroupSequence({GroupA.class, GroupB.class, Default.class})
public interface GroupOrder {}

开启验证：

@RequestMapping("/groupOrder")
public void groupOrder(@Validated({GroupOrder.class}) UserRequestVo u){}

四、dubbo集成

在dubbo微服务中，已经可以直接集成validator，无需再使用工具类模式或Filter模式。
1、生产者：

  <dubbo:provider delay="-1" timeout="5000" threads="600" threadpool="fixed" loadbalance="roundrobin" accesslog="true"retries="0" validation="true"/>

2、消费者：

<dubbo:consumer check="false" timeout="60000" retries="0" validation="true"/>