SprintBoot使用Validation的原因和用法

本篇内容介绍了“SprintBoot使用Validation的原因和用法”的有关知识,在实际案例的操作过程中,不少人都会遇到这样的困境,接下来就让小编带领大家学习一下如何处理这些情况吧!希望大家仔细阅读,能够学有所成!

创新互联公司是一家从事企业网站建设、网站设计制作、网站设计、行业门户网站建设、网页设计制作的专业网站制作公司,拥有经验丰富的网站建设工程师和网页设计人员,具备各种规模与类型网站建设的实力,在网站建设领域树立了自己独特的设计风格。自公司成立以来曾独立设计制作的站点上千。

1、为什么要使用Validation

在开发过程中有没有使用一堆的if来判断字段是否为空、电话号码是否正确、某个输入是否符合长度等对字段的判断。这样的代码可读性差,而且还不美观,那么使用Validation就可以完美解决这个问题。

2、使用Validation

  • 引入validation依赖


    org.springframework.boot
    spring-boot-starter-validation
  • 在需要校验的实体类添加注解

@Data
public class User {
    private String id;
    @NotNull(message = "姓名不能为空")
    private String name;
}
  • 在Controller类的方法入参增加@Valid

@PostMapping(path = "")
public RestResponse save(@Valid @RequestBody User user){
    return ResponseFactory.getOkResponse();
}
  • 使用全局异常处理异常信息

全局异常处理在上一篇文章有介绍到,具体怎么使用可以参考:SpringBoot全局异常处理

@ExceptionHandler(MethodArgumentNotValidException.class)
    public RestResponse paramExceptionHandler(MethodArgumentNotValidException e) {
        BindingResult bindingResult = e.getBindingResult();
        if (bindingResult.hasErrors()) {
            List objectError = bindingResult.getAllErrors();
            if (!objectError.isEmpty()) {
                return ResponseFactory.getErrorMessage(objectError.stream().map(obj -> {
                    FieldError fieldError = (FieldError) obj;
                    return String.format("%s-%s", fieldError.getField(), fieldError.getDefaultMessage());
                }).collect(Collectors.joining(";")));
            }
        }
        return ResponseFactory.getErrorMessage("参数请求错误!");
    }

3、测试

入参:

{
    "id":"as",
    "name":null
}

出参:

{
    "code": "1",
    "message": "name-姓名不能为空",
    "data": null
}

从出参可以看出,验证已经生效。这里需要注意的是,如果实体类中嵌套了实体类,需要在嵌套的类上加@Valid才会对嵌套的实体类校验。

@Data
public class User {
    private String id;
    @NotNull(message = "姓名不能为空")
    private String name;
    @NotNull(message = "地址信息不能为空!")
    private Address address;
}

@Data
public class Address {
    private String id;
    @NotEmpty(message = "省份不能为空!")
    private String province;
}

如上只是在address上面加了非空校验,在Address类中的province添加了非空校验,如果不再address@Valid,入参不传入address信息,如下:

入参:
{
    "id":"as",
    "name":null
}
出参:
{
    "code": "1",
    "message": "name-姓名不能为空;address-地址信息不能为空!",
    "data": null
}

入参加上address的空信息,入参出参如下:

入参:
{
    "id":"as",
    "name":null,
    "address":{
        
    }
}
出参:
{
    "code": "1",
    "message": "name-姓名不能为空",
    "data": null
}

可以看出在address上不加@Valid注解,对嵌套类的校验是不生效的,接下来@Valid注解加上看下结果:

@Data
public class User {
    private String id;
    @NotNull(message = "姓名不能为空")
    private String name;
    @NotNull(message = "地址信息不能为空!")
    @Valid
    private Address address;
}

入参不变,出参如下:

{
    "code": "1",
    "message": "address.province-省份不能为空!;name-姓名不能为空",
    "data": null
}

从结果可以看出,嵌套类中的校验已经生效。 上面的示例只用到了@NotNull@NotEmpty注解,还有一些常用的注解,这里就不一一演示了,可以自己测试下。下面贴出一些常用校验注解: |注解| 作用| |:--|:--| |@NotNull| 值不能为空| |@Null |值必须为空| |@Pattern(regex=) |字符串必须匹配正则表达式 |@Size(min, max)| 集合或者数组元素的数量必须在min和max之间 |@CreditCardNumber(ignoreNonDigitCharacters=)| 字符串必须是信用卡号,按找美国的标准验证 |@Email |字符串必须是Email地址 |@Length(min, max)| 检查字符串的长度 |@NotBlank| 字符串不能为空串 |@NotEmpty| 字符串不能为null, 集合或者数组的 size 不能为空 |@Range(min, max)| 数字必须大于min, 小于max |@SafeHtml |字符串必须是安全的html |@URL| 字符串必须是合法的URL |@AssertFalse| 值必须是false |@AssertTrue |值必须是true |@DecimalMax(value=, inclusive=) |值必须小于等于(inclusive=true)/小于(inclusive=false)属性指定的值,也可以注释在字符串类型的属性上。 |@DecimalMin(value=, inclusive=) |值必须大于等于(inclusive=true)/小于(inclusive=false)属性指定的值,也可以注释在字符串类型的属性上。 |@Digist(integer=,fraction=) |数字格式检查。integer指定整数部分的最大长度,fraction指定小数部分的最大长度 |@Future |时间必须是未来的 |@Past| 事件必须是过去的 |@Max(value=)| 值必须小于等于value指定的值。不能注解在字符串类型属性上。 |@Min(value=) |值必须小于等于value指定的值。不能注解在字符串类型属性上。

“SprintBoot使用Validation的原因和用法”的内容就介绍到这里了,感谢大家的阅读。如果想了解更多行业相关的知识可以关注创新互联网站,小编将为大家输出更多高质量的实用文章!


分享文章:SprintBoot使用Validation的原因和用法
URL链接:http://hbruida.cn/article/ggjesc.html