news 2026/6/10 19:21:10

Java 注解与反射实战:自定义注解从入门到精通

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Java 注解与反射实战:自定义注解从入门到精通

来了,这一篇我们直接走**“从 0 到能写框架级代码”的路线 😎
不是只讲语法,而是
注解 + 反射 = 真正能干活的武器**


Java 注解与反射实战

自定义注解从入门到精通

一句话定位
看完这篇,你能读懂 Spring 注解原理,也能自己造一个轻量框架


一、为什么 Java 离不开注解 + 反射?

先看一个熟到不能再熟的东西👇

@RestController@RequestMapping("/user")publicclassUserController{}

问题是:

  • Java本身不会“认识”注解
  • 真正起作用的,是——反射

👉 本质公式:

注解 = 元数据
反射 = 读取 + 执行元数据


二、注解基础速通(必须掌握)

1️⃣ 注解是什么?

注解是一种写在代码里的结构化配置

@Override

✔ 不影响代码逻辑
✔ 可被工具 / 框架读取
✔ 比 XML / 配置文件更安全


2️⃣ 注解能写在哪?

位置Target
TYPE
方法METHOD
成员变量FIELD
参数PARAMETER
构造器CONSTRUCTOR

三、元注解(定义注解的注解)⭐ 必背

@Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)public@interfaceMyAnnotation{}

四大核心元注解

元注解作用
@Target注解能用在哪
@Retention生命周期
@Documented是否进 javadoc
@Inherited子类是否继承

Retention 三种级别(高频考点)

类型说明
SOURCE编译后丢弃
CLASS编译进 class,不运行
RUNTIME运行期可反射(最重要)

📌只要和反射有关,必须是 RUNTIME


四、自定义注解入门(动手)

1️⃣ 定义一个注解

@Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)public@interfaceLog{Stringvalue()default"";}

规则:


2️⃣ 使用注解

@Log("用户登录")publicvoidlogin(){}

五、反射基础(注解的发动机)

1️⃣ 获取 Class 对象

Class<?>clazz=UserService.class;

2️⃣ 获取方法 & 注解

Methodmethod=clazz.getDeclaredMethod("login");Loglog=method.getAnnotation(Log.class);System.out.println(log.value());

👉注解此刻才真正“生效”


六、完整实战:自定义日志注解 ⭐⭐⭐

🎯 目标


1️⃣ 注解定义

@Target(ElementType.METHOD)@Retention(RetentionPolicy.RUNTIME)public@interfaceLog{Stringvalue();}

2️⃣ 业务方法

publicclassUserService{@Log("执行登录逻辑")publicvoidlogin(){System.out.println("login...");}}

3️⃣ 反射处理器(核心)

publicclassLogProcessor{publicstaticvoidprocess(Objectobj)throwsException{Class<?>clazz=obj.getClass();for(Methodmethod:clazz.getDeclaredMethods()){if(method.isAnnotationPresent(Log.class)){Loglog=method.getAnnotation(Log.class);System.out.println("日志:"+log.value());method.invoke(obj);}}}}

4️⃣ 调用

LogProcessor.process(newUserService());

🎉一个注解驱动功能完成


七、进阶:注解 + 反射的 5 个高级用法

1️⃣ 参数校验(Hibernate Validator 原理)

@NotNull@Length(max=20)

2️⃣ 权限控制

@RequireRole("ADMIN")

3️⃣ 自动注入(IOC 雏形)

@InjectprivateUserServiceuserService;

4️⃣ 接口映射(Spring MVC 原理)

@RequestMapping("/login")

5️⃣ 配置替代 XML

约定 > 配置 > 注解


八、注解 vs 接口 vs 抽象类(别搞混)

对比注解接口
是否有逻辑
是否强约束
主要用途元数据行为规范

📌注解不参与继承体系


九、常见坑(面试 + 实战)

1️⃣ 忘记Retention.RUNTIME
2️⃣ 用反射却拿不到注解
3️⃣getMethodvsgetDeclaredMethod混用
4️⃣ 注解不是魔法,没反射=没用
5️⃣ 过度设计,小项目别滥用


十、一句话终极总结(建议背)

注解是标签,反射是解释器
没有反射,注解只是注释


下一步你可以继续冲 🚀

我可以直接带你:

你想往框架原理 / 实战项目 / 面试突击哪个方向继续?

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!
网站建设 2026/6/10 10:44:57

视频监控中UVC协议配置:操作指南

以下是对您提供的博文内容进行 深度润色与结构重构后的技术文章 。整体风格已全面转向 专业、自然、有温度的技术分享体 ,彻底去除AI生成痕迹,强化工程现场感与教学逻辑性,同时严格遵循您提出的全部格式与表达规范(如禁用模板化标题、避免“首先/其次”式连接词、融合原…

作者头像 李华
网站建设 2026/6/10 12:10:27

1小时打造Git合并可视化工具:快马平台实战

快速体验 打开 InsCode(快马)平台 https://www.inscode.net输入框内输入如下内容&#xff1a; 快速开发一个Git合并可视化工具原型&#xff0c;要求&#xff1a;1.实时展示分支图 2.高亮显示合并冲突 3.支持简单合并操作 4.生成合并报告 5.响应式设计。使用Vue.js前端FastAPI…

作者头像 李华
网站建设 2026/6/10 10:46:07

WSL升级小白指南:从错误提示到成功解决

快速体验 打开 InsCode(快马)平台 https://www.inscode.net输入框内输入如下内容&#xff1a; 开发一个交互式WSL升级教学应用&#xff0c;功能包括&#xff1a;1)分步引导界面 2)命令解释弹窗 3)错误模拟与解决演示 4)知识测验环节。使用Vue.js开发Web应用&#xff0c;内置动…

作者头像 李华
网站建设 2026/6/10 10:40:55

wscript.exe文件丢失找不到 免费下载方法分享

在使用电脑系统时经常会出现丢失找不到某些文件的情况&#xff0c;由于很多常用软件都是采用 Microsoft Visual Studio 编写的&#xff0c;所以这类软件的运行需要依赖微软Visual C运行库&#xff0c;比如像 QQ、迅雷、Adobe 软件等等&#xff0c;如果没有安装VC运行库或者安装…

作者头像 李华
网站建设 2026/6/10 19:14:31

零基础学C#异步编程:Task入门指南

快速体验 打开 InsCode(快马)平台 https://www.inscode.net输入框内输入如下内容&#xff1a; 编写一个面向初学者的C# Task教学程序&#xff0c;包含&#xff1a;1) Task基本概念图解&#xff1b;2) 3个难度递增的示例(单任务、多任务、异常处理)&#xff1b;3) 交互式练习&…

作者头像 李华