17370845950

注解是程序可读的元数据而非注释，需处理器（如编译器、反射）才生效；自定义注解须声明@Target、@Retention及合法属性，运行时读取需反射并判空。

注解本身不执行任何逻辑，它只是代码的“标签”——就像你给文件夹贴上“紧急”便签，便签不会自动帮你做事，但你能一眼识别优先级；同理，@Override 不重写方法，@Deprecated 不禁用方法，它们只提供元数据，真正起作用的是编译器或运行时读取这些标签后做的判断和处理。

注解不是注释，是程序可读的元数据

很多人第一眼把 @Override 当成高级注释，这是最大误区。注释（// 或 /** */）在编译时被完全丢弃，JVM 看不见；而注解默认保留在 .class 文件里（@Retention(RetentionPolicy.CLASS)），甚至能活到运行时（RUNTIME），供反射调用。

• 注释 → 给人看，编译器无视
• 注解 → 给程序看，必须有处理器（编译器、APT、反射）才生效
• 没写处理器的自定义注解，就等于贴了张没人认的标签——语法合法，但毫无作用

自定义注解三要素：@Target、@Retention、属性声明

定义一个可用的注解，光写 @interface MyAnno 不够，必须明确：它能标在哪（类？方法？参数？）、保留到哪一阶段（源码？字节码？运行时？）、带哪些参数。

• @Target({ElementType.METHOD, ElementType.TYPE})：限制只能用在方法或类上，标在字段会编译报错
• @Retention(RetentionPolicy.RUNTIME)：这是反射读取的前提；若设为 SOURCE，连 .class 里都没有，反射必然拿不到
• 属性必须是接口方法形式，返回类型受限（基本类型、String、Class、枚举、其他注解、以上类型数组），不能是 List 或自定义对象

import java.lang.annotation.*;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface LogExecutionTime {
String value() default "default";
int thresholdMs() default 100;
}

运行时读取注解必须靠反射，且要检查存在性

即使注解保留策略是 RUNTIME，也不代表一定能读到——你得先拿到目标元素的反射对象（Class、Method、Field），再调用 getAnnotation()。漏掉 isAnnotationPresent() 直接强转，容易抛 NullPointerException。

• 类上的注解：用 clazz.getAnnotation(MyAnno.class)
• 方法上的注解：先 Method m = clazz.getDeclaredMethod("xxx");，再 m.getAnnotation(MyAnno.class)
• 务必判空：反射返回 null 是常态，不是异常

常见踩坑点：value 属性可省略，但其他属性不行

当注解只有一个名为 value 的属性，且你只传这一个值时，可以省略 value=：

• @LogExecutionTime("api") ✅ 等价于 @LogExecutionTime(value="api")
• @LogExecutionTime(thresholdMs=50) ❌ 编译失败：非 value 属性必须显式写出名
• 多个属性必须全写，且顺序无关：@LogExecutionTime(value="cache", thresholdMs=200)

另外，数组属性写法易错：@MyAnno(tags={"a","b"}) 中的花括号不能省，单元素也要写成 {"x"}，否则编译不通过。