使用@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
总结:
注意注解引用的包不一样
@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
}
使用心得：
简化了大量的属性判断操作，代码看起来更简洁易懂
