闲话元注解@Retention

最新推荐文章于 2025-06-25 11:47:27 发布

原创最新推荐文章于 2025-06-25 11:47:27 发布 · 941 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#Java注解 #Retention #java

Android基础专栏收录该内容

20 篇文章

订阅专栏

本文详细解析Java元注解@Retention的三种级别：SOURCE、CLASS和RUNTIME，通过实例展示不同级别下注解的存在形式及应用，帮助理解注解在编译期和运行期的作用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

元注解@Retention

元注解是用来描述注解的。@Retention用来描述注解将会在哪个层次存在，有三个值：

RetentionPolicy.SOURCE：只会在java文件中存在，class文件中就不可见了。可以被编译器使用
RetentionPolicy.CLASS：会在class中可见，不需要被虚拟机加载。编译时可见
RetentionPolicy.RUNTIME：在class中可见，会被虚拟机加载。编译时可见，运行时可见

下面以一个例子来区分三个值。

Demo

定义一个注解：

@Target(ElementType.FIELD)
@Retention(RetentionPolicy.XXX)
public @interface MyTest {
}

一个类使用了这个注解：

public class MyClass {

    @MyTest
    int val;

}

一个类来获取Field然后获取注解，输出，

try {
            Field field = MyClass.class.getDeclaredField("val");
            Annotation[] annos = field.getAnnotations();
            for (int i = 0; i < annos.length; i++) {
                System.out.println(annos[i].toString());
            }
        } catch (NoSuchFieldException e) {
            e.printStackTrace();
        }

RetentionPolicy.SOURCE

当@Retention注解的值是这个时，编译MyClass得到的class文件如下：

public class MyClass {
    int val;

    public MyClass() {
    }
}

可以看到class文件中没有注解的信息。那这种有什么应用场景呢？

答案是APT（Annotation Process Tool），这个工具的输入是java源文件，因此对于APT而言，是可以看到注解的。
这种情况下，执行程序，输出为空，因为class文件中连注解都没有，肯定是拿不到的。

RetentionPolicy.CLASS

修改为这个后，编译后的class如下：

public class MyClass {
    @MyTest
    int val;

    public MyClass() {
    }
}

可以看到，这个时候，出现了@MyTest注解。但是执行程序，依然输出为空，这是因为java虚拟机加载该类时，没把注解加载进去。

此种的场景使用参考自：

这里很重要的一点是编译多个Java文件时的情况：假如要编译A.java源码文件和B.class文件，其中A类依赖B类，并且B类上有些注解希望让A.java编译时能看到，那么B.class里就必须要持有这些注解信息才行。同时我们可能不需要让它在运行时对反射可见（例如说为了减少运行时元数据的大小之类），所以会选择CLASS而不是RUNTIME。–知乎:RednaxelaFX