【编码日常】如何修改动态代理的私有变量

Dynamic Proxy Cglib Spring AOP JUnit Mock

最近在写一个 Spring Controller 的 JUnit 单元测试时,需要将一个Mock对象塞入到Controller的私有成员变量中,发现怎么都塞不成功,这才引发了这篇探索如何访问和修改被动态代理对象的私有变量。
案发现场
为了理解直观,下文会有不少截图,先介绍下这个项目中几个类:
  1. EventController:@Controller声明的普通 Controller 类,接收 Web Http 请求,该类被一个 LogInterceptor 拦截,打印 HTTP 请求和应答报文,换句话就是被AOP切面了,在Spring上下文中已经变成了一个动态代理类。
【编码日常】如何修改动态代理的私有变量
文章图片
EventController
  1. MeProducer: 该类作为 EventController 中的一个非共有(private/protected)成员变量,用来生产异步消息。本案例正是要 Mock 这个对象来模拟生产异步消息时的不同行为。
  2. JUnit Test: 单元测试类,把 EventController 通过@Autowired 自动注入进去(此时注入的就是动态代理过的对象),然后通过对其成员变量 MeProducer 的Mock 实现不同案例的单元测试。
  3. PrivateAccessor:单元测试常用的用于反射私有变量和私有方法的工具类,依赖 junit-addons。
DEBUG 线索
1. 基本面分析 我们可以直观确认注入在 JUnit 中的eventController 实际上就是被 Spring CGLIB 字节码增强过的一个动态代理类,如下图。为表述方便后文会用EventControllerProxy 来代表图中实际的动态代理类名 EventController$$EnhancerBySpringCGLIB$$3c1bcb52
【编码日常】如何修改动态代理的私有变量
文章图片
Junit中的代理类 带大家解读一下这张图的要点:
a. AopUtils.isAopProxy可以判断一个对象是否是Spring AOP代理对象;判断依据就是或者JdkDynamicProxy或者CglibProxy;
b. Spring AOP代理类都默认实现了Advised接口,通过其接口方法getTargetSource().getTarget()可以获取到真正被代理的目标对象。
【【编码日常】如何修改动态代理的私有变量】开涛博客中提到了如何从CALLBACK中抽丝剥茧找到目标对象,虽然不如图中简单优雅,但是对于理解代理类的构造很有好处,推荐大家看看:http://jinnianshilongnian.iteye.com/blog/1613222
c. 可以看到EventController的代理对象和目标对象是两个独立个体(@后的id不同),这个容易理解。而对象内部的变量也是完全不同的,EventControllerProxy里的meProducer是通过PrivateAccessor塞入的mock对象,EventController里的是通过 Autowired 注入的配置完整的对象。另外,目标对象中定义的三种修饰符的xxxField变量,在Proxy里都是null,也就是说Field都没有继承过来。要理解它必须学懂两个知识点:动态代理原理和Spring动态代理机制
关于动态代理的底层实现不展开,大家阅读下方两篇即可。从方便理解本案例来说,大家只要明白“动态代理类”是继承自”被代理类”的一个子类,且“拦截的”或者说“代理的”只是Method而不是Field就足够了。
Reference 1: Understanding proxy usage in Spring
Reference 2: 占小狼 - cglib动态代理
而说到Spring动态代理Bean的实现机制,无非是有接口的类使用Jdk动态代理,无接口的类使用CGLIB,当然你可以选择强制使用CGLIB。下方的引用链接有个关键说明:"被代理对象的构造器会被执行两次",也就是被代理的目标对象会实例化一次,代理对象作为目标对象的子类也会实例化一次。这样就可以解释上图中的情形了,Spring先初始化好目标对象Bean,并将其依赖树全部注入完毕,然后通过AOP生成动态代理类wrap目标对象进行方法拦截,所以目标对象里的属性对于代理类来说都是透明的,只要目标对象自己了解就行。用对象由数据和行为构成来说明的话,数据都在目标对象里,代理类不关心数据只关心行为。
Reference 3: Spring Proxying mechanisms
【编码日常】如何修改动态代理的私有变量
文章图片
Proxy 2. 方案分析 上文出现的不一致情况,是因为错误的讲mock对象塞入到代理对象中去了,如下:
PrivateAccessor.setField(EventControllerProxy, "meProducer", mockObj);

而这个值并不能在真正的目标对象执行中被mock,所以我们需要想办法找到真正的目标对象才能塞入mock, 如下图,o2, o3都可以获取到真正的目标对象私有成员变量meProducer。如何塞入就不用在细说了吧,目标对象都有了随便你怎么反射改变量咯。

【编码日常】如何修改动态代理的私有变量
文章图片
Target Object.png
图中注释掉的o3实现会报错,大家可以自己去看看是为什么。
提示线索:方法定义Field.get(Obj) 不是Field.get(Class)。
3. CGLIB 简单测试代码 Bean父类:
public class AbstractBean { protected String id1; protected Longid2; }

SampleBean :
public class SampleBean extends AbstractBean { public String str; private Map map; private List list; private Long lng; ...... getter setter ...... }

CGLIBTest:
public class CglibTest { @Test public void testCglib() { SampleBean sampleBean = new SampleBean(); sampleBean.setStr("test2"); sampleBean.setLng(1L); System.setProperty(DebuggingClassWriter.DEBUG_LOCATION_PROPERTY, "/Users/Nicholas/cglib/"); Enhancer enhancer = new Enhancer(); enhancer.setSuperclass(sampleBean.getClass()); enhancer.setCallback(new MethodInterceptor() { @Override public Object intercept(Object o, Method method, Object[] objects, MethodProxy methodProxy) throws Throwable { if (method.getDeclaringClass() != Object.class && method.getReturnType() == Long.class) { return "Long"; } Object result = methodProxy.invokeSuper(o, objects); return result; } }); SampleBean proxy = (SampleBean) enhancer.create(); System.out.println("str:" + proxy.str); try {//getLong被转换成了String,必报错 System.out.println("getLng():" + proxy.getLng()); Assert.assertTrue(false); } catch (Exception e) { Assert.assertTrue(true); } System.out.println(ArrayUtils.toString(proxy.getClass().getDeclaredFields())); System.out.println(ArrayUtils.toString(proxy.getClass().getSuperclass().getDeclaredFields())); System.out.println(ArrayUtils.toString(proxy.getClass().getSuperclass().getSuperclass().getDeclaredFields())); } }

4. 总结陈词 全文总结一下:
1)JUnit对Spring类进行mock注入的时候,若发现怎么都塞不进去,请先确认该类是否已经被代理。可以使用AopUtils来判断;
2)对动态代理类的Field进行修改无法影响到真正被代理的目标对象内的Field,不管是public还是private,都没用;
3)对目标对象Field的修改,除了上文提到的找到目标对象,然后反射修改这个方法;亦可以在目标对象中暴露getter setter方法,这样即使通过动态代理类来setObj(), 实际上最终还是调用的目标对象的setObj(),一样可以达到修改目标对象Field的效果。这个大家可以自行去试验,当然后者是目标对象的代码没有那么简洁优雅,并不推荐,但是它背后的原理希望大家读完本文已然可以理解。

    推荐阅读