Gulimall学习：v-model、JSR303数据校验BindingResult、统一异常处理

一. v-model的trim、number、lazy

1. v-model.trim
   可以自动过滤输入首尾的空格
2. v-model.number
   只允许输入数值型。将输入转换成Number类型
3. v-model.lazy
   并不是实时改变，而是在失去焦点或者按回车时才会更新

二. JSR303数据校验

1. SpringMVC映射的实体类可以通过添加注解的方式进行数据校验
2. 基本校验注解
   （1）空检查
   @Null 验证对象是否为null
   @NotNull 验证对象是否不为null, 无法查检长度为0的字符串
   @NotBlank 检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格.
   @NotEmpty 检查约束元素是否为NULL或者是EMPTY.
   
   （2）Booelan检查
   @AssertTrue 验证 Boolean 对象是否为 true
   @AssertFalse 验证 Boolean 对象是否为 false
   
   （3）长度检查
   @Size(min=, max=) 验证对象（Array,Collection,Map,String）长度是否在给定的范围之内
   @Length(min=, max=) Validates that the annotated string is between min and max included.
   
   （4）日期检查
   @Past 验证 Date 和 Calendar 对象是否在当前时间之前，验证成立的话被注释的元素一定是一个过去的日期
   @Future 验证 Date 和 Calendar 对象是否在当前时间之后 ，验证成立的话被注释的元素一定是一个将来的日期
   
   （5）数值检查
   建议使用在Stirng,Integer类型，不建议使用在int类型上，因为表单值为“”时无法转换为int，但可以转换为Stirng为”“,Integer为null
   @Min 验证 Number 和 String 对象是否大等于指定的值
   @Max 验证 Number 和 String 对象是否小等于指定的值
   @DecimalMax 被标注的值必须不大于约束中指定的最大值. 这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度
   @DecimalMin 被标注的值必须不小于约束中指定的最小值. 这个约束的参数是一个通过BigDecimal定义的最小值的字符串表示.小数存在精度
   @Digits 验证 Number 和 String 的构成是否合法
   @Digits(integer=,fraction=) 验证字符串是否是符合指定格式的数字，interger指定整数精度，fraction指定小数精度。
   @Range(min=, max=) 被指定的元素必须在合适的范围内
   @Range(min=10000,max=50000,message=”range.bean.wage”)
   @CreditCardNumber信用卡验证
   
   （6）递归校验
   @Valid 递归的对关联对象进行校验,可用于校验嵌套的实体类中的参数。如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个map,则对其中的值部分进行校验.(是否进行递归验证)
   
   （7）Email校验
   @Email 验证是否是邮件地址，如果为null,不进行验证，算通过验证。
   
   （8）URL校验
   @URL(protocol=,host=, port=,regexp=, flags=)
   
   （9）正则表达式匹配
   @Pattern 验证 String 对象是否符合正则表达式的规则，被注释的元素符合制定的正则表达式。regexp:正则表达式 flags: 指定 Pattern.Flag 的数组，表示正则表达式的相关选项。

举例:

注解所属包： javax.validation.Valid.

在使用的时候直接对JavaBean进行注解既可以实现对属性的验证

public class Order {
    // 必须不为 null, 大小是 10
    @NotNull
    @Size(min = 10, max = 10)
    private String orderId;
    // 必须不为空
    @NotEmpty
    private String customer;
    // 必须是一个电子信箱地址
    @Email
    private String email;
    // 必须不为空
    @NotEmpty
    private String address;
    // 必须不为 null, 必须是下面四个字符串'created', 'paid', 'shipped', 'closed'其中之一
    // @Status 是一个定制化的 contraint
    @NotNull
    @Status
    private String status;
    // 必须不为 null
    @NotNull
    private Date createDate;
    // 嵌套验证
    @Valid
    private Product product;
 
   // getter 和setter方法
}

    @NotNull(message = "adultTax不能为空")
    private Integer adultTax;
 
    @NotNull(message = "adultTaxType不能为空")
    @Min(value = 0, message = "adultTaxType 的最小值为0")
    @Max(value = 1, message = "adultTaxType 的最大值为1")
    private Integer adultTaxType;
 
    @NotNull(message = "reason信息不可以为空")
    @Pattern(regexp = "[1-7]{1}", message = "reason的类型值为1-7中的一个类型")
    private String reason;//订单取消原因

三. BindingResult封装的校验错误信息

（1）@Valid 和 BindingResult 是一 一对应的，如果有多个@Valid，那么每个@Valid后面跟着的BindingResult就是这个@Valid的验证结果，顺序不能乱；

（2）BindingResult bindingResult一定要紧跟在@Valid校验的实体类之后

    @RequestMapping(value = "/test1")
    public Result test(@Valid @RequestBody TestVO testVO, BindingResult bindingResult) {
        if (bindingResult.hasErrors()) {
            Map<String, String> map = new HashMap<>();
            bindingResult.getFieldErrors().forEach((item) -> {
                String message = item.getDefaultMessage();
                String field = item.getField();
                map.put(field, message);
            });
            return new Result(400, "非法参数 !", map);
        }
        return new Result(0, "", testVO);
    }

四. 统一异常处理类封装

使用@RestControllerAdvice进行异常处理类的封装，这样，在我们的controller中，就不用再try catch异常，全部由@RestControllerAdvice标注的异常处理类进行处理

@Slf4j
@RestControllerAdvice
public class TestExceptionControllerAdvice {

    /**
     * 参数校验异常
     *
     * @param e
     * @return
     */
    @ExceptionHandler(value = MethodArgumentNotValidException.class)
    public Result handleMethodArgumentNotValidException(MethodArgumentNotValidException e) {
        log.error("参数校验出现问题:{},异常类型:{}", e.getMessage(), e.getClass());
        BindingResult bindingResult = e.getBindingResult();
        Map<String, String> errorMap = new HashMap<>();
        bindingResult.getFieldErrors().forEach(fieldError -> {
            String message = fieldError.getDefaultMessage();
            String field = fieldError.getField();
            errorMap.put(field, message);
        });
        return new Result(ResultInfo.EXCEPTION.getCode(), ResultInfo.EXCEPTION.getMsg(), errorMap);
    }

    /**
     * 处理其它未知异常
     *
     * @param e
     * @return
     */
    @ExceptionHandler(value = Throwable.class)
    public Result handleException(Throwable e) {
        log.error("出现未知异常:{},异常类型:{}", e.getMessage(), e.getClass());
        return new Result(ResultInfo.EXCEPTION.getCode(), ResultInfo.EXCEPTION.getMsg(), "");
    }
}