自定义注解校验器开发_自定义注解如何配合反射实现通用的字段合法性检查-java教程-PHP中文网

自定义注解配合反射实现通用字段校验，核心是“标记+扫描+执行”三步闭环：通过运行时注解声明校验意图，反射定位带注解字段，再调用验证逻辑；不依赖spring validation，也无需重复if判断，真正一次定义、多处复用。

自定义注解校验器开发_自定义注解如何配合反射实现通用的字段合法性检查

自定义注解配合反射实现通用字段校验，核心在于“标记 + 扫描 + 执行”三步闭环：用注解声明校验意图，用反射定位带注解的字段，再调用对应验证逻辑完成检查。它不依赖 Spring Validation 框架，也不需要为每个字段写 if 判断，真正实现一次定义、多处复用。

一、定义运行时注解，明确校验语义

注解必须保留到运行时（@Retention(RUNTIME)），且能标注在字段上（@Target(FIELD)）。例如定义一个非空校验注解：

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface NotNull {
  String message() default "字段不能为空";
  Class>[] groups() default {};
  Class extends Payload>[] payload() default {};
}

注意：message、groups、payload 是 JSR-303 规范要求的三个标准属性，即使不用 Bean Validation 框架，也建议保留，便于后续扩展或与框架兼容。

二、编写通用校验器，用反射遍历并执行检查

校验器是一个普通工具类，接收任意对象，通过反射获取其所有字段，判断是否带有指定注解，再根据注解类型执行对应逻辑：

调用 obj.getClass().getDeclaredFields() 获取全部字段
对每个字段调用 field.isAnnotationPresent(NotNull.class)
设为可访问（field.setAccessible(true)），再用 field.get(obj) 取值
若值为 null，抛出含 annotation.message() 的异常或收集错误信息

关键点：字段可能在父类中，需递归扫描 getSuperclass()；私有字段必须设为 accessible；基本类型需处理包装类与默认值差异（如 int 默认 0，但不是 null）。

三、支持多注解组合与动态扩展

一个字段可同时标注多个校验注解（如 @NotNull + @Range(min=1, max=100)），校验器应统一扫描、逐个触发：

把不同注解映射到不同验证器（如 NotNullValidator、RangeValidator）
用 Map<class extends annotation>, Validator></class> 管理策略
新增校验规则只需定义新注解 + 新验证器，无需修改主校验流程

例如枚举校验可定义 @EnumValue(enumClass = Status.class)，验证器内部用 enumClass.getDeclaredMethod("valueOf", String.class).invoke(null, value) 尝试转换，失败即不合法——完全泛化，不耦合具体枚举类型。