Java 注解（Annotation）：从原理到实战应用

1. 注解基础原理

Java 注解本质是元数据（metadata），通过@interface关键字定义，继承java.lang.annotation.Annotation接口。其核心原理包含：

• 保留策略：通过元注解@Retention指定生命周期：
  • SOURCE：仅存于源码（如@Override）
  • CLASS：编译后保留（默认策略）
  • RUNTIME：运行时可通过反射获取
• 作用目标：@Target限定应用范围，例如：

  @Target(ElementType.METHOD) // 仅作用于方法
  

• 注解元素：支持基本类型、String、Class、枚举等：

  public @interface Loggable {
      String level() default "INFO"; // 带默认值的元素
  }
  

2. 元注解深度解析

元注解用于修饰其他注解：

• @Documented：纳入Javadoc
• @Inherited：允许子类继承父类注解
• @Repeatable（Java 8+）：同一位置重复使用注解

  @Repeatable(Schedules.class)
  public @interface Schedule {
      String cron();
  }
  

3. 运行时注解处理

通过反射机制处理RUNTIME级别注解：

Method method = obj.getClass().getMethod("test");
if (method.isAnnotationPresent(Loggable.class)) {
    Loggable log = method.getAnnotation(Loggable.class);
    System.out.println("Log level: " + log.level());
}

4. 编译时注解处理

使用AbstractProcessor实现编译期代码生成：

@SupportedAnnotationTypes("com.example.NotNull")
public class NotNullProcessor extends AbstractProcessor {
    @Override
    public boolean process(Set<? extends TypeElement> annotations, 
                          RoundEnvironment roundEnv) {
        // 生成代码逻辑
        return true;
    }
}

5. 实战应用场景

场景 1：API 参数校验

public class User {
    @NotNull(message = "Name cannot be null")
    private String name;
    
    @Min(value = 18, message = "Age must be >= 18")
    private int age;
}

场景 2：Spring 依赖注入

@RestController
public class UserController {
    @Autowired
    private UserService userService;
    
    @GetMapping("/users/{id}")
    public User getUser(@PathVariable Long id) {
        return userService.findById(id);
    }
}

场景 3：自定义日志注解

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

// AOP 实现
@Aspect
@Component
public class LogAspect {
    @Around("@annotation(LogExecutionTime)")
    public Object logTime(ProceedingJoinPoint pjp) throws Throwable {
        long start = System.currentTimeMillis();
        Object result = pjp.proceed();
        System.out.println("Execution time: " + (System.currentTimeMillis() - start) + "ms");
        return result;
    }
}

6. 性能优化建议

• 减少RUNTIME注解：反射调用成本高
• 预编译处理：使用APT（Annotation Processing Tool）生成代码
• 注解缓存：对反射获取的注解结果进行缓存

7. 最佳实践总结

公式说明：
注解处理器执行顺序满足： $$T_{\text{process}} = O(n) + C_{\text{meta}}$$ 其中 $n$ 是注解元素数量，$C_{\text{meta}}$ 为元注解解析常数时间。

通过合理运用注解，可显著提升代码可读性和框架扩展性。建议优先使用编译期注解处理，运行时注解应控制使用范围以保证性能。