java注解是驱动框架行为、统一横切逻辑的核心机制，需合理组合元注解：@target控制作用域，@retention决定生命周期，@inherited支持类继承，@documented增强文档可见性，@repeatable实现重复使用。
Java注解不是装饰性语法糖，而是驱动框架行为、统一横切逻辑、降低配置耦合的核心机制。真正发挥价值的，是合理组合元注解来适配具体业务约束——比如日志需运行时生效、权限规则要继承、校验逻辑得编译期介入。
明确注解作用域：用 @Target 精准控制“能标在哪”
@Target 决定了注解的适用边界，选错会导致编译失败或语义错位。常见误区是笼统用 ElementType.TYPE，结果想标注在参数上却报错。
- 方法级增强（如日志、事务）：用 @Target(ElementType.METHOD)
- 字段级校验（如非空、长度）：用 @Target({ElementType.FIELD, ElementType.PARAMETER})，支持实体字段和接口入参
- 类级别配置（如模块开关、审计标识）：用 @Target(ElementType.TYPE)，但注意它不自动作用于内部类
- 泛型类型安全场景（如自定义泛型约束）：必须加上 @Target(ElementType.TYPE_PARAMETER)
决定何时可见：@Retention 直接影响使用方式
生命周期策略不是“越长越好”，而是按需选择。RUNTIME 虽灵活，但反射开销不可忽视；SOURCE 更适合构建时检查。
- 需要运行时动态处理（AOP拦截、权限校验）：必须用 @Retention(RetentionPolicy.RUNTIME)
- 仅用于 IDE 提示或编译检查（如自定义 @NotNull 检查）：选 @Retention(RetentionPolicy.SOURCE)，零运行时成本
- 框架需在类加载阶段解析（如某些字节码增强工具）：用 @Retention(RetentionPolicy.CLASS)，比 RUNTIME 更轻量
让注解参与继承与文档：@Inherited 和 @Documented 的实用边界
这两个元注解常被误用。@Inherited 仅对类有效，且子类必须是直接继承才生效；@Documented 则关乎 API 可维护性。
- 设计领域模型的通用标记（如 @Auditable 表示需记录操作日志）：加上 @Inherited，子类自动获得审计能力
- 对外暴露的公共注解（如 SDK 提供的 @ApiVersion）：务必加 @Documented，否则 Javadoc 不会显示其说明
- 不要给方法或参数注解加 @Inherited——它不起作用，Java 规范明确限定只作用于类
支持重复使用：@Repeatable 让配置更自然
当一个位置需要多个同类语义注解（如多个定时任务、多角色权限），硬编码数组写法不直观。@Repeatable 提供声明式叠加。
- 定义单个注解时，用 @Repeatable(Schedules.class) 声明其容器类型
- 容器注解（如 Schedules）需声明 value() 数组属性，类型为原注解
- 使用时可直接写多次：@Schedule(cron="0 0 * * *") @Schedule(cron="0 30 * * *")，比 @Schedules({@Schedule(...), @Schedule(...)}) 更清晰
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
