java注解本质是继承java.lang.annotation.annotation的特殊接口,编译生成interface字节码,运行时通过动态代理(annotationinvocationhandler)查表获取值,不可序列化,元注解控制其使用规则。

Java中的注解(Annotation)是一种用于为代码添加元数据的语法机制,它本身不改变程序逻辑,但能被编译器、工具或运行时读取并影响处理行为。它的本质是一个**继承自 java.lang.annotation.Annotation 的特殊接口**。
注解就是 interface,不是 class
当你用 @interface MyLog 声明一个注解时,编译器不会生成 class 文件,而是生成一个 interface 字节码。反编译后能看到:
- 它自动声明为
public interface MyLog extends java.lang.annotation.Annotation - 每个属性(如
String value() default "")都变成一个public abstract方法 - 不能写构造方法、字段、普通方法,也不能显式
extends其他接口或类
运行时拿到的不是真实对象,而是代理
调用 method.getAnnotation(MyLog.class) 返回的并不是你“new”出来的实例,而是一个由 AnnotationInvocationHandler 实现的动态代理对象:
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 该代理不执行任何逻辑,只是把方法调用(如
anno.value())转为从字节码的RuntimeVisibleAnnotations属性表中查值 - 注解的值在编译期就固化进 class 文件,运行时只是“查表”返回
- 所以注解对象不可序列化——
AnnotationInvocationHandler没实现Serializable
元注解控制的是这个接口的使用规则
@Retention、@Target、@Documented 这些元注解,其实是在修饰“这个接口”的行为边界:
-
@Retention(RetentionPolicy.RUNTIME)表示该接口的信息要保留在运行期,反射才能读到 -
@Target(ElementType.METHOD)表示这个接口只允许标注在方法上 - 这些规则由编译器检查,并决定是否将注解信息写入 class 文件的特定属性区
和普通接口的关键区别
虽然语法上像接口,但它被 JVM 特别对待:
- 隐式继承
Annotation,且禁止显式extends或implements - 方法不能有参数、不能抛异常、不能重载
- 返回类型受限:只能是基本类型、
String、Class、枚举、注解类型,或它们的数组 - 没有默认方法(即使 Java 8+ 支持接口默认方法,注解中也不允许)
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










