注解如何添加元数据信息详解

Java注解远非简单的代码备注，而是需精心配置的结构化元数据——必须通过@Retention明确生命周期（如RUNTIME才能被反射读取）、@Target限定作用位置（否则编译直接报错），并辅以@Documented等元注解增强可用性；它本身不执行任何逻辑，所有功能依赖显式反射调用或框架（如Spring）的后处理器/AOP主动解析；重复使用需@Repeatable严格配合容器注解，属性类型也受基本类型、Class、枚举等硬性限制——任一环节疏漏，注解即形同虚设，轻则返回null引发空指针，重则编译失败或运行时完全失效。

注解（Annotation）不是“给代码加备注”的快捷方式，它本质是编译期或运行时可被读取的结构化元数据——用错时机、漏掉 @Retention 或没写 @Target，注解就等于没写。

Java 注解必须声明生命周期和作用目标才能生效

只写 @interface MyAnno 是无效的。JVM 不知道该保留到什么时候、能用在哪儿。

• @Retention(RetentionPolicy.RUNTIME)：缺它，反射读不到；选 CLASS 就只能被字节码工具读，SOURCE 连 class 文件都不进
• @Target({ElementType.METHOD, ElementType.TYPE})：不加这个，编译器会拒绝你把它标在字段上
• 顺手加上 @Documented 才能让 javadoc 生成时包含该注解说明

示例：

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.TYPE})
@Documented
public @interface ApiVersion {
    String value() default "1.0";
}

运行时读取注解要用 Class/Method 对象的 getAnnotation() 方法

注解不会自动触发逻辑，必须显式调用反射 API 获取，且注意空指针风险。

• clazz.getAnnotation(ApiVersion.class) 返回 null 表示没标注，别直接链式调用
• 方法级注解要先拿到 Method 实例：clazz.getDeclaredMethod("xxx").getAnnotation(ApiVersion.class)
• 如果用了 RetentionPolicy.CLASS，getAnnotation() 永远返回 null——此时只能用 ASM 或 javac 插件处理

常见错误现象：NullPointerException 出现在 anno.value()，其实是前面 getAnnotation() 返回了 null。

Spring 中的注解不是“即插即用”，依赖 BeanPostProcessor 或 AOP 织入

@Autowired、@Transactional 这类注解本身不做任何事，背后是 Spring 容器在启动时扫描并注册处理器。

• 自定义注解想实现类似效果，得手动注册 BeanPostProcessor（如处理字段注入）或 Aspect（如方法拦截）
• 别在普通 new 出来的对象上调用 @Autowired 字段——Spring 管不着，字段永远为 null
• @Configuration 类里的 @Bean 方法，其参数能被自动注入，是因为 Spring 在解析配置类时做了特殊处理，不是注解本身的能力

重复注解需用 @Repeatable 声明容器，否则编译报错

Java 8 以前不支持同一位置多个相同注解，现在可以，但语法有硬性要求。

• 必须定义一个“容器注解”，比如 @MyAnnos，其 value() 返回 MyAnno[]
• 原注解上加 @Repeatable(MyAnnos.class)
• 使用时可写多次：@MyAnno("v1") @MyAnno("v2")，反射读取时用 getAnnotationsByType(MyAnno.class)，不能用 getAnnotation()

漏掉 @Repeatable 却写了两个同名注解？编译器直接报错：Duplicate annotation。

最常被忽略的一点：注解属性类型受限严格——只能是基本类型、String、Class、枚举、其他注解，或以上类型的数组；不能是任意对象，也不能有方法体或泛型参数。试图绕过这些限制，只会让编译失败或运行时异常。

今天关于《注解如何添加元数据信息详解》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！