0

0

Java注解(Annotation)的原理是什么_自定义注解与元注解应用

P粉602998670

P粉602998670

发布时间:2026-03-05 13:01:38

|

899人浏览过

|

来源于php中文网

原创

java注解本质是继承annotation的特殊接口,需用元注解声明作用位置和生命周期,运行时通过反射读取,但需配套处理器才能生效。

java注解(annotation)的原理是什么_自定义注解与元注解应用

注解本质是接口,不是“高级注释”

Java 注解不是编译器忽略的普通注释,而是编译后仍保留在 .class 文件里的特殊接口——它自动继承 java.lang.annotation.Annotation,反编译后能看到 interface MyAnnotation extends Annotation。这意味着:你不能 new 它,也不能直接调用方法,只能通过反射获取实例。

  • @interface 就是在定义一个接口,不是语法糖,是 JVM 层面的约定
  • 注解字段只能是基本类型、StringClass、枚举、其他注解,或以上类型的数组;不支持泛型、lambda、null 默认值
  • 没加 @Retention(RetentionPolicy.RUNTIME) 的注解,默认只到 CLASS 阶段,运行时 getAnnotations() 拿不到,这是最常踩的空指针坑

@Target 和 @Retention 必须配对使用才有效

自定义注解光声明没用,必须用元注解明确“能标在哪”和“活到什么时候”。比如想让注解在 Spring AOP 中生效,就得保证它能被运行时读取,并且允许标在方法上。

  • @Target({ElementType.METHOD, ElementType.TYPE}):表示只能用在方法或类上;若漏写 ElementType.METHOD 却标在方法上,编译直接报错 Invalid type for the annotation
  • @Retention(RetentionPolicy.RUNTIME):缺了它,Method.getAnnotation(MyAnnotation.class) 永远返回 null,哪怕代码里明明写了
  • 常见误配:@Retention(RetentionPolicy.SOURCE) + @Target(ElementType.METHOD) —— 这种组合只对 IDE 或 Lombok 有用,运行时完全不可见

运行时读取注解靠反射,但性能有代价

注解本身不执行逻辑,真正干活的是你写的处理代码,通常基于反射遍历类/方法/字段再提取注解。这个过程在类加载或首次调用时发生,会带来开销。

家电小商城网站源码1.0
家电小商城网站源码1.0

家电公司网站源码是一个以米拓为核心进行开发的家电商城网站模板,程序采用metinfo5.3.9 UTF8进行编码,软件包含完整栏目与数据。安装方法:解压上传到空间,访问域名进行安装,安装好后,到后台-安全与效率-数据备份还原,恢复好数据后到设置-基本信息和外观-电脑把网站名称什么的改为自己的即可。默认后台账号:admin 密码:132456注意:如本地测试中127.0.0.1无法正常使用,请换成l

下载
  • 不要在高频方法(如 toString()、getter)里反复调用 getAnnotation();应提前缓存解析结果
  • Spring 的 @Autowired@Value 都是在 Bean 创建阶段集中扫描一次,而不是每次注入都反射查找
  • 注意 isAnnotationPresent()getAnnotation() 轻量,如果只需要判断存在性,别多拿对象

自定义注解+处理器才是闭环,光写注解没意义

写完 @MyLog 不代表日志就自动打了,你还得配套写逻辑:可能是 Spring 的 @Aspect 切面,也可能是 Java Agent 或编译期 APT 工具。没有消费者,注解就是死标签。

立即学习Java免费学习笔记(深入)”;

  • 最简运行时处理示例:if (method.isAnnotationPresent(MyLog.class)) { log.info("called: " + method.getName()); }
  • 若想编译期校验(比如检查参数非空),得用 javax.annotation.processing.Processor + @SupportedAnnotationTypes,这属于 APT 范畴,和运行时反射完全隔离
  • 别把业务逻辑塞进注解接口里——注解里不能写方法体,所有行为必须外置,这是很多人设计混乱的根源
注解不是魔法,它只是把配置从 XML 或 builder 搬到了代码元素旁边;真正难的是怎么让这套标记被正确识别、安全传递、高效消费——尤其是跨模块或框架集成时,RetentionPolicyClassLoader 可见性稍不注意,注解就“消失”了。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

150

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

88

2026.01.26

string转int
string转int

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

930

2023.08.02

c语言中null和NULL的区别
c语言中null和NULL的区别

c语言中null和NULL的区别是:null是C语言中的一个宏定义,通常用来表示一个空指针,可以用于初始化指针变量,或者在条件语句中判断指针是否为空;NULL是C语言中的一个预定义常量,通常用来表示一个空值,用于表示一个空的指针、空的指针数组或者空的结构体指针。

252

2023.09.22

java中null的用法
java中null的用法

在Java中,null表示一个引用类型的变量不指向任何对象。可以将null赋值给任何引用类型的变量,包括类、接口、数组、字符串等。想了解更多null的相关内容,可以阅读本专题下面的文章。

1008

2024.03.01

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

839

2023.08.22

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1941

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2117

2024.08.01

Rust内存安全机制与所有权模型深度实践
Rust内存安全机制与所有权模型深度实践

本专题围绕 Rust 语言核心特性展开,深入讲解所有权机制、借用规则、生命周期管理以及智能指针等关键概念。通过系统级开发案例,分析内存安全保障原理与零成本抽象优势,并结合并发场景讲解 Send 与 Sync 特性实现机制。帮助开发者真正理解 Rust 的设计哲学,掌握在高性能与安全性并重场景中的工程实践能力。

4

2026.03.05

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.1万人学习

C# 教程
C# 教程

共94课时 | 10.7万人学习

Java 教程
Java 教程

共578课时 | 77.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号