什么是注解？#

注解（Annotation）是Java 5引入的一种元编程特性，说白了就是在代码上贴标签，这些标签可以在编译时、类加载时或运行时被读取和处理。@Override、@Deprecated这些大家应该都用过，但真正理解注解的威力是在用了Spring之后。

注解的作用#

1. 提供元数据——给代码加额外信息（作者、版本等）
2. 编译时检查——比如@Override，写错了编译直接报错
3. 代码生成——Lombok的@Getter、@Setter就是靠这个
4. 运行时处理——Spring的@Autowired通过反射读取注解
5. 配置替代——Spring Boot用注解替代XML配置

内置注解#

用于代码的：

• @Override——标记重写父类方法
• @Deprecated——标记已过时
• @SuppressWarnings——抑制编译器警告
• @FunctionalInterface——标记函数式接口（Java 8+）
• @Repeatable——标记注解可重复使用（Java 8+）

元注解（注解的注解）：

• @Target——指定注解能用在什么地方（类、方法、字段等）
• @Retention——保留策略：SOURCE（源码）、CLASS（字节码）、RUNTIME（运行时）
• @Documented——是否包含在Javadoc中
• @Inherited——是否可以被继承

自定义注解#

1
@Target(ElementType.METHOD)
2
@Retention(RetentionPolicy.RUNTIME)
3
public @interface LogExecutionTime {
4
    String value() default "";
5
}

注解的属性类型有限制：基本类型、String、Class、枚举、注解、以及它们的数组。

元注解详解#

注解的处理#

1
@Retention(RetentionPolicy.RUNTIME)
2
@Target(ElementType.TYPE)
3
public @interface Component {
4
    String value() default "";
5
}
6

7
@Component("userService")
8
public class UserService {}
9

10
// 运行时读取注解
11
Class<?> clazz = UserService.class;
12
if (clazz.isAnnotationPresent(Component.class)) {
13
    Component component = clazz.getAnnotation(Component.class);
14
    System.out.println("Component name: " + component.value());
15
}

注解的应用场景#

• 依赖注入：Spring的@Autowired、@Component
• 配置管理：Spring Boot的@Configuration、@Bean
• 方法路由：Spring MVC的@GetMapping、@PostMapping
• 数据验证：JSR-303的@NotNull、@Size、@Email
• 测试框架：JUnit的@Test、@Before
• 代码生成：Lombok的@Data、@Builder

常见陷阱#

1. 保留策略搞错——需要运行时读取但用了SOURCE，反射拿不到
2. @Inherited只对类有效——方法和字段上的注解不会被子类继承
3. 反射获取注解的性能问题——频繁调用性能差，建议缓存结果

💡 实战贴士: 自定义注解如果只需要编译时处理（代码生成），用 RetentionPolicy.SOURCE 就够了，别用RUNTIME，因为运行时反射有性能开销。Lombok的@Getter就是SOURCE级别的，编译完就没了。