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

Spring | 深入解析 Spring AOP 中的AopProxyUtils.ultimateTargetClass()解决代理对象注解获取问题

web 2025/6/20 5:58:03

`CodingTechWork`

引言

在使用 Spring AOP（面向切面编程）时，我们经常会遇到一个棘手的问题：在代理对象上调用某些方法时，无法获取到目标类上的注解。这是因为 Spring 的代理机制会创建一个代理对象，而这个代理对象可能并不直接继承目标类的注解。本文将通过 AopProxyUtils.ultimateTargetClass() 方法，深入探讨如何解决这一问题，并提供一个完整的解决方案。

问题背景

在 Spring AOP 中，代理对象的创建方式主要有两种：

JDK 动态代理：基于接口实现的代理。
CGLIB 代理：基于子类实现的代理。

无论是哪种代理方式，代理对象都可能无法直接继承目标类的注解。例如，假设我们有一个目标类 MyService，它有一个注解 @MyCustomAnnotation：

@MyCustomAnnotation
public class MyService {public void doSomething() {// 方法实现}
}

当我们通过 Spring AOP 创建代理对象时，直接调用代理对象的 getClass() 方法，可能会得到一个代理类，而不是目标类 MyService。因此，直接在代理对象上调用 getClass().getAnnotation(MyCustomAnnotation.class) 时，可能会返回 null，导致无法获取到目标类上的注解。

问题演示

定义注解

首先，我们定义一个自定义注解 @MyCustomAnnotation：

import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.TYPE)
public @interface MyCustomAnnotation {
}

定义目标类

然后，我们定义一个目标类 MyService，并在其上添加 @MyCustomAnnotation 注解：

@MyCustomAnnotation
public class MyService {public void doSomething() {System.out.println("Doing something...");}
}

定义配置类

接下来，我们定义一个 Spring 配置类，用于创建 MyService 的 Bean：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;@Configuration
public class AppConfig {@Beanpublic MyService myService() {return new MyService();}
}

测试代码

最后，我们编写测试代码，尝试获取代理对象上的注解：

import org.springframework.context.annotation.AnnotationConfigApplicationContext;public class AnnotationProblemDemo {public static void main(String[] args) {// 创建 Spring 应用上下文AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(AppConfig.class);// 获取代理对象MyService proxy = context.getBean(MyService.class);// 尝试获取注解MyCustomAnnotation annotation = proxy.getClass().getAnnotation(MyCustomAnnotation.class);// 检查注解是否存在if (annotation != null) {System.out.println("注解存在: " + annotation);} else {System.out.println("注解不存在");}// 关闭上下文context.close();}
}

输出结果

运行上述代码，输出结果如下：

Doing something...
注解不存在

可以看到，直接在代理对象上调用 getClass().getAnnotation(MyCustomAnnotation.class) 时，返回了 null，导致无法获取到目标类上的注解。

解决方案：`AopProxyUtils.ultimateTargetClass()`

为了解决这个问题，Spring 提供了一个非常有用的工具类 AopProxyUtils，其中的 ultimateTargetClass() 方法可以穿透所有代理层，直接获取到最终的目标类。牛不牛！这样，我们就可以通过目标类来获取注解，而不是通过代理类。

方法介绍

AopProxyUtils.ultimateTargetClass() 方法的签名如下：

public static Class<?> ultimateTargetClass(Object proxy)

这个方法接受一个代理对象作为参数，返回最终目标类的 Class 对象。它会穿透所有代理层，直到找到最终的目标类。

修改后的测试代码

我们修改测试代码，使用 AopProxyUtils.ultimateTargetClass() 方法获取最终目标类，并通过目标类来获取注解：

import org.springframework.aop.framework.AopProxyUtils;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;public class AnnotationSolutionDemo {public static void main(String[] args) {// 创建 Spring 应用上下文AnnotationConfigApplicationContext context = new AnnotationConfigApplicationContext(AppConfig.class);// 获取代理对象MyService proxy = context.getBean(MyService.class);// 获取最终目标类Class<?> targetClass = AopProxyUtils.ultimateTargetClass(proxy);// 获取目标类上的注解MyCustomAnnotation annotation = targetClass.getAnnotation(MyCustomAnnotation.class);// 检查注解是否存在if (annotation != null) {System.out.println("注解存在: " + annotation);} else {System.out.println("注解不存在");}// 关闭上下文context.close();}
}

输出结果

运行修改后的代码，输出结果如下：

Doing something...
注解存在: @MyCustomAnnotation()

可以看到，通过 AopProxyUtils.ultimateTargetClass() 方法，我们成功获取到了目标类 MyService 上的注解 @MyCustomAnnotation。

深入理解 `AopProxyUtils.ultimateTargetClass()`

实现原理

AopProxyUtils.ultimateTargetClass() 方法的实现基于 Spring AOP 的内部机制。它会递归地检查代理对象的类层次结构，直到找到最终的目标类。具体来说，它会通过以下步骤实现：

检查代理对象是否为 AOP 代理：通过 AopUtils.isAopProxy() 方法判断当前对象是否为 AOP 代理对象。
获取目标类：如果当前对象是 AOP 代理对象，通过 AopProxyUtils.ultimateTargetClass() 方法递归地获取最终的目标类。
返回目标类：最终返回目标类的 Class 对象。

源码分析

以下是 AopProxyUtils.ultimateTargetClass() 方法的源码：

public static Class<?> ultimateTargetClass(Object candidate) {// 确保传入的对象不为 nullAssert.notNull(candidate, "Candidate object must not be null");Object current = candidate;Class<?> result;// 遍历代理链，直到找到最终的目标类for (result = null; current instanceof TargetClassAware; current = getSingletonTarget(current)) {// 当前对象实现了 TargetClassAware 接口，表示它知道自己的目标类TargetClassAware targetClassAware = (TargetClassAware) current;// 获取目标类result = targetClassAware.getTargetClass();}// 如果没有找到目标类if (result == null) {// 如果当前对象是 CGLIB 代理对象，获取其父类（即目标类）if (AopUtils.isCglibProxy(candidate)) {result = candidate.getClass().getSuperclass();} else {// 否则直接返回当前对象的类result = candidate.getClass();}}// 返回最终的目标类return result;
}

注意事项

依赖 Spring AOP：AopProxyUtils 是 Spring AOP 模块的一部分，因此需要在项目中引入 Spring AOP 相关依赖。
代理对象：只有代理对象才能使用 AopProxyUtils.ultimateTargetClass()，如果直接传入一个普通对象，可能会抛出异常或返回错误结果。
性能影响：虽然 AopProxyUtils.ultimateTargetClass() 的实现相对高效，但在高并发场景下，频繁调用可能会对性能产生一定影响，建议合理使用。