在Java中注解的本质是什么_Java注解原理解析

小浩姑娘_6522

小浩姑娘_6522

2026-01-14

374人浏览

原创

注解本质是继承java.lang.annotation.Annotation的接口,编译后为interface字节码,运行时通过动态代理(AnnotationInvocationHandler)实现,属性值从RuntimeVisibleAnnotations属性表读取。

在java中注解的本质是什么_java注解原理解析

注解本质就是 interface,不是类也不是抽象类

Java 中的注解(比如 @Override、@Test 或自定义的 @MyLog)编译后**100% 是一个继承 java.lang.annotation.Annotation 的接口**,不是 class,也不是 abstract class。你可以用 IDEA 右键 → “Go to → Type Hierarchy”,会清楚看到它底下直接 extends Annotation;反编译 .class 文件也能确认:字节码里是 interface MyAnno extends Annotation,调用其方法用的是 INVOKEINTERFACE 指令——这是接口的铁证。

  • 它不能有实现体、不能有字段、不能继承其他接口或类(语法强制)
  • 每个属性(如 String value())都是接口里的抽象方法
  • 默认值(default "abc")由编译器在字节码中固化,运行时由代理对象“兜底返回”

运行时拿到的注解对象其实是 JDK 动态代理实例

当你写 clazz.getDeclaredAnnotation(MyAnno.class),返回的不是真实类的实例,而是一个形如 $Proxy1 的代理对象,背后是 sun.reflect.annotation.AnnotationInvocationHandler ——它实现了 InvocationHandler,把所有方法调用(比如 anno.value())转成从字节码属性表中查常量值。

  • 这意味着:注解对象不可序列化(AnnotationInvocationHandler 未实现 Serializable)
  • 也意味着:你不能用 == 或 equals() 比较两个同内容注解实例(它们是不同代理对象)
  • 如果你在单元测试里 mock 注解行为,得 mock 接口本身,而不是“构造一个注解类”——它根本没法 new

注解信息存在哪?全靠字节码里的 RuntimeVisibleAnnotations

只有 @Retention(RetentionPolicy.RUNTIME) 的注解,才会被 javac 写进 class 文件的 RuntimeVisibleAnnotations 属性表;CLASS 级别写进 RuntimeInvisibleAnnotations;SOURCE 级别编译完就丢弃,连 .class 都没留痕。

Java 接口排错助手
Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能,尤其适用于以下任务:分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转,以及生成简洁的诊断结论与修复方案。

下载
  • 你可以用 javap -v MyClass.class | grep -A 20 "RuntimeVisibleAnnotations" 直接看到注解原始数据(十六进制编码的属性名/值)
  • 反射 API(如 getAnnotations())本质就是读这个属性表 + 调用 Proxy.newProxyInstance() 构建代理
  • 所以:没有 @Retention(RUNTIME),反射就永远拿不到;加了但没写对作用域(比如标在 private 字段上却用 getMethodAnnotations()),也会为空

自定义注解时最容易忽略的三个硬约束

很多人写完注解一运行就报错,往往卡在底层类型限制上——这不是框架问题,而是 JVM 字节码规范死锁的规则。

  • 属性类型只能是:基本类型、String、Class、枚举、其他注解,或它们的**一维数组**;List、Map、Object[]、int[][] 全都不合法
  • default 值必须是编译期常量:不能是 new String("x")、不能是静态变量、不能是方法调用(哪怕该方法返回 const)
  • value() 方法有特殊地位:当注解只含一个 value 属性时,使用可省略参数名(@MyAnno("ok"));但一旦加了第二个属性,就必须显式写全(@MyAnno(value="ok", level=2))

注解本身不干活,它只是贴在代码上的“元数据标签”。真正让它活起来的,是编译器的写入动作、JVM 的属性表解析、反射的代理构建,以及你写的处理逻辑——漏掉其中任一环,注解就只是源码里一段安静的 @ 符号。

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

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

6959

3

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6224

49

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2338

7

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.02

6959

3

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.08.29

3325

6

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

2025.08.29

4348

10

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

2025.08.29

2965

10

硬盘接口类型介绍
硬盘接口类型介绍

硬盘接口类型有IDE、SATA、SCSI、Fibre Channel、USB、eSATA、mSATA、PCIe等等。详细介绍:1、IDE接口是一种并行接口,主要用于连接硬盘和光驱等设备,它主要有两种类型:ATA和ATAPI,IDE接口已经逐渐被SATA接口;2、SATA接口是一种串行接口,相较于IDE接口,它具有更高的传输速度、更低的功耗和更小的体积;3、SCSI接口等等。

2023.10.19

3208

3

PHP接口编写教程
PHP接口编写教程

本专题整合了PHP接口编写教程,阅读专题下面的文章了解更多详细内容。

2025.10.17

5189

12

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习