Spring Boot简单使用JSR303详解

1、基本注解

JSR 提供的校验注解:

  • @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(regex=,flag=) 被注释的元素必须符合指定的正则表达式

Hibernate Validator 提供的校验注解

  • @NotBlank(message =) 验证字符串非 null,且长度必须大于 0
  • @Email 被注释的元素必须是电子邮箱地址
  • @Length(min=,max=) 被注释的字符串的大小必须在指定的范围内
  • @NotEmpty 被注释的字符串的必须非空
  • @Range(min=,max=,message=) 被注释的元素必须在合适的范围内

2、Spring Boot中使用

全局异常控制

/**
     * 请求实体出现异常信息
     * @param ex 异常
     * @return 错误的字段可错误信息
     */
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public String handleValidationExceptions(MethodArgumentNotValidException ex) {
        StringBuilder sb = new StringBuilder();
        ex.getBindingResult().getAllErrors().forEach(x -> {
            /*key:错误的字段,value:错误的属性原因*/
            sb.append("key:").append(((FieldError) x).getField()).append("\n");
            sb.append("value:").append(x.getDefaultMessage()).append("\n");
        });
        return sb.toString();
    }

    /**
     * 效验@requestParam的参数异常,非请求实体
     * @param ex 异常
     * @return 错误信息
     */
    @ExceptionHandler(ConstraintViolationException.class)
    public String ConstraintViolationExceptionHandler(ConstraintViolationException ex) {
        return ex.getConstraintViolations().stream().map(ConstraintViolation::getMessage).collect(Collectors.joining());
    }

直接效验:

1、类上添加注解

 @Validated  不可少

@RequestMapping("/dl")
@RestController
@Validated  //不可少
public class HelloController {

}

2、方法参数上使用

@RequestMapping("/dl")
@RestController
@Validated
public class HelloController {

    /**
     * 测试
     * @return
     */
    @GetMapping("/aa")
    public String aa( @RequestParam("name") @NotBlank String name )  {
       
        return "aa";
    }
}

 实体类中进行效验:

 @Valid  属性为对象类型要进行效验,要添加Valid注解进行下钻

@Data
public class Student {

    @Valid // 效验对象要使用Valid注解
    private Student student;

    @Max(value = 18)
    private Integer age;
}
@RequestMapping("/dl")
@RestController
@Validated
public class HelloController {

    /**
     * 测试2
     *
     * @return @Valid注解
     */
    @PostMapping("/aa")
    public String aa( @RequestBody @Valid Student student)  {
        
        return "aa";
    }
}

组效验不常用,用起来比较繁琐 

自定义效验注解:

 案例注解用于效验枚举值是否存在

1、注解

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.FIELD,ElementType.PARAMETER}) //用于属性和参数
@Constraint(validatedBy = EnumValidator.class) //EnumValidator 我们要实现的逻辑
@Documented
public @interface EnumValid {
    //错误信息
    String message() default "枚举值不存在";

    //默认 不然会报错
    Class<?>[] groups() default {};

    //默认 不然会报错
    Class<? extends Payload>[] payload() default {};

    //枚举类的class
    Class<? extends Enum<?>> enumClass();
}

2、编写 EnumValidator类,实现ConstraintValidator接口

public class EnumValidator implements ConstraintValidator<EnumValid, String> {
    private Class<? extends Enum<?>> enumClass;

    @Override
    public void initialize(EnumValid constraintAnnotation) {
        this.enumClass = constraintAnnotation.enumClass();
    }

    @Override
    public boolean isValid(String value, ConstraintValidatorContext context) {
        /*效验规则*/
        Enum<?>[] constants = enumClass.getEnumConstants();
        for (Enum<?> item : constants) {
            if (item.name().equals(value)) {
                return true;
            }
        }
        return false;
    }
}

一个自定义注解就实现了。

项目中这些就基本够用。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Eeverybody

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值