Java 自定义注解中怎么利用元注解(Retention与Target)定义元数据

小敏大大_5656

小敏大大_5656

2026-07-29

938人浏览

原创

@retention和@target是最核心的两个元注解,前者控制注解生命周期(source/class/runtime),后者限定作用位置(如method、type等),共同决定注解能否被反射读取及适用场景。

java 自定义注解中怎么利用元注解(retention与target)定义元数据

Java 自定义注解需要通过元注解来声明其行为和作用范围,其中 @Retention 和 @Target 是最核心的两个元注解。它们分别控制注解的生命周期(保留在哪一阶段)和可应用的位置(类、方法、字段等),直接影响注解能否被反射读取、是否参与编译或生成字节码。

Retention:决定注解保留策略

@Retention 指定注解在哪个阶段还存在,有三个可选值:

  • RetentionPolicy.SOURCE:仅保留在源码中,编译时丢弃(如 @Override)。无法通过反射获取。
  • RetentionPolicy.CLASS:保留在 class 文件中,但 JVM 不加载(默认策略)。运行时不可见,适用于字节码处理工具(如 ASM)。
  • RetentionPolicy.RUNTIME:保留在 class 文件中且被 JVM 加载,可通过反射获取。这是自定义注解做运行时逻辑(如权限校验、序列化配置)的前提。

例如,若想用反射读取注解,必须显式声明:
@Retention(RetentionPolicy.RUNTIME)

Target:限定注解使用位置

@Target 规定该注解能标注在哪些程序元素上,避免误用。常用 ElementType 值包括:

OpenJDK 24
OpenJDK 24

OpenJDK 24 Windows x64 官方参考实现(24+36),适合 Windows 环境进行 Java 开发、编译、运行和版本兼容性验证。

下载
  • ElementType.TYPE:类、接口、枚举、注解类型
  • ElementType.METHOD:方法
  • ElementType.FIELD:字段(含 enum 常量)
  • ElementType.PARAMETER:方法参数
  • ElementType.CONSTRUCTOR:构造方法
  • ElementType.ANNOTATION_TYPE:注解类型本身(用于定义元注解)

支持多个位置时用数组形式:
@Target({ElementType.METHOD, ElementType.TYPE})

组合使用示例

一个典型的运行时方法级注解定义如下:

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.METHOD)
public @interface LogExecutionTime {
    String value() default "default";
}

这样定义后,该注解只能加在方法上,且可在运行时通过 Method.getAnnotation(LogExecutionTime.class) 获取。

注意事项

  • 不加 @Retention 时,默认为 CLASS,反射无法读取 —— 这是新手常见疏漏。
  • 不加 @Target 时,默认允许标注在所有位置,可能引发语义混乱或编译器警告。
  • 若注解自身也要被其他注解修饰(比如作为元注解),需额外加上 @Target(ElementType.ANNOTATION_TYPE)。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

10397

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7522

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6592

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1124

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

928

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1376

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2729

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20051

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1215

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习