首页 > 资讯 > > 内容

天天快讯:【Java】使用 validation 完成自定义校验注解

发表时间:2023-06-21 11:55:48 来源:博客园

总括:

validation 让我们简化了开发过程,可以使用简单的一个注解就实现了很多常见的检验数据的功能,同时支持自定义注解。spring-boot-starter-validation 是由 Spring Boot 整合的一套用于处理validation 的约定化自动配置启动器。Spring 系列框架通过简单的安装依赖即可直接使用 validation 提供的参数校验功能,通过为接口添加 @Valid / @Validated 对特定参数进行校验。

使用方法:

1. 安装依赖


(资料图)

    org.springframework.boot    spring-boot-starter-validation

如果已使用 Spring Boot 框架可以不指定版本号,依赖于Spring Boot 版本。

2. 接口参数添加@Valid / @Validated 进行参数校验

@RequestMapping("/doLogin")@ResponseBodypublic ResponseBean doLogin(@Valid LoginVo loginVo, HttpServletRequest request, HttpServletResponse response) {    return userService.doLogin(loginVo, request, response);}

3. 在需要进行校验的参数的属性上使用validation 基础注解

/* 空检查 */@Null     // 验证对象是否为null@NotNull        // 验证对象是否不为null, 无法查检长度为0的字符串@NotBlank      // 检查约束字符串是不是Null还有被Trim的长度是否大于0,只对字符串,且会去掉前后空格.@NotEmpty      // 检查约束元素是否为NULL或者是EMPTY. /* Booelan检查 */@AssertTrue      // 验证 Boolean 对象是否为 true  @AssertFalse         // 验证 Boolean 对象是否为 false  /* 长度检查 */@Size(min=, max=)   // 验证对象(Array,Collection,Map,String)长度是否在给定的范围之内  @Length(min=, max=)    // 验证注解的元素值长度在min和max区间内/* 日期检查 */@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=) // 验证注解的元素值在最小值和最大值之间 @Range(min=10000,max=50000,message="range.bean.wage")/* 其他检验 */@Valid               // 写在方法参数前,递归的对该对象进行校验, 如果关联对象是个集合或者数组,那么对其中的元素进行递归校验,如果是一个map,则对其中的值部分进行校验.(是否进行递归验证)@CreditCardNumber    // 信用卡验证@Email               // 验证是否是邮件地址,如果为null,不进行验证,算通过验证。@ScriptAssert(lang= ,script=, alias=) // 简单脚本校验@URL(protocol=,host=, port=,regexp=, flags=) // IP地址校验                

4. 自定义参数校验注解

4.1 自定义注解

可以照抄@NotNull 等基础校验注解的写法

@Target({ElementType.METHOD, ElementType.FIELD, ElementType.ANNOTATION_TYPE, ElementType.CONSTRUCTOR, ElementType.PARAMETER, ElementType.TYPE_USE})@Retention(RetentionPolicy.RUNTIME)@Documented@Constraint(        validatedBy = {IsMobileValidator.class})public @interface IsMobile {    boolean required() default true;    String message() default "手机号码格式错误";    Class[] groups() default {};    Class[] payload() default {};}

4.2 实现ConstraintValidator 接口,用以实现自定义参数校验逻辑

public class IsMobileValidator implements ConstraintValidator {      private boolean required = false;   /**   *@Param: {@link IsMobile } constraintAnnotation   *@Return: void   *@TODO: 初始化方法,可以用自定义注解中获取值进行初始化    **/    @Override    public void initialize(IsMobile constraintAnnotation) {        required = constraintAnnotation.required();    }       /**    *@Param: {@link String} value   *@Param: {@link ConstraintValidatorContext } constraintValidatorContext   *@Return: {@link boolean}   *@TODO: 实际校验自定义注解 value 值   **/    @Override    public boolean isValid(String value, ConstraintValidatorContext constraintValidatorContext) {        if(required){            return ValidatorUtil.isMobile(value);        }else {            if(StringUtils.isEmpty(value)){                return true;            }else {                return ValidatorUtil.isMobile(value);            }        }    }}

其中IsMobile 为自定义注解名(根据个人需求自己命名),isValid 方法具体校验逻辑由个人需求及业务确定。使用时同基础校验注解一般放置在需要校验的参数属性上即可。

注意:自定义注解上必须有@Constraint 注解,其中validatedBy 指定执行校验的类,该类必须实现ConstraintValidator 接口

标签:

Copyright ©  2015-2022 华南产业网版权所有  备案号:粤ICP备18025786号-52   联系邮箱: 954 29 18 82 @qq.com