在Java中什么是注解_Java元数据机制解析_技术教程

注解是程序可读的元数据而非注释，需处理器（如编译器、反射）才生效；自定义注解须声明@Target、@Retention及合法属性，运行时读取需反射并判空。

注解本身不执行任何逻辑，它只是代码的“标签”——就像你给文件夹贴上“紧急”便签，便签不会自动帮你做事，但你能一眼识别优先级；同理，@Override 不重写方法，@Deprecated 不禁用方法，它们只提供元数据，真正起作用的是编译器或运行时读取这些标签后做的判断和处理。

注解不是注释，是程序可读的元数据

很多人第一眼把 @Override 当成高级注释，这是最大误区。注释（// 或 /** */）在编译时被完全丢弃，JVM 看不见；而注解默认保留在 .class 文件里（@Retention(RetentionPolicy.CLASS)），甚至能活到运行时（RUNTIME），供反射调用。

注释 → 给人看，编译器无视
注解 → 给程序看，必须有处理器（编译器、APT、反射）才生效
没写处理器的自定义注解，就等于贴了张没人认的标签——语法合法，但毫无作用

自定义注解三要素：@Target、@Retention、属性声明

定义一个可用的注解，光写 @interface MyAnno 不够，必须明确：它能标在哪（类？方法？参数？）、保留到哪一阶段（源码？字节码？运行时？）、带哪些参数。

@Target({ElementType.METHOD, ElementType.TYPE})：限制只能用在方法或类上，标在字段会编译报错
@Retention(RetentionPolicy.RUNTIME)：这是反射读取的前提；若设
为 SOURCE，连 .class 里都没有，反射必然拿不到
属性必须是接口方法形式，返回类型受限（基本类型、String、Class、枚举、其他注解、以上类型数组），不能是 List 或自定义对象

import java.lang.annotation.*;
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
public @interface LogExecutionTime {
String value() default "default";
int thresholdMs() default 100;
}

运行时读取注解必须靠反射，且要检查存在性

即使注解保留策略是 RUNTIME，也不代表一定能读到——你得先拿到目标元素的反射对象（Class、Method、Field），再调用 getAnnotation()。漏掉 isAnnotationPresent() 直接强转，容易抛 NullPointerException。

类上的注解：用 clazz.getAnnotation(MyAnno.class)
方法上的注解：先 Method m = clazz.getDeclaredMethod("xxx");，再 m.getAnnotation(MyAnno.class)
务必判空：反射返回 null 是常态，不是异常