一、基本使用
Javax.validation是spring集成自带的一个参数校验接口。可通过添加注解来设置校验条件。
下面以springboot项目为例进行说明。创建web项目后,不需要再添加其他的依赖;
1、 被校验参数
public class User {
private Long id;
@NotBlank(message = "用户名不能为空")
private String name;
@NotBlank(message = "手机号不能为空")
private String phone;
@NotNull(message = "年龄不能为空")
private Integer age;
}
2、Controller
@RestController
public class TestController { @RequestMapping("/create")
public String createUser(@Valid User user, BindingResult bindingResult){
if (bindingResult.hasErrors()){
return bindingResult.getFieldError().getDefaultMessage();
}
return "success";
}
}
3、启动服务,然后在本地请求,如果请求参数不对,即可看到我们给出的错误信息
二、所有原生可用的注解
@NotBlank 元素不能为null,且不能全是空格,用于校验字符串;
@NotEmpty 元素不能为null,且不能为空,用于校验集合类型数据;
@NotNull 元素不能为null,所有类型的数据都可以校验;
@Null 元素必须为null, 所有类型的数据都可以校验;
@Size(min = 1, max = 5) 元素长度介于给定值之前(包含边界),用于校验集合类型数据(包含字符串),;
@Future 元素为时间,且是将来的时间;
@FutureOrPresent 元素为时间,且是现在或将来的时间;
@Past 元素为时间,且是已经过去的时间;
@PastOrPresent 元素为时间,且是现在或已经过去的时间;
@Max(value = 2) 元素值不大于给定值value,可校验所有Number类型数据(除了double和float);;
@Min(value = 1) 元素值不小于给定值value,可校验所有Number类型数据(除了double和float);;
@Negative 元素值为负数,可校验所有Number类型数据;;
@NegativeOrZero 元素值为负数或0,可校验所有Number类型数据;;
@Positive 元素值为正数,可校验所有Number类型数据;;
@PositiveOrZero 元素值为正数或0,可校验所有Number类型数据;;
@DecimalMax(inclusive = true, value = "3.2") 元素值不大于给定值value, inclusive默认是true,可不填,可校验所有Number类型数据(除了double和float);
@DecimalMin(inclusive = false, value = "23") 元素值大于给定值value, inclusive默认是true,可不填,可校验所有Number类型数据(除了double和float);
@Digits(integer = 5, fraction = 7) 元素为数字,且最大长度不超过7位,整数部分最高位不超过5位;
@AssertFalse 元素的值必须为false,用于校验布尔类型元素;
@AssertTrue 元素的值必须为true,用于校验布尔类型元素;
@Email 邮箱名格式校验
注:除了前4个外,其他所有的null会被当作有效处理;
三、自定义校验注解
1、定义注解
@Target({ElementType.FIELD, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = NameValidator.class)
public @interface NameA { String message() default "这个名字不是以a开头";
Class<?>[] groups() default {};
Class<? extends Payload>[] payload() default {};
}
注意定义时message(),groups(),payload()这三个方法必需要定义,其他的就可以自己增加了;
2、定义校验方法;
public class NameValidator implements ConstraintValidator<NameA, String> { private String reg = "[a,]\\w+";
private Pattern pattern = Pattern.compile(reg); @Override
public void initialize(NameA name){ } @Override
public boolean isValid(String name, ConstraintValidatorContext context){
if (name == null){
return false;
}
return pattern.matcher(name).matches();
}
}