元注解是定义注解行为的注解,包括@retention(控制保留阶段)、@target(限定作用位置)、@documented(影响javadoc生成)、@inherited(实现类注解继承),缺一不可;自定义注解需声明+运行时解析,属性类型受限且注解实例为代理对象。

元注解是“用来定义注解的注解”,它不直接作用于业务代码,而是控制自定义注解的行为规则。面试中问到“元注解作用与自定义注解怎么解”,关键不是背概念,而是说清 为什么需要它们、每个元注解管什么、缺了会怎样,再配合一个可落地的自定义例子。
四大核心元注解各管什么
@Retention、@Target、@Documented、@Inherited 是 Java 标准库提供的元注解,缺一不可地决定一个注解能否被正确使用和读取:
-
@Retention:决定注解保留到哪个阶段。常见值有
SOURCE(仅源码,如 @Override)、CLASS(编译进 class 文件但运行时不可见,如 Lombok 的 @Getter)、RUNTIME(运行时可通过反射读取,Spring 的 @Autowired 必须设为此值) -
@Target:限定注解能加在哪些地方。比如只允许标注字段就写
@Target(ElementType.FIELD);若误用在方法上,编译器直接报错 - @Documented:让这个注解出现在生成的 Javadoc 中。不是功能必需,但对公共 SDK 很重要——别人看文档就知道某类支持哪些配置注解
-
@Inherited:仅对类级别注解生效,表示子类自动继承父类的该注解。注意:它不适用于方法或字段,且仅限
extends,不适用于implements
自定义注解必须包含的两部分
面试官常追问“写一个完整可用的自定义注解”,不能只贴个 @interface。真正完整的实现包含:
- 定义注解本身:用 @interface 声明,搭配 @Retention(RUNTIME) 和 @Target(...),声明属性(如 String value() default "")
- 配套解析逻辑:通过反射在运行时读取注解,并执行对应动作。例如字段赋值、日志记录、权限校验等。Spring 中靠 BeanPostProcessor、AOP 或自定义 FactoryBean 实现;纯 Java 可用 main 方法 + Class.getDeclaredFields() 演示
面试时如何快速写出一个可演示的例子
以“自动注入字符串值”为例,突出原理清晰、无框架依赖:
- 定义注解:
@Retention(RetentionPolicy.RUNTIME) @Target(ElementType.FIELD) public @interface AutoValue { String value(); } - 在实体类字段上使用:
@AutoValue("hello") private String msg; - 写解析工具类:遍历对象所有字段 → 判断是否含 @AutoValue → 获取 value 值 → setAccessible(true) 后赋值
- 强调重点:没有 @Retention(RUNTIME),反射 getAnnotation() 返回 null;没有 @Target(ElementType.FIELD),编译期就无法加到字段上
容易被忽略但加分的细节
答到这些,说明你真用过、调过、踩过坑:
- 注解属性类型受限:只能是基本类型、String、Class、枚举、其他注解,以及它们的一维数组;不能是 List、Map 或自定义对象
- 注解是接口,JVM 运行时拿到的是动态代理对象($ProxyN),所以不能用 == 比较两个注解实例,要用 equals()
- @Repeatable 不是独立元注解,它需要配合一个容器注解使用,用于支持同一位置多次声明(如 @RolesAllowed("ADMIN", "USER") 底层是多个 @RolesAllowed 单独存在)
- 如果用 APT(Annotation Processor)做编译期处理,那 @Retention 必须是 SOURCE,且需单独写 processor 类并注册到 META-INF/services/javax.annotation.processing.Processor
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











