SpringBoot中使用JR303校验

参考资料：

https://blog.csdn.net/weixin_37199234/article/details/107253433

https://www.csdn.net/tags/NtTaUg0sMTA0NjMtYmxvZwO0O0OO0O0O.html

• SpringBoot中使用JR303校验
• • 普通校验
  • 分组校验
  • 自定义校验
  • 校验结果收集
  • 注意
  • 常见注解

1. SpringBoot2.3.0以后版本没有引入javax.validation，需要手动引入

    org.springframework.boot
    spring-boot-starter-validation

1. entity层类参数上标注校验注解，并自定义message信息

@NotBlank(message = "品牌名必须提交")
private String name;

1. controller层接收参数时，标注注解@Valid开启校验功能。

// BindingResult中封装了校验结果，必须紧跟@Valid
@RequestMapping("/save")
public R save(@Valid @RequestBody BrandEntity brand) {
    brandService.save(brand);
    return R.ok();
}

1. 统一异常处理（可选统一处理校验结果）

@Slf4j
@RestControllerAdvice(basePackages = "com.liu.gulimall.product.controller")
public class ProductControllerAdvice {

    @ExceptionHandler(value = MethodArgumentNotValidException.class)
    public R handleValidException(MethodArgumentNotValidException e) {
        log.error("提交数据校验异常{}", e.getMessage());
        BindingResult result = e.getBindingResult();
        Map errorMap = new HashMap<>();
        result.getFieldErrors().forEach((item) -> {
            String message = item.getDefaultMessage();
            String field = item.getField();
            errorMap.put(field, message);
        });
        return R.error(BizCodeEnume.VAILD_EXCEPTION.getCode(), BizCodeEnume.VAILD_EXCEPTION.getMsg()).put("data", errorMap);
    }

    @ExceptionHandler(value = Throwable.class)
    public R handleValidException(Throwable throwable) {
        return R.error(BizCodeEnume.UNKNOW_EXCEPTION.getCode(), BizCodeEnume.UNKNOW_EXCEPTION.getMsg());
    }
}

可以针对不同操作url传来的行为进行分组，比如update传来的需要进行非空校验，save传来的可以不进行非空校验

1. 新建分组接口（只写interface，不用写实现）

public interface AddGroup {
}
public interface UpdateGroup {
}

1. 普通校验注解上加groups属性

@NotBlank(message = "品牌名不能为空", groups = {AddGroup.class, UpdateGroup.class})
private String name;

1. 在controller上使用@Validated注解，绑定request和分组接口的关系。这样来的request，就会自动进行相应分组校验

@RequestMapping("/save")
public R save(@Validated({AddGroup.class}) @RequestBody BrandEntity brand) 

1. 编写自定义校验注解

@Documented
@Constraint(validatedBy = { })
@Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
@Retention(RUNTIME)
public @interface ListValue {
	// 必备
    String message() default "{com.liu.common.valid.ListValue.message}";
	// 必备
    Class[] groups() default {};
	// 必备
    Class[] payload() default {};
	// 写明白传入什么值
    int[] vals() default {};
}

1. 在resource中，创建ValidationMessages.properties，并添加错误信息

com.liu.common.valid.ListValue.message = 必须提交指定值

1. 编写自定义校验器

// 实现ConstraintValidator接口，第一个泛型为注释类，第二个泛型为注释标注在什么类型上面
public class ListValueConstraintValidator implements ConstraintValidator {

    private Set set = new HashSet<>();
    
    @Override
    public void initialize(ListValue constraintAnnotation) {
//        ConstraintValidator.super.initialize(constraintAnnotation);
        int[] vals = constraintAnnotation.vals();
        for (int val : vals) {
            set.add(val);
        }
    }

    
    @Override
    public boolean isValid(Integer value, ConstraintValidatorContext context) {
        return set.contains(value);
    }
}

1. 在Constraint中，关联自定义校验注解和校验器（可关联多个）

@Documented
@Constraint(validatedBy = {ListValueConstraintValidator.class})
@Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
@Retention(RUNTIME)
public @interface ListValue {

1. 通过BindingResult收集entity的message

// BindingResult中封装了校验结果，必须紧跟@Valid
@RequestMapping("/save")
public R save(@Valid @RequestBody BrandEntity brand, BindingResult result) {
    brandService.save(brand);
    return R.ok();
}

1. 设置统一的ControllerAdvice处理异常

@Slf4j
@RestControllerAdvice(basePackages = "com.liu.gulimall.product.controller")
public class ProductControllerAdvice {

    @ExceptionHandler(value = MethodArgumentNotValidException.class)
    public R handleValidException(MethodArgumentNotValidException e) {
        log.error("提交数据校验异常{}", e.getMessage());
        BindingResult result = e.getBindingResult();
        Map errorMap = new HashMap<>();
        result.getFieldErrors().forEach((item) -> {
            String message = item.getDefaultMessage();
            String field = item.getField();
            errorMap.put(field, message);
        });
        return R.error(BizCodeEnume.VAILD_EXCEPTION.getCode(), BizCodeEnume.VAILD_EXCEPTION.getMsg()).put("data", errorMap);
    }

    @ExceptionHandler(value = Throwable.class)
    public R handleValidException(Throwable throwable) {
        log.error("错误内容", throwable);
        return R.error(BizCodeEnume.UNKNOW_EXCEPTION.getCode(), BizCodeEnume.UNKNOW_EXCEPTION.getMsg());
    }
}

1. @Valid和@Validated注解一定要加在controller接受的bean参数前面，不能加在方法上
2. 在分组校验中，如果有entity的参数注释没有添加groups分组属性，那分组校验此参数校验不生效。比如：

// entity属性
@NotNull(message = "修改必须指定品牌id", groups = {UpdateGroup.class})
@Null(message = "新增不能指定id", groups = {AddGroup.class})
@TableId
private Long brandId;

@NotNull(message = "显示状态不能为空")
private Integer showStatus;

// controller方法只会检验brandId，不会检验showStatus
@RequestMapping("/save")
@Validated({AddGroup.class})
public R save( @RequestBody BrandEntity brand)