前端后端进行交互时,前端上送的参数校验,简单的通过注解实现,方便快捷,而不需要再次开发代码逻辑;
1,参数校验的前提是controller层的方法里需使用@Valid开启校验
@PostMapping("/test")
public String Test(@Valid @RequestBody Student stu) {
return "OK";
}
2,用于校验的注解
注解 | 说明 |
---|---|
空检查 | |
@Null | 验证对象是否为null |
@NotNull | 验证对象是否不为null, 无法查检长度为0的字符串 |
@NotBlank | 检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格.(只能使用在字符串的校验上 ) |
@NotEmpty | 检查约束元素是否为NULL或者是EMPTY. |
Booelan检查 | |
@AssertTrue | 验证 Boolean 对象是否为 true |
@AssertFalse | 验证 Boolean 对象是否为 false |
长度检查 | |
@Size(min=, max=) | 验证对象(Array,Collection,Map,String)长度是否在给定的范围之内 |
@Length(min=, max=) | 一般用于校验字符串的长度 |
日期检查 | |
@Past | 验证 Date 和 Calendar 对象是否在当前时间之前 |
@Future | 验证 Date 和 Calendar 对象是否在当前时间之后 |
数值检查 | |
@Min | 验证 Number 和 String 对象是否大等于指定的值 |
@Max | 验证 Number 和 String 对象是否小等于指定的值 |
@DecimalMax | 被标注的值必须不大于约束中指定的最大值. 这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度 |
@DecimalMin | 被标注的值必须不小于约束中指定的最小值. 这个约束的参数是一个通过BigDecimal定义的最小值的字符串表示.小数存在精度 |
@Digits | 验证 Number 和 String 的构成是否合法 |
@Digits(integer=,fraction=) | 验证字符串是否是符合指定格式的数字,interger指定整数精度,fraction指定小数精度。 |
@Range(min=, max=,message=“range.bean.wage”) | Checks whether the annotated value lies between (inclusive) the specified minimum and maximum. |
其他 | |
@Pattern | 验证 String 对象是否符合正则表达式的规则 |
@CreditCardNumber | 信用卡验证 |
验证是否是邮件地址,如果为null,不进行验证,算通过验证。 | |
@ScriptAssert(lang= ,script=, alias=) | |
@URL(protocol=,host=, port=,regexp=, flags=) |
3.简单运用
@Data
public class order {
/**
* 订单号
*/
@NotBlank
@Length(min = 1, max = 32)
private String orderNo;
/**
* 价格
*/
@NotNull
@DecimalMin(value = "0.01") //最小值0.01
@Digits(integer=6,fraction=2)//精度校验,精度超过百分位就会校验不通过
private BigDecimal price;
/**
* 商品数量
*/
@Min(value = 1) //最小值唯一,如果传小数不会报错,会转型为整数
private Integer goodsNum;
}