使用@Valid+BindingResult进行controller参数校验

使用@Valid+BindingResult进行controller参数校验

@Valid

@Valid注解用于校验,所属的包: javax.validation.Valid.

你可以定义实体,在实体的属性上添加校验规则,在API接收数据时添加@Valid注解,这时你的实体将会开启一个校验的功能。

@Valid 注解类型的使用:

空检查

@NotEmpty:用在集合类上面;不能为null,而且长度必须大于0

@NotBlank:用在String上面;只能作用在String上,不能为null,而且调用trim()后,长度必须大于0

@NotNull:用在基本类型上;不能为null,但可以为empty。

@Null: 只能是null

总结:

  1. 注意注解引用的包不一样

  2. @NotEmpty 用在集合类上面     
    ​ @NotBlank 用在String上面    
    ​ @NotNull 用在基本类型上

字符串/数组/集合检查:(字符串本身就是个数组)

@Pattern(regexp="reg") 验证字符串满足正则

@Size(max, min) 验证字符串、数组、集合长度范围

@NotEmpty 验证字符串不为空或者null

@NotBlank 验证字符串不为null或者trim()后不为空

长度检查

@Size(min=,max=):验证对象(Array,Collection,Map,String)长度是否在给定的范围之内
不要错用了异常类型,比如在int上不可用@size @Length(min=, max=) : 只适用于String 类型

Booelan检查

@AssertTrue: 验证 Boolean 对象是否为 true
@AssertFalse: 验证 Boolean 对象是否为 false

日期检查: Date/Calendar

@Past: 验证 Date 和 Calendar 对象是否在当前时间之前

@Future: 验证 Date 和 Calendar 对象是否在当前时间之后

@Pattern: 验证 String 对象是否符合正则表达式的规则

数值检查

建议使用在Stirng,Integer类型,不建议使用在int类型上,因为表单值为""时无法转换为int,但可以转换为Stirng为"",Integer为null

@Min: 验证 Number 和 String对象是否大等于指定的值

@Max: 验证 Number 和 String 对象是否小等于指定的值

@@DecimalMax("10.8") : 被标注的值必须不大于约束中指定的最大值. 这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度

@DecimalMin: 被标注的值必须不小于约束中指定的最小值.这个约束的参数是一个通 过BigDecimal定义的最小值的字符串表示.小数存在精度

@Digits: 验证 Number 和 String的构成是否合法

@Digits(integer=,fraction=): 验证字符串是否是符合指定格式的数字,interger指定整数精度,fraction指定小数精度。

其他验证:

@Vaild 递归验证,用于对象、数组和集合,会对对象的元素、数组的元素进行一一校验

@Email 用于验证一个字符串是否是一个合法的右键地址,空字符串或null算验证通过

@URL(protocol=,host=,port=,regexp=,flags=) 用于校验一个字符串是否是合法UR

BindingResult

Spring验证的错误返回 ·····> BindingResult

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

项目使用中遇到的问题:

一开始传入的参数没有使用@Valid 修饰,结果绑定不起作用,参数校验不成功,加上此注解即可生效。
所以BingdingResult是要与@Valid同时使用的。

项目中具体使用如下:

controller中:

@ApiOperation("添加角色")
@RequestMapping(value = "/create", method = RequestMethod.POST)
@ResponseBody
public CommonResult create(@Valid @RequestBody UmsRole role, BindingResult bindingResult ) {
    int count = roleService.create(role);
    if (count > 0) {
        return CommonResult.success(count);
    }
    return CommonResult.failed();
}

domain中:

import io.swagger.annotations.ApiModelProperty;

import javax.validation.constraints.NotEmpty;
import java.io.Serializable;
import java.util.Date;
@Data
public class UmsRole implements Serializable {
    private Long id;

    @ApiModelProperty(value = "名称")
    @NotEmpty(message = "name不能为空!")
    private String name;

    @ApiModelProperty(value = "描述")
    @NotEmpty(message = "描述不能为空!")
    private String description;

    @ApiModelProperty(value = "后台用户数量")
    private Integer adminCount;

    @ApiModelProperty(value = "创建时间")
    private Date createTime;

    @ApiModelProperty(value = "启用状态:0->禁用;1->启用")
    private Integer status;

    private Integer sort;

    private static final long serialVersionUID = 1L;

调用接口返回效果:
参数:

{
	"name":"test"
}

返回值:

{
    "code": 404,
    "message": "描述不能为空!",
    "data": null
}

使用心得:

简化了大量的属性判断操作,代码看起来更简洁易懂

原文地址:https://www.cnblogs.com/zzl2019/p/13985612.html