1、常用注解
@NotNull使用在Bean的字段注解中。它是 JSR303(Bean的校验框架)的注解,在controller的方法中验证时(运行时检查一个属性是否为空)使用,如果不合法(为空),注解中的提示信息会保存在result中。
- @Null 被注释的元素必须为null
- @NotNull 被注释的元素不能为null,可以为空字符串
- @AssertTrue 被注释的元素必须为true
- @AssertFalse 被注释的元素必须为false
- @Min(value) 被注释的元素必须是一个数字,其值必须大于等于指定的最小值
- @Max(value) 被注释的元素必须是一个数字,其值必须小于等于指定的最大值
- @DecimalMin(value) 被注释的元素必须是一个数字,其值必须大于等于指定的最小值
- @DecimalMax(value) 被注释的元素必须是一个数字,其值必须小于等于指定的最大值
- @Size(max,min) 被注释的元素的大小必须在指定的范围内。
- @Digits(integer,fraction) 被注释的元素必须是一个数字,其值必须在可接受的范围内
- @Past 被注释的元素必须是一个过去的日期
- @Future 被注释的元素必须是一个将来的日期
- @Pattern(value) 被注释的元素必须符合指定的正则表达式。
- @Email 被注释的元素必须是电子邮件地址
- @Length 被注释的字符串的大小必须在指定的范围内
- @Range 被注释的元素必须在合适的范围内
- @NotEmpty:用在集合类上,不能为null,并且长度必须大于0
- @NotBlank:只能作用在String上,不能为null,而且调用trim()后,长度必须大于0
2、案例
@Getter
@Setter
public class UserValid implements Serializable {
@NotNull(message = "id不能为空")
private Long id;
@NotNull(message = "date不能为空")
@DateTimeFormat(pattern = "yyyy-MM-dd")
@Future(message = "只能是将来的日期")
private Date date;
@NotNull
@DecimalMax(value = "10000.0")
@DecimalMin(value = "1.0")
private Double doubleValue = null;
@NotNull
@Max(value = 100, message = "最大值")
@Min(value = 1, message = "最小值")
private Integer integer;
@Range(min = 1,max = 100,message = "范围")
private Long range;
@Email(message = "邮箱格式错误")
private String email;
@Size(min = 2,max = 10,message = "字符串长度在2-10")
private String size;
}
@RestController
public class TestController {
@RequestMapping("validate/valid")
@ResponseBody
public Map<String,Object> valid(@Valid @RequestBody UserValid userValid, Errors errors){
Map<String, Object> errMap = Maps.newHashMap();
List<ObjectError> allErrors = errors.getAllErrors();
for (ObjectError oe:allErrors){
String key;
String msg;
if(oe instanceof FieldError){
FieldError fe = (FieldError)oe;
key = fe.getField();// 获取错误验证字段名
} else {
// 非字段错误
key = oe.getObjectName();// 获取验证对象名称
}
// 错误信息
msg = oe.getDefaultMessage();
errMap.put(key, msg);
}
return errMap;
}
}