spring boot-@Validated参数校验-自定义注解（不为空才进行正则校验）

最新推荐文章于 2026-03-27 17:30:00 发布

原创最新推荐文章于 2026-03-27 17:30:00 发布 · 3.2k 阅读

5 ·

本内容遵循CC 4.0 BY-SA版权协议

标签

#spring #java #spring boot

该博客介绍了如何使用自定义注解结合JSR进行数据校验，注解仅在输入不为空时执行正则匹配。注解定义包括正则表达式和错误消息，并提供了验证器实现。当在Controller中出现MethodArgumentNotValidException时，全局异常处理器捕获并返回错误信息。

通过自定义注解，满足不为空才进行正则校验的需求

/**
 * @author LGQ
 * @Title: 自定义注解整合jsr
 * @Description: 不为空进行规则校验
 * @date 2021/9/30 10:32
 */
@Target({METHOD, FIELD, ANNOTATION_TYPE, CONSTRUCTOR, PARAMETER, TYPE_USE})
@Retention(RetentionPolicy.RUNTIME)
@Constraint(validatedBy = NotBlankThenPattern.NotBlankThenPatternValidation.class)
@Documented
public @interface NotBlankThenPattern {

    String regexp() default "";

    String message() default "格式错误";

    /**
     * @return the groups the constraint belongs to
     */
    Class<?>[] groups() default {};

    /**
     * @return the payload associated to the constraint
     */
    Class<? extends Payload>[] payload() default {};


    class NotBlankThenPatternValidation implements ConstraintValidator<NotBlankThenPattern, String> {

        private Pattern pattern;

        @Override
        public void initialize(NotBlankThenPattern constraintAnnotation) {
            this.pattern = Pattern.compile(constraintAnnotation.regexp());
        }

        @Override
        public boolean isValid(String value, ConstraintValidatorContext context) {
            if (StringUtil.isBlank(value)) {
                return true;
            }
            return pattern.matcher(value).matches();
        }
    }
}

@RestControllerAdvice
@Slf4j
public class CommonExceptionHandler {

    @ExceptionHandler({MethodArgumentNotValidException.class})
    public Result handleMethodArgumentNotValidException(MethodArgumentNotValidException ex) {
        BindingResult bindingResult = ex.getBindingResult();
        StringBuilder sb = new StringBuilder("");
        if (null != bindingResult.getFieldErrors()) {
            for (FieldError fieldError : bindingResult.getFieldErrors()) {
                sb.append(fieldError.getDefaultMessage() + "\n");
            }
            return Result.ofFail(-1, sb.toString());
        }
        return Result.ofSuccessMsg(null);
    }

}