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

Spring 中使用代理的注解及机制分析

article 2025/3/18 20:20:55

在这里插入图片描述

Spring 通过动态代理（JDK 或 CGLIB）为特定注解提供功能增强。以下是触发代理的核心注解及其实现机制：

一、事务管理相关

注解	代理机制	作用与场景	注意事项
`@Transactional`	JDK 动态代理或 CGLIB（默认优先 JDK）	声明式事务管理，标注在类或方法上，控制事务的提交、回滚和传播行为。	- 需通过代理调用，同类方法直接调用会导致事务失效。 - 默认仅对 `RuntimeException` 回滚，需显式配置其他异常。
`@EnableTransactionManagement`	无直接代理，启用事务管理支持	配合 `@Transactional` 使用，启用基于代理的事务管理。	需与 `@Configuration` 类结合使用。

示例：

@Service
public class OrderService {
    @Transactional
    public void createOrder(Order order) {
        // 数据库操作（代理拦截事务）
    }
}

二、异步任务相关

注解	代理机制	作用与场景	注意事项
`@Async`	JDK 动态代理或 CGLIB（默认优先 JDK）	标注方法或类，异步执行任务（通过线程池）。	- 同类调用需通过代理触发异步逻辑（如 `AopContext.currentProxy()`）。 - 需启用 `@EnableAsync`。
`@EnableAsync`	无直接代理，启用异步支持	配合 `@Async` 使用，激活异步代理生成。	可配置线程池参数。

示例：

@Service
public class TaskService {
    @Async
    public void processTask() {
        // 异步执行（代理拦截并提交到线程池）
    }
}

三、缓存相关

注解	代理机制	作用与场景	注意事项
`@Cacheable`	JDK 动态代理或 CGLIB（默认优先 JDK）	标注方法，缓存方法返回值（根据 Key 匹配缓存）。	- 同类调用需通过代理触发缓存逻辑。 - 需启用 `@EnableCaching`。
`@CachePut`	同上	更新缓存数据（无论缓存是否存在）。	需与 `@Cacheable` 配合使用。
`@CacheEvict`	同上	清除指定缓存条目。	可配置 `allEntries` 清空所有缓存。
`@EnableCaching`	无直接代理，启用缓存支持	激活缓存代理生成。	需配置缓存管理器（如 Redis）。

示例：

@Service
public class UserService {
    @Cacheable(value = "users", key = "#userId")
    public User getUser(String userId) {
        // 数据库查询（代理拦截并缓存结果）
    }
}

四、AOP 切面相关

注解	代理机制	作用与场景	注意事项
`@Aspect`	JDK 动态代理或 CGLIB（默认优先 JDK）	定义切面类，包含通知（`@Before`、`@Around` 等）和切入点（`@Pointcut`）。	- 需启用 `@EnableAspectJAutoProxy`。 - 同类调用需通过代理触发切面逻辑。
`@EnableAspectJAutoProxy`	无直接代理，启用 AspectJ 自动代理	激活 AOP 代理生成，可配置 `proxyTargetClass=true` 强制使用 CGLIB。	通常与 `@Configuration` 类结合使用。

示例：

@Aspect
@Component
public class LogAspect {
    @Before("execution(* com.xiaolingting.service.*.*(..))")
    public void logBefore(JoinPoint joinPoint) {
        // 日志记录（代理拦截方法调用）
    }
}

五、配置类代理

注解	代理机制	作用与场景	注意事项
`@Configuration`	CGLIB 代理（Full 模式）	标注配置类，声明 `@Bean` 方法，通过代理拦截 `@Bean` 方法调用，确保单例依赖正确注入。	- 无此注解时为 Lite 模式（无代理，直接调用）。 - 需避免在 `@Bean` 方法中直接调用其他 `@Bean` 方法。
`@Bean`	依赖 `@Configuration` 的代理机制	声明 Bean 实例化逻辑。	在 `@Configuration` 类中通过代理保证单例。

示例：

@Configuration
public class AppConfig {
    @Bean
    public UserService userService() {
        return new UserServiceImpl(orderService()); // 代理确保单例
    }

    @Bean
    public OrderService orderService() {
        return new OrderServiceImpl();
    }
}

六、安全相关

注解	代理机制	作用与场景	注意事项
`@PreAuthorize`	JDK 动态代理或 CGLIB（默认优先 JDK）	方法级权限控制（需 Spring Security 支持）。	- 需启用 `@EnableGlobalMethodSecurity(prePostEnabled = true)`。
`@Secured`	同上	基于角色的权限控制。	需显式启用 `@EnableGlobalMethodSecurity(securedEnabled = true)`。

示例：

@Service
public class AdminService {
    @PreAuthorize("hasRole('ADMIN')")
    public void deleteUser(String userId) {
        // 仅管理员可调用（代理拦截权限校验）
    }
}

七、重试机制

注解	代理机制	作用与场景	注意事项
`@Retryable`	JDK 动态代理或 CGLIB（默认优先 JDK）	标注方法，在抛出指定异常时重试（需 Spring Retry 支持）。	- 需启用 `@EnableRetry`。 - 可配置重试次数和退避策略。

示例：

@Service
@EnableRetry
public class PaymentService {
    @Retryable(value = PaymentException.class, maxAttempts = 3)
    public void processPayment() {
        // 支付失败时自动重试（代理拦截重试逻辑）
    }
}