Java注解本身不执行校验,需与反射和Spring AOP协同:注解声明规则,反射读取规则,Spring在Controller方法执行前触发校验;自定义注解须实现ConstraintValidator并用@Constraint关联,否则无效。

Java 注解本身不执行校验逻辑,它只是元数据标记;真正驱动参数校验的是“注解 + 反射 + AOP(或 Spring 的参数解析机制)”三者协同工作的结果。核心在于:注解声明规则,反射读取规则,框架在合适时机(如 Controller 方法执行前)触发校验逻辑。
注解作为校验规则的声明载体
校验注解(如 @NotBlank、@Min、自定义的 @CheckRule)本质是继承 java.lang.annotation.Annotation 的接口,通过元注解(@Target、@Retention(RetentionPolicy.RUNTIME))确保它能标注在字段上,并在运行时被反射读取。例如:
- @Target(ElementType.FIELD) 表示该注解只能用在属性上
- @Retention(RetentionPolicy.RUNTIME) 表示 JVM 加载类后仍可通过反射获取
- 注解成员(如
message()、min()、regex())以方法形式定义,实际使用时由 JVM 填充值
反射是读取注解规则的关键桥梁
框架在运行时通过反射访问 DTO 对象的字段及其注解信息:
- 调用
field.getAnnotationsByType(NotBlank.class)或field.getDeclaredAnnotations()获取校验注解实例 - 调用注解方法(如
notBlank.message())提取配置项 - 结合字段值(如
field.get(object))进行规则比对:空值判断、数值范围检查、正则匹配等
没有反射,注解就只是静态标签,无法动态参与校验流程。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
Spring 的自动机制完成“触发-执行-响应”闭环
仅靠注解和反射还不够,需要框架在正确时机介入。Spring Boot 默认集成 Hibernate Validator,其工作链路如下:
- Controller 方法参数标注 @Validated 或 @Valid,Spring MVC 解析器识别该标记
- 在参数绑定(DataBinder)完成后、方法体执行前,自动调用
Validator.validate() - 校验失败时抛出
MethodArgumentNotValidException,由全局异常处理器统一转为标准错误响应(如 JSON 格式:{“code”:400, “msg”:“用户名不能为空”})
自定义注解需配套约束校验器才能生效
标准注解(如 @Email)已内置对应校验器(EmailValidator),但自定义注解(如 @Mobile)必须显式实现 ConstraintValidator 接口:
- 重写
isValid(String value, ConstraintValidationContext context)方法,编写手机号正则逻辑 - 用 @Constraint(validatedBy = MobileValidator.class) 关联校验器
- Spring 启动时扫描并注册该校验器,后续反射读到 @Mobile 就自动调用它
缺少这一步,自定义注解只是摆设,不会产生任何校验行为。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










