Java注解的反射与动态处理语法-java教程-PHP中文网

java注解需用@retention(retentionpolicy.runtime)才能在运行时通过反射读取；否则默认class或source策略下注解不可见。获取时须注意@target匹配、参数注解用getparameterannotations()、重复注解用getannotationsbytype()而非getannotation()，并安全处理默认值与proguard影响。

java注解的反射与动态处理语法

Java注解在运行时怎么被读取到？

必须用 @Retention(RetentionPolicy.RUNTIME)，否则反射拿不到。默认是 CLASS，编译后就丢弃了，RetentionPolicy.SOURCE 连 class 文件都不进。

常见错误：写了注解但 getAnnotation(...) 总返回 null，八成是忘了加 @Retention(RUNTIME) 或写在了方法参数上（参数注解要用 getParameterAnnotations()，且需 @Target(ElementType.PARAMETER)）。

实操建议：

所有要反射读取的注解，开头必须显式声明 @Retention(RetentionPolicy.RUNTIME)
检查 @Target 是否匹配使用位置（如 ElementType.METHOD 不能标在类上）
接口上的注解默认不可继承，若需子类/实现类继承，得加 @Inherited（仅对 CLASS 和 RUNTIME 生效，且只作用于类）

如何安全地用反射获取注解值？

别直接调 annotation.value() —— 如果注解没设默认值、又没在代码里显式写出来，会抛 java.lang.annotation.IncompleteAnnotationException。

更稳妥的方式是先用 isAnnotationPresent(...) 判定存在性，再用 getAnnotation(...) 获取；取属性值时，优先用 invoke() + getDefaultValue() 做兜底，或直接用 AnnotationUtils（Spring）这类工具类。

示例：手动兼容默认值

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

Object value = null;
Method method = annotation.getClass().getMethod("value");
if (method.getDefaultValue() != null) {
    value = method.getDefaultValue();
} else {
    value = method.invoke(annotation);
}

注解处理器（APT）和运行时反射有什么区别？

APT 在编译期工作，生成新源码（比如 @Override 不触发 APT，但 @Data（Lombok）或 @Mapper（MyBatis）会）；反射在 JVM 运行时查，不生成代码，但有性能开销和安全性限制（如模块系统下可能被 Module.addOpens 卡住）。

关键差异：

APT 无法读取运行时才决定的值（比如依赖注入后的对象），反射可以
反射无法修改注解内容（注解实例是只读的），APT 可以生成任意逻辑
Android 上反射读注解受 ProGuard 影响大，APT 生成的代码更稳定
javax.annotation.processing 相关 API 只在 compile-time classpath 有效，打不出 jar 包运行

为什么 @Repeatable 注解取不到多个实例？

因为 JVM 不直接支持重复注解——它其实是语法糖。你写的 @Role("admin") @Role("user")，编译后会被转成一个容器注解（如 @Roles({@Role("admin"), @Role("user")})）。所以不能用 getAnnotation(Role.class) 拿全部，得用 getAnnotationsByType(Role.class)。

注意点：