Java注解是继承Annotation接口的特殊接口,用于为代码添加元数据;通过@interface定义,@Target和@Retention等元注解控制其作用位置与生命周期,运行时需结合反射使用。

Java注解是一种结构化元数据,写在代码元素(如类、方法、字段)上方,本身不执行逻辑,但能被编译器、工具或运行时环境识别并触发相应行为。
注解的本质和基本语法
注解本质是一个继承了red">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)。










