BindingResult一般用在实体类校验时的结果的绑定。
@Null 被注释的元素必须为null
@NotNull 被注释的元素不能为null
@AssertTrue 该字段只能为true
@AssertFalse 该字段的值只能为false
@Min(value) 被注释的元素必须是一个数字,其值必须大于等于指定的最小值
@Max(value) 被注释的元素必须是一个数字,其值必须小于等于指定的最大值
@DecimalMin("value") 被注释的元素必须是一个数字,验证小数的最小值
@DecimalMax("value") 被注释的元素必须是一个数字,验证小数的最大值
@Size(max,min) 查该字段的size是否在min和max之间,可以是字符串、数组、集合、Map等
@Digits(integer,fraction) 检查是否是一种数字的整数、分数,小数位数的数字
@Past 被注释的元素必须是一个过去的日期
@Future 被注释的元素必须是一个将来的日期
@Pattern(regexp = "[abc]") 被注释的元素必须符合指定的正则表达式。
@Email 被注释的元素必须是电子邮件地址
@Length(max=5,min=1,message="长度在1~5") 检查所属的字段的长度是否在min和max之间,只能用于字符串
@NotEmpty 被注释的字符串必须非空
@Range 被注释的元素必须在合适的范围内
@CreditCardNumber 对信用卡号进行一个大致的验证
@NotBlank 不能为空,检查时会将空格忽略
@NotEmpty 不能为空,这里的空是指空字符串
实体类加上校验注释后,controller层可以在参数列表中加
(@Valid 参数, BindingResult bindingResult)
通过bindingResult可以获取参数的校验结果 判断是否符合约束。
举个例子: 搬运来的
实体类
@ApiModel(value ="TestEntity")
public class TestEntity implements Serializable{
private static final long serialVersionUID = 1L;
@ApiModelProperty(value = "唯一id")
private Long id;
@Size(max=10,message="最大长度为10")
@ApiModelProperty(value = "名称")
private String name;
@NotNull(message="参数不能为空")
@ApiModelProperty(value = "年龄")
private Integer age;
}
controller:
public class TestController {
@PostMapping("/a")
@ApiOperation(value = "测试", notes = "")
public void test(@RequestBody @Valid TestEntity test,BindingResult bindingResult) {
System.out.println(test.toString());
if (bindingResult.hasErrors()) {
throw new 自定义Exception("错误提示码",bindingResult.getFieldError().getDefaultMessage());
}
}
@Valid和BindingResult配套使用,@Valid用在参数前,BindingResult作为校验结果绑定返回。
bindingResult.hasErrors()判断是否校验通过,校验未通过,bindingResult.getFieldError().getDefaultMessage()获取在TestEntity的属性设置的自定义message,如果没有设置,则返回默认值"javax.validation.constraints.XXX.message"。
在实体类使用校验注解时,controller一定要使用bindingResult处理校验结果,且实体类作为查询参数时,避免被其他方法使用,不然有的地方需要限制,有的没有,不需要限制的方法会报错