注解体系：元注解、自定义注解与运行时处理

public enum RetentionPolicy {
    SOURCE,    // 编译器处理后丢弃
    CLASS,     // 保留在 class 文件，JVM 不加载
    RUNTIME    // 保留在 class 文件，JVM 加载，反射可读
}

public enum ElementType {
    TYPE,           // 类、接口、枚举
    FIELD,          // 字段（成员变量）
    METHOD,         // 方法
    PARAMETER,      // 方法参数
    CONSTRUCTOR,    // 构造方法
    LOCAL_VARIABLE, // 局部变量
    ANNOTATION_TYPE,// 注解类型
    PACKAGE,        // 包
    TYPE_USE,       // 类型使用（JDK 8：泛型、强转等）
    TYPE_PARAMETER // 类型参数（JDK 8：泛型参数声明）
}

// ① 定义容器注解
@interface Roles {
    Role[] value();
}

// ② 定义可重复注解，指定容器
@Repeatable(Roles.class)
@interface Role {
    String value();
}

// ③ 使用：同一个类上标注多次
@Role("admin")
@Role("user")
public class UserService {}

import java.lang.annotation.*;

@Target({ElementType.METHOD})            // 只能标注在方法上
@Retention(RetentionPolicy.RUNTIME)       // 运行时可通过反射获取
@Documented                                // 出现在 Javadoc 中
public @interface Log {
    // 注解属性：描述信息，无默认值（使用时必须指定）
    String value();

    // 注解属性：日志级别，有默认值 INFO
    String level() default "INFO";

    // 注解属性：是否记录参数，默认 true
    boolean logArgs() default true;

    // 注解属性：模块名
    String module() default "";
}

public class OrderService {

    @Log(value = "创建订单", level = "WARN", module = "订单")
    public void createOrder(String orderId) {
        // 业务逻辑...
    }

    @Log("查询订单")   // 只有 value 属性时可以省略属性名
    public void getOrder(String orderId) {
        // 业务逻辑...
    }
}

// 判断是否标注了指定注解
boolean hasLog = method.isAnnotationPresent(Log.class);

// 获取指定注解实例（不存在返回 null）
Log log = method.getAnnotation(Log.class);

// 获取所有注解（包括继承来的）
Annotation[] all = method.getAnnotations();

// 获取直接声明的注解（不包括继承的）
Annotation[] declared = method.getDeclaredAnnotations();

// 获取重复注解（JDK 8+）
Log[] logs = method.getAnnotationsByType(Log.class);

public class LogProcessor {

    public static void process(Class<?> clazz) {
        // 遍历类中所有声明的方法
        for (Method method : clazz.getDeclaredMethods()) {
            // 检查方法是否标注了 @Log
            if (!method.isAnnotationPresent(Log.class)) {
                continue;
            }
            // 获取注解实例并读取属性
            Log log = method.getAnnotation(Log.class);
            String desc = log.value();
            String level = log.level();
            boolean logArgs = log.logArgs();
            String module = log.module();

            // 执行日志记录逻辑
            System.out.printf("[%s] [%s] %s.%s - logArgs=%b%n",
                level, module,
                clazz.getSimpleName(),
                method.getName(),
                logArgs);
        }
    }

    public static void main(String[] args) {
        LogProcessor.process(OrderService.class);
    }
}

public class AutowiredAnnotationBeanPostProcessor
    implements BeanPostProcessor {

    // Spring 在每个 Bean 初始化前调用此方法
    public Object postProcessBeforeInitialization(
            Object bean, String beanName) {

        Class<?> clazz = bean.getClass();

        // ① 扫描所有字段，查找 @Autowired
        for (Field field : clazz.getDeclaredFields()) {
            if (field.isAnnotationPresent(Autowired.class)) {
                // ② 从容器中查找依赖
                Object dependency = findBean(field.getType());
                // ③ 反射注入
                field.setAccessible(true);
                field.set(bean, dependency);
            }
        }
        return bean;
    }
}

// Spring 内部简化伪代码
if (beanClass.isAnnotationPresent(Transactional.class)
    || hasTransactionalMethod(beanClass)) {
    // 为这个 Bean 创建 AOP 代理
    proxy = ProxyFactory.createProxy(bean);
    // 代理拦截方法调用
    proxy.addAdvice(new TransactionInterceptor());
}

// 代理拦截器内部
public Object invoke(MethodInvocation invocation) {
    TransactionAttribute attr =
        getTransactionAttribute(invocation.getMethod());
    try {
        TransactionStatus status = tm.getTransaction(attr);
        Object result = invocation.proceed(); // 执行目标方法
        tm.commit(status);
        return result;
    } catch (RuntimeException e) {
        tm.rollback(status);  // 回滚
        throw e;
    }
}

<!-- XML 方式：独立配置文件 -->
<bean id="userService" class="com.example.UserService">
    <property name="userDao" ref="userDao"/>
</bean>

// 注解方式：嵌入代码
@Service
public class UserService {
    @Autowired
    private UserDao userDao;
}