Java注解是继承Annotation接口的特殊接口，用于为代码添加元数据；通过@interface定义，@Target和@Retention等元注解控制其作用位置与生命周期，运行时需结合反射使用。
Java注解是一种结构化元数据，写在代码元素（如类、方法、字段）上方，本身不执行逻辑，但能被编译器、工具或运行时环境识别并触发相应行为。
注解的本质和基本语法
注解本质是一个继承了java.lang.annotation.Annotation接口的特殊接口。定义时用@interface关键字，例如：
public @interface MyLog {
String value() default "INFO";
boolean enabled() default true;
}
使用时直接加在目标元素前：
@MyLog("DEBUG")
public void doWork() { ... }
立即学习“Java免费学习笔记（深入）”；
注意：若注解只有一个value()属性，使用时可省略value=，直接写值。
元注解控制注解的行为
元注解是用来修饰其他注解的注解，最常用的是两个：
- @Target：指定该注解能用在哪些位置。比如@Target({ElementType.METHOD, ElementType.TYPE})表示只能标注在方法或类上。
-
@Retention：决定注解保留到哪个阶段。
– SOURCE：仅保留在源码中（如@Override）；
– CLASS：编译进class文件但JVM不加载（Lombok常用）；
– RUNTIME：JVM加载并保留，可通过反射读取（Spring、自定义AOP注解必须用这个）。
其他元注解如@Documented（生成Javadoc时包含）、@Inherited（允许子类继承类上的注解）也常配合使用。
运行时注解怎么被“看到”和使用
要让注解在运行时起作用，关键靠反射 + 正确的@Retention(RetentionPolicy.RUNTIME)。
核心思路是：要解析谁的注解，就先拿到谁的对象——
- 解析类上的注解 → 获取Class对象，调用getAnnotation(MyLog.class)
- 解析方法上的注解 → 获取Method对象（如clazz.getDeclaredMethod("doWork")），再调用getMethodAnnotation()
- 所有Class、Method、Field、Constructor都实现了AnnotatedElement接口，天然支持注解读取。
例如，在Spring AOP中，切面会扫描方法是否带有@MyLog，有则自动记录日志，业务代码完全无侵入。
常见使用场景与实际价值
注解不是炫技，而是解决具体问题的轻量机制：
- 编译检查：如@Override防止拼错方法名，@Deprecated提示过期API。
- 减少样板代码：Lombok的@Data自动生成getter/setter/toString，@Slf4j注入log对象。
- 框架配置替代XML：Spring的@Service、@RequestMapping、MyBatis的@Select，把配置和代码绑定更紧密。
- 运行时动态行为控制：自定义权限注解@RequiresRole("ADMIN")，结合AOP统一校验；监控注解标记关键方法，自动采集RT/QPS指标。
不复杂但容易忽略：真正让注解落地的，从来不是定义它，而是明确它的生命周期、作用目标，并配好对应的处理器（编译期APT 或 运行期反射+AOP）。
