JSR303校验
一、环境准备
这个pom坐标在自定义注解的时候有用
<dependency>
<groupId>javax.validation</groupId>
<artifactId>validation-api</artifactId>
<version>2.0.1.Final</version>
</dependency>
二、JSR 303 基本的校验规则
1、空检查
@Null 验证对象是否为null
@NotNull 验证对象是否不为null, 无法查检长度为0的字符串
@NotBlank 检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格.
@NotEmpty 检查约束元素是否为NULL或者是EMPTY.
2、Booelan检查
@AssertTrue 验证 Boolean 对象是否为 true
@AssertFalse 验证 Boolean 对象是否为 false
3、长度检查
@Size(min=, max=) 验证对象(Array,Collection,Map,String)长度是否在给定的范围之内
@Length(min=, max=) Validates that the annotated string is between min and max included.
4、日期检查
@Past 验证 Date 和 Calendar 对象是否在当前时间之前,验证成立的话被注释的元素一定是一个过去的日期
@Future 验证 Date 和 Calendar 对象是否在当前时间之后 ,验证成立的话被注释的元素一定是一个将来的日期
@Pattern 验证 String 对象是否符合正则表达式的规则,被注释的元素符合制定的正则表达式,regexp:正则表达式 flags: 指定 Pattern.Flag 的数组,表示正则表达式的相关选项。
5、数值检查
建议使用在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=) 被指定的元素必须在合适的范围内
@Range(min=10000,max=50000,message=”range.bean.wage”)
@Valid 递归的对关联对象进行校验, 如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个map,则对其中的值部分进行校验.(是否进行递归验证)
@CreditCardNumber信用卡验证
@Email 验证是否是邮件地址,如果为null,不进行验证,算通过验证。
@ScriptAssert(lang= ,script=, alias=)
@URL(protocol=,host=, port=,regexp=, flags=)
三、案例
1、写一个java bean
@Data
public class User {
@NotNull(message = "更新时必须携带ID",groups = {UpdateGroup.class})
@Null(message = "插入时不能携带id",groups = {InsertGroup.class})
private Integer id;
@NotEmpty(message = "名字不能为空")
private String name;
@Email(message = "邮箱不能为空")
private String email;
private String phone;
}
2、在controller的参数上加上注解@Valid
controller
@RestController
@Slf4j
public class UserController {
@PostMapping("/jsr303")
public R jsr303Test(@Valid @RequestBody User user){
log.info("参数user:{}",user);
return R.ok() ;
}
}
3、异常处理类
@Slf4j
@RestControllerAdvice(basePackages = "com.ybl.test.controller")
public class MyExceptionControllerAdvice {
/**
* @ExceptionHandler 是为了告诉RestControllerAdvice能处理哪些异常
* @param e
* @return
*/
@ExceptionHandler(value= MethodArgumentNotValidException.class)
public R handleVaildException(MethodArgumentNotValidException e){
log.error("数据校验出现问题{},异常类型:{}",e.getMessage(),e.getClass());
//获取数据校验的结果
BindingResult bindingResult = e.getBindingResult();
Map<String,String> errorMap = new HashMap<>();
/**
* 获取所有的错误消息
* key 存错误字段
* value 存message
*/
bindingResult.getFieldErrors().forEach((fieldError)->{
errorMap.put(fieldError.getField(),fieldError.getDefaultMessage());
});
return R.error(BizCodeEnume.VAILD_EXCEPTION.getCode(),BizCodeEnume.VAILD_EXCEPTION.getMsg()).put("data",errorMap);
}
@ExceptionHandler(value = Throwable.class)
public R handleException(Throwable throwable){
log.error("错误:",throwable);
return R.error(BizCodeEnume.UNKNOW_EXCEPTION.getCode(),BizCodeEnume.UNKNOW_EXCEPTION.getMsg());
}
}
4、数据返回类
public class R extends HashMap<String, Object> {
private static final long serialVersionUID = 1L;
public R() {
put("code", 0);
put("msg", "success");
}
public static R error() {
return error(HttpStatus.SC_INTERNAL_SERVER_ERROR, "未知异常,请联系管理员");
}
public static R error(String msg) {
return error( HttpStatus.SC_INTERNAL_SERVER_ERROR, msg);
}
public static R error(int code, String msg) {
R r = new R();
r.put("code", code);
r.put("msg", msg);
return r;
}
public static R ok(String msg) {
R r = new R();
r.put("msg", msg);
return r;
}
public static R ok(Map<String, Object> map) {
R r = new R();
r.putAll(map);
return r;
}
public static R ok() {
return new R();
}
@Override
public R put(String key, Object value) {
super.put(key, value);
return this;
}
public Integer getCode() {
return (Integer) this.get("code");
}
}
5、错误信息枚举类
public enum BizCodeEnume {
UNKNOW_EXCEPTION(10000,"系统未知异常"),
VAILD_EXCEPTION(10001,"参数格式校验失败");
private int code;
private String msg;
BizCodeEnume(int code, String msg){
this.code = code;
this.msg = msg;
}
public int getCode() {
return code;
}
public String getMsg() {
return msg;
}
}
6、测试:
正常:
缺少ID:
四、分组校验
比如,我们在update和insert的时候校验规则是不同的,insert的时候,id可以不需要,update的时候id就必须带着。
在上面的校验注解中可以填写groups的参数,这个参数就是用来标识那种分组,然后针对不同情况校验。
groups是一个数组,可以指定多个分组,而且规定这个分组必须是一个接口,这些接口不需要写接口方法。
1、接口定义
public interface UpdateGroup {
}
public interface InsertGroup {
}
2、更改校验规则
@Data
public class User {
@NotNull(message = "更新时必须携带ID",groups = {UpdateGroup.class})
@Null(message = "插入时不能携带id",groups = {InsertGroup.class})
private Integer id;
@NotEmpty(message = "名字不能为空")
private String name;
@Email(message = "邮箱不能为空")
private String email;
private String phone;
}
3、编写controler
这里校验注解使用的是@Validated,它是由Spring提供的,@Valid是由jsr303提供的一种规范,@Validated支持一个添加分组的参数
@Validated:
@Valid:
@PostMapping("/insert")
public R jsr303Insert(@Validated(InsertGroup.class) @RequestBody User user){
log.info("insert=======user:{}",user);
return R.ok() ;
}
@PostMapping("/update")
public R jsr303Update(@Validated(UpdateGroup.class) @RequestBody User user){
log.info("update-------user:{}",user);
return R.ok() ;
}
4、测试:
测试insert
localhost:8080/insert
不携带id
携带id:
测试update
localhost:8080/update
不携带id:
携带id:
五、自定义校验注解
假如我们需要在上面的类添加一个字段status,用来标识当前用户是否可用,而这个字段只允许使用两个值0和1,0表示不能用,1表示能用,我们在修改这个字段的时候需要校验这个值。我们下面就来讲解怎么自定义校验注解
1、编写一个自定义的校验注解
先来创建这个注解
public @interface ListValue {
}
要怎么写呢?我们可以参考jsr303提供的校验注解是怎么写得,以NotNull为例:
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Retention(RUNTIME)
@Repeatable(List.class)
@Documented
@Constraint(validatedBy = { })
public @interface NotNull {
String message() default "{javax.validation.constraints.NotNull.message}";
Class<?>[] groups() default { };
Class<? extends Payload>[] payload() default { };
/**
* Defines several {@link NotNull} annotations on the same element.
*
* @see javax.validation.constraints.NotNull
*/
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Retention(RUNTIME)
@Documented
@interface List {
NotNull[] value();
}
}
可以看到需要有三个属性
message:出现错误,错误信息去哪里取(去ValidationMessages.properties这个配置文件中取错误信息).
groups:定义分组,那些分组能用。
payload:自定义一些负载信息
作为一个注解,他还需要标注一些元信息数据,比如:
@Target用于标识这个注解能写在那些地方(类、方法、构造等)
@Retention用于标识运行时机
@Constraint用于指定那个校验器进行校验
@Repeatable可重复注解
@Documented它会被 javadoc 之类的工具处理, 所以注解类型信息也会被包括在生成的文档中,是一个标记注解,没有成员。
编写java类:
@Target({ METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE })
@Retention(RUNTIME)
@Documented
@Constraint(validatedBy = { })
public @interface ListValue {
String message() default "{com.ybl.test.valid.ListValue.message}";
Class<?>[] groups() default { };
Class<? extends Payload>[] payload() default { };
int[] vals() default { };
}
编写ValidationMessages.properties:
com.ybl.test.valid.ListValue.message=“必须提交指定的值”
@Constraint中validatedBy可以指定校验器,我们下面就来编写自定义的校验器
2、编写一个自定义的校验器
参考上面,我们先来看一下校验器是怎么做的
@Documented
@Target({ ANNOTATION_TYPE })
@Retention(RUNTIME)
public @interface Constraint {
Class<? extends ConstraintValidator<?, ?>>[] validatedBy();
}
可以看出,他是使用ConstraintValidator来校验的。ConstraintValidator是一个接口:
public interface ConstraintValidator<A extends Annotation, T> {
}
这个接口有两个泛型,第一个泛型用来指定要校验的注解,第二个泛型指定我们要校验什么类型的数据。
接下来,我们来实现这个接口
public class ListValueConstraintValidator implements ConstraintValidator<ListValue,Integer> {
private Set<Integer> set = new HashSet<Integer>();
/**
* 初始化方法,他会将注解的详细信息vals、message拿到
* @param constraintAnnotation
*/
@Override
public void initialize(ListValue constraintAnnotation) {
int[] vals = constraintAnnotation.vals();
if(vals != null || vals.length>0){
for (int val : vals) {
set.add( val );
}
}
}
/**
* 判断是否校验成功
* @param value 需要校验的值,也就是我们前台传过来的值
* @param context
* @return
*/
@Override
public boolean isValid(Integer value, ConstraintValidatorContext context) {
return set.contains( value );
}
}
自定义校验器定义好了,我们就要把校验器和校验注解关联起来。
3、关联自定义的校验器和校验注解
校验器和校验注解关联起来,validateBy是用来指定校验器的,
@Constraint(validatedBy = { ListValueConstraintValidator.class })
4、测试是否能成功
@ListValue(vals = {0, 1}, groups = {UpdateGroup.class})
private Integer status;
编写controller
@PostMapping("/status")
public R jsr303Status(@Validated({UpdateGroup.class}) @RequestBody User user){
log.info("Status-------user:{}",user);
return R.ok() ;
}
访问:localhost:8080/status
4.1、测试status为1或者2
4.2、测试其他值
测试结果是我们想要的,自定义校验器编写成功。