Java注解框架开发依赖元注解精准控制：@Target限定适用位置，@Retention指定生命周期（RUNTIME方可反射读取），@Inherited支持类注解继承，@Documented纳入Javadoc，@Repeatable实现重复声明。
Java注解框架开发离不开元注解的精准控制。它们不是装饰性语法糖，而是决定自定义注解能否被正确识别、何时生效、在哪起作用的关键开关。写错一个元注解，整个注解逻辑可能在运行时完全失效。
明确注解的适用位置：@Target必须按需限定
@Target 告诉 JVM “这个注解允许贴在哪里”。不加或乱设，轻则编译报错，重则语义模糊、被误用。
- 只用于类或接口？用 @Target(ElementType.TYPE)
- 仅修饰方法？写成 @Target(ElementType.METHOD)，别漏掉括号和大写
- 支持多个位置？传数组：@Target({ElementType.METHOD, ElementType.FIELD})
- 常见误区：把
ElementType.PARAMETER写成ElementType.PARAMETERS（拼写错误直接编译失败）
控制注解存活时间：@Retention选RUNTIME才可反射读取
大多数框架级注解（如权限校验、日志切面）需要在运行时通过反射获取，这就要求生命周期至少是 RUNTIME。
- RetentionPolicy.SOURCE：仅源码存在，javac后消失 → 适合 Lombok 类型的编译期处理
- RetentionPolicy.CLASS：保留在 .class 文件里，但 JVM 不加载 → 少用，调试或字节码工具场景
- RetentionPolicy.RUNTIME：JVM 加载并保留 → 自定义业务注解默认应选此项
- 没写 @Retention？Java 默认为 CLASS，反射读不到，容易踩坑
让注解参与继承与文档：@Inherited 和 @Documented 的实际价值
这两个元注解常被忽略，但在特定场景下能显著提升框架健壮性和可维护性。
立即学习“Java免费学习笔记（深入）”；
-
@Inherited 只对类级别注解有效（
ElementType.TYPE），子类自动继承父类注解；方法/字段注解不继承 - @Documented 让 Javadoc 自动生成时包含该注解说明 —— 对外提供 SDK 或公共组件时很有必要
- 组合使用示例：
@Target(ElementType.TYPE)<br>@Retention(RetentionPolicy.RUNTIME)<br>@Documented<br>@Inherited<br>public @interface EnableSecurity { ... }
支持重复声明：@Repeatable 让同一位置可用多次
Java 8 引入 @Repeatable，解决“一个地方只能贴一次同名注解”的限制，比如配置多个定时任务。
- 必须配对使用：先定义容器注解（如
@Schedules），再用@Repeatable(Schedules.class)标记目标注解（如@Schedule） - 容器注解的 value() 必须返回目标注解数组：
public @interface Schedules { Schedule[] value(); } - 使用时可写多次：
@Schedule(cron="0 0 * * * ?")<br>@Schedule(cron="0 30 * * * ?")<br>public void doJob() { ... }
