当前位置：首页 > news >正文

《Java 100 天进阶之路》第26篇：Java注解（Annotation）详解

news 2026/5/28 6:10:12

第26篇：Java注解（Annotation）详解

📌系列导航：《Java 100 天进阶之路》完整目录 |
⬅️ 上一篇：第25篇：Java类加载与初始化 |
➡️ 下一篇：第27篇：Java代理类详解👈待发布

一、核心知识点

注解的定义：元数据，为程序元素（类、方法、字段）添加标记或配置
内置注解：@Override、@Deprecated、@SuppressWarnings、@FunctionalInterface
元注解：@Target、@Retention、@Documented、@Inherited、@Repeatable
自定义注解的声明与使用
注解的保留策略（SOURCE、CLASS、RUNTIME）
注解的解析：通过反射读取注解信息

二、通俗讲解（1分钟开心学）

1. 什么是注解？

注解是 Java 5 引入的一种特殊“标记”，可以附加在类、方法、字段等元素上，用来提供额外的元数据。它不影响程序的直接运行，但可以被编译器、工具或框架读取，用来生成代码、进行校验、配置等。

2. 常见内置注解

@Override：告诉编译器该方法重写了父类方法，如果父类没有该方法会编译报错。
@Deprecated：标记某个元素已过时，使用时会编译警告。
@SuppressWarnings：抑制编译器警告。
@FunctionalInterface：标记函数式接口（Java 8），只允许一个抽象方法。

3. 元注解——用来定义注解的注解

@Target：限制注解可以放在哪里（类、方法、字段等）。
@Retention：注解保留到什么时候（源码、字节码、运行时）。
@Documented：是否生成到 Javadoc 中。
@Inherited：子类是否继承父类的注解。
@Repeatable：允许同一个位置重复使用同一个注解（Java 8）。

4. 自定义注解

public@interfaceMyAnnotation{Stringvalue()default"";// 注解属性intcount()default1;}

5. 注解的解析

如果保留策略是RUNTIME，可以通过反射获取注解信息，这是 Spring、JUnit 等框架的基础。

生活类比：
注解就像商品上的标签。@Override是“保修标签”，告诉检查员这是原厂零件。@Deprecated是“停产清仓”标签，提醒大家尽量别买。自定义注解就像你自己贴的“易碎品”标签，只有你（框架）能看懂并处理。

三、实操代码案例 + 场景说明

场景：自定义一个@Test注解，模拟单元测试框架，在运行时自动执行标注了@Test的方法。

importjava.lang.annotation.*;importjava.lang.reflect.Method;// 1. 自定义注解@Retention(RetentionPolicy.RUNTIME)// 保留到运行时@Target(ElementType.METHOD)// 只能用在方法上@interfaceTest{Stringdescription()default"";}// 2. 使用注解的测试类classMyTest{@Test(description="测试加法")publicvoidtestAdd(){System.out.println("执行 testAdd");}@TestpublicvoidtestSub(){System.out.println("执行 testSub");}publicvoidnormalMethod(){System.out.println("普通方法，不执行");}}// 3. 解析注解，运行测试publicclassAnnotationDemo{publicstaticvoidmain(String[]args)throwsException{MyTestobj=newMyTest();Method[]methods=obj.getClass().getDeclaredMethods();for(Methodmethod:methods){if(method.isAnnotationPresent(Test.class)){TesttestAnno=method.getAnnotation(Test.class);System.out.println("发现测试方法："+method.getName());if(!testAnno.description().isEmpty()){System.out.println(" 描述："+testAnno.description());}method.invoke(obj);// 执行方法}}}}

四、避坑要点

错误/误区	后果	正确做法
注解的`@Retention`设为`SOURCE`或`CLASS`，但运行时用反射读取	读不到注解	需要运行时读取必须设为`RUNTIME`
`@Target`不限制，注解用在不合适的位置	语义混乱	明确指定`@Target`
注解属性名为`value`时，使用时可以省略属性名，但容易忘记	代码可读性下降	属性名清晰时不要都叫`value`
重复注解未配置`@Repeatable`和容器注解	编译错误	按规范定义

五、面试高频考点

Q1：@Override注解的作用是什么？

标记该方法重写父类方法，编译器会检查父类是否有该方法，如果没有则报错，避免写错方法名或参数。

Q2：@Retention的三种策略有什么区别？

SOURCE：只在源码中保留，编译后丢弃（如@Override）。CLASS：保留在字节码中，但运行时不可见（默认）。RUNTIME：保留到运行时，可通过反射读取（如 Spring 注解）。

Q3：如何获取一个方法上的注解值？

通过反射：Method method = ...; MyAnnotation anno = method.getAnnotation(MyAnnotation.class); String value = anno.value();

六、练习题

设计：自定义一个@NotNull注解，用于标记方法的参数不能为 null，然后写一个处理器在运行时检查。
代码分析：下面注解能否正常工作？为什么？
```
@Retention(RetentionPolicy.CLASS)@interfaceMyAnno{}
```
动手：实现一个简单的“权限注解”，在方法上标注@RequireRole("admin")，然后在调用时检查当前用户角色。