Java基础@Retention如何创建注解？-java教程-PHP中文网

Java基础@Retention如何创建注解？

冷漠man

发布： 2025-12-09 11:07:02

原创

636人浏览过

@Retention是Java中指定注解保留策略的元注解，不创建注解而控制其生命周期：SOURCE（仅源码）、CLASS（默认，.class中但运行时不可见）、RUNTIME（.class中且反射可读）。

java基础@retention如何创建注解？

@Retention 是 Java 中用来指定注解保留策略的元注解，它**不负责创建注解本身**，而是控制你自定义的注解在什么阶段还“有效”——比如编译期、运行时，还是仅在源码中存在。

先创建一个注解（用 interface + @interface）

Java 注解本质是一个特殊的接口，用 @interface 声明：

public @interface MyLog {
    String value() default "log";
    int level() default 1;
}

登录后复制

这样就定义了一个带两个属性的注解 @MyLog。但此时它默认只保留在源码阶段（RetentionPolicy.SOURCE），运行时 getAnnotation() 拿不到。

用 @Retention 指定注解生命周期

要在运行时通过反射获取该注解，必须显式加上 @Retention(RetentionPolicy.RUNTIME)：

立即学习“Java免费学习笔记（深入）”；

@Retention(RetentionPolicy.RUNTIME)
public @interface MyLog {
    String value() default "log";
    int level() default 1;
}

登录后复制

常用保留策略有三个：

Voicepods

Voicepods是一个在线文本转语音平台，允许用户在30秒内将任何书面文本转换为音频文件。

142

查看详情

SOURCE：只保留在源代码中，编译后丢弃（如 @Override）
CLASS：保留在 .class 文件中，但运行时不可见（默认值）
RUNTIME：保留在 .class 中且可通过反射读取（写框架、AOP、ORM 时必需）

搭配 @Target 明确使用位置（推荐一起用）

单独用 @Retention 不够，你还得告诉编译器这个注解能加在哪儿，比如类、方法、参数等：

@Retention(RetentionPolicy.RUNTIME)
@Target({ElementType.METHOD, ElementType.TYPE})
public @interface MyLog { ... }

登录后复制

常见 ElementType 值：

TYPE → 类、接口、枚举
METHOD → 方法
FIELD → 成员变量
PARAMETER → 方法参数
LOCAL_VARIABLE → 局部变量（很少用）

验证注解是否生效（运行时反射）

加了 @Retention(RUNTIME) 后，就能在运行时读取：

@MyLog(level = 2)
public class UserService {
    @MyLog("update user")
    public void update() { ... }
}

// 反射获取
MyLog anno = UserService.class.getAnnotation(MyLog.class);
System.out.println(anno.level()); // 输出 2

登录后复制

如果没加 @Retention(RUNTIME)，这里会返回 null。

基本上就这些。@Retention 不是“创建”注解的步骤，而是让注解“活到你需要的时候”的关键配置。

以上就是Java基础@Retention如何创建注解？的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

高效处理不同长度列表的策略：确保所有元素被考量 Java反射机制：实现基于用户输入的动态多参数对象创建 Micronaut中动态类属性的类型安全验证策略 Java中灵活获取滚动24小时内记录的策略在Java中灵活获取过去24小时内创建的记录