← 返回首页

讲一讲Java注解的原理

发布时间: 2026-06-17
出自: 基础八股

Java 注解（Annotation）本身并不直接影响代码的执行逻辑，它本质上是一种元数据（描述数据的数据），其核心作用是“将声明与行为彻底分离”。注解之所以能够驱动框架运行，是因为在编译期或运行期，有特定的处理器或反射机制在读取并解析它。

要彻底理解 Java 注解的原理，可以从以下三个核心维度来剖析：

1. 注解的底层本质：特殊的接口

很多开发者误以为注解是“特殊的注释”，这其实是一个认知误区。在 JVM 的底层实现中，注解的本质是一个继承了 java.lang.annotation.Annotation 接口的接口。 当我们定义一个注解并声明其属性时，这些属性在底层实际上就是该接口中定义的抽象方法。例如，@MyAnnotation(value = "test") 中的 value，本质上就是调用了 String value() 这个方法。

2. 生命周期：由 @Retention 决定

注解的生命周期由元注解 @Retention 严格控制，它决定了注解信息保留到哪个阶段，也决定了它的处理方式：

  • SOURCE（源码级）：仅在编译期有效，javac 编译后直接丢弃，不会写入 Class 文件。常用于编译期检查（如 @Override）或代码生成（如 Lombok）。
  • CLASS（字节码级）：编译后写入 Class 文件，但在 JVM 类加载时会被丢弃，不进入内存。这是注解的默认策略，常用于字节码增强。
  • RUNTIME（运行期）：完整保留在 Class 文件中，JVM 加载后存入元空间。这是绝大多数主流框架（如 Spring、MyBatis）依赖的基础，允许在运行期通过反射动态获取。

3. 运行机制：编译期与运行期

根据保留策略的不同，注解的处理方式分为两条主要路径：

编译期处理（APT 机制） 对于 SOURCE 或 CLASS 级别的注解，Java 提供了注解处理器工具（APT）。在 javac 编译阶段，APT 会扫描带有指定注解的代码元素，并生成配套的模板代码或进行编译期校验。这种方式不会产生运行时性能损耗，Lombok 的 @Data 自动生成 Getter/Setter 就是典型的编译期处理。

运行期处理（反射与动态代理） 对于 RUNTIME 级别的注解，其执行逻辑分为扫描、解析、执行三个阶段。其中，解析阶段是注解底层的核心： 当我们在运行期通过反射 API（如 Class.getAnnotation()）获取注解时，JVM 并不会直接实例化该注解接口，而是通过 sun.reflect.annotation.AnnotationParser 动态生成一个代理类。这个代理类实现了我们的注解接口，其内部的 InvocationHandler 为 AnnotationInvocationHandler。JVM 会将注解的属性值以键值对的形式存入一个 Map 中，当调用注解的属性方法时，代理类会通过方法名从 Map 中获取并返回对应的值。

总结来说，Java 注解是一套“声明即契约”的机制。它通过接口定义契约，通过元注解控制生命周期，再配合编译期的 APT 工具或运行期的反射与动态代理机制，最终实现了代码的高度解耦与动态配置。