JSR-303校验 @Valid, @Validated
空检查
- @Null 验证对象是否为null
- @NotNull 验证对象是否不为null, 无法查检长度为0的字符串
- @NotBlank 检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格
- @NotEmpty 检查约束元素是否为NULL或者是EMPTY.
==@NotNull是通过 null来判断
@NotEmpty是通过 .size()= =0和.length()= =0判断
@NotBlank是通过 .trim().length()= =0判断 按照实际的需求来使用
Booelan检查
- @AssertTrue 验证 Boolean 对象是否为 true
- @AssertFalse 验证 Boolean 对象是否为 false
长度检查
- @Size(min=, max=) 验证对象(Array,Collection,Map,String)长度是否在给定的范围之内
- @Length(min=, max=) Validates that the annotated string is between min and max included.
日期检查
- @Past 验证 Date 和 Calendar 对象是否在当前时间之前
- @Future 验证 Date 和 Calendar 对象是否在当前时间之后
- @Pattern 验证 String 对象是否符合正则表达式的规则
数值检查
建议使用在Stirng,Integer类型,不建议使用在int类型上,因为表单值为“”时无法转换为int,但可以转换为Stirng为"",Integer为null
-
@Min 验证 Number 和 String 对象是否大等于指定的值
-
@Max 验证 Number 和 String 对象是否小等于指定的值
-
@DecimalMax 被标注的值必须不大于约束中指定的最大值. 这个约束的参数是一个通过BigDecimal定义的最大值的字符串表示.小数存在精度
-
@DecimalMin 被标注的值必须不小于约束中指定的最小值. 这个约束的参数是一个通过BigDecimal定义的最小值的字符串表示.小数存在精度
-
@Digits 验证 Number 和 String 的构成是否合法
-
@Digits(integer=,fraction=) 验证字符串是否是符合指定格式的数字,interger指定整数精度,fraction指定小数精度。
-
@Range(min=, max=) 检查数字是否介于min和max之间.
-
@Range(min=10000,max=50000,message=“range.bean.wage”)
private BigDecimal wage; -
@Valid 递归的对关联对象进行校验, 如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个map,则对其中的值部分进行校验.(是否进行递归验证)
-
@CreditCardNumber信用卡验证
-
@Email 验证是否是邮件地址,如果为null,不进行验证,算通过验证。
-
@ScriptAssert(lang= ,script=, alias=)
-
@URL(protocol=,host=, port=,regexp=, flags=)
简单举例
public class UserInfo {
@NotBlank(message = "姓名不能为空")
private String username;
// @NotEmpty(message = "密码不能为空")
@Length(min = 6, max = 10, message = "密码长度只能在6-10之间")
private String password;
@Min(value = 18, message = "年龄最小为18")
@Max(value = 60, message = "年龄最大为60")
int age;
@AssertTrue(message = "必须同意条款")
boolean agree;
}
@ResponseBody
@GetMapping("validate")
public Map<String, String> validate(@Valid UserInfo userInfo, BindingResult result){
Map<String, String> map = new HashMap<String, String>();
if (result.hasErrors()) {
List<ObjectError> list = result.getAllErrors();
for (ObjectError error :
list) {
FieldError fieldError = (FieldError)error;
String defaultMessage = fieldError.getDefaultMessage();
String field = fieldError.getField();
map.put(field, defaultMessage);
}
}
return map;
}
@Validated
@Valid是javax.validation里的。
@Validated是@Valid 的一次封装,是Spring提供的校验机制使用。@Valid不提供分组功能
特殊用法:
- 分组: 当一个实体类需要多种验证方式时,例:对于一个实体类的id来说,新增的时候是不需要的,对于更新时是必须的, 可以通过groups对验证进行分组
public interface AllFiled {
}
public interface First {
}
public interface Secend {
}
public class UserInfo {
private Integer uid;
@NotBlank(message = "姓名不能为空", groups = {First.class, AllFiled.class})
private String username;
@NotEmpty(message = "密码不能为空", groups = {AllFiled.class})
@Length(min = 6, max = 10, message = "密码长度只能在6-10之间", groups = {AllFiled.class})
private String password;
//临时加的字段
@Min(value = 18, message = "年龄最小为18", groups = {AllFiled.class})
@Max(value = 60, message = "年龄最大为60", groups = {AllFiled.class})
int age;
//临时加的字段
@AssertTrue(message = "必须同意条款", groups = {Secend.class, AllFiled.class})
boolean agree;
}
@ResponseBody
@GetMapping("validate")
public Map<String, String> validate(@Validated({AllFiled.class}) UserInfo userInfo, BindingResult result){
Map<String, String> map = new HashMap<String, String>();
if (result.hasErrors()) {
List<ObjectError> list = result.getAllErrors();
for (ObjectError error :
list) {
FieldError fieldError = (FieldError)error;
String defaultMessage = fieldError.getDefaultMessage();
String field = fieldError.getField();
map.put(field, defaultMessage);
}
}
return map;
}
}
当@Validated分组为空时, 只会验证没有分组的属性, 如上面的uid;
当@Validated{First.class}时, 只会验证分组为First.class的字段, 对于其他分组字段和未分组字段都为空