Java 动态代理

一、介绍

何谓代理?
据史料记载,代理这个词最早出现在代理商这个行业,所谓代理商,简而言之,其实就是帮助企业或者老板打理生意,自己本身不做生产任何商品。
举个例子,去火车站买票的时候,人少老板一个人还忙的过来,但是人一多的话,就会非常拥挤,于是就有了各种代售点,可以从代售点买车票,从而加快老板的卖票速度。
代售点的出现,可以说,很直观的帮助老板提升了用户购票体验。
站在软件设计的角度,其实效果也是一样的,采用代理模式的编程,能显著的增强原有的功能和简化方法调用方式。
什么是动态代理 - 图1
在介绍动态代理之前,先来聊解静态代理。

二、静态代理

下面以两数相加为例,实现过程如下!

  • 接口类

    1. public interface Calculator {
    2. /**
    3. * 计算两个数之和
    4. * @param num1
    5. * @param num2
    6. * @return
    7. */
    8. Integer add(Integer num1, Integer num2);
    9. }
  • 目标对象 ```java public class CalculatorImpl implements Calculator {

  1. @Override
  2. public Integer add(Integer num1, Integer num2) {
  3. Integer result = num1 + num2;
  4. return result;
  5. }

}

  1. - 代理对象
  2. ```java
  3. public class CalculatorProxyImpl implements Calculator {
  4. private Calculator calculator;
  5. @Override
  6. public Integer add(Integer num1, Integer num2) {
  7. //方法调用前,可以添加其他功能....
  8. Integer result = calculator.add(num1, num2);
  9. //方法调用后,可以添加其他功能....
  10. return result;
  11. }
  12. public CalculatorProxyImpl(Calculator calculator) {
  13. this.calculator = calculator;
  14. }
  15. }
  • 测试类

    1. public class CalculatorProxyClient {
    2. public static void main(String[] args) {
    3. //目标对象
    4. Calculator target = new CalculatorImpl();
    5. //代理对象
    6. Calculator proxy = new CalculatorProxyImpl(target);
    7. Integer result = proxy.add(1,2);
    8. System.out.println("相加结果:" + result);
    9. }
    10. }
  • 输出结果

    1. 相加结果:3

    通过这种代理方式,最大的优点就是:可以在不修改目标对象的前提下,扩展目标对象的功能。
    但也有缺点:需要代理对象和目标对象实现一样的接口,因此,当目标对象扩展新的功能时,代理对象也要跟着一起扩展,不易维护!

    三、动态代理

    动态代理,其实本质也是为了解决上面当目标对象扩展新功能时,代理对象也需要跟着一起扩展的痛点问题而生。
    那它是怎么解决的呢?
    以 JDK 为例,当需要给某个目标对象添加代理处理的时候,JDK 会在内存中动态的构建代理对象,从而实现对目标对象的代理功能。
    下面,还是以两数相加为例,介绍具体的玩法!

    3.1、JDK 中生成代理对象的用法

  • 创建接口

    1. public interface JdkCalculator {
    2. /**
    3. * 计算两个数之和
    4. * @param num1
    5. * @param num2
    6. * @return
    7. */
    8. Integer add(Integer num1, Integer num2);
    9. }
  • 目标对象

    1. public class JdkCalculatorImpl implements JdkCalculator {
    2. @Override
    3. public Integer add(Integer num1, Integer num2) {
    4. Integer result = num1 + num2;
    5. return result;
    6. }
    7. }
  • 动态代理对象

    1. public class JdkProxyFactory {
    2. /**
    3. * 维护一个目标对象
    4. */
    5. private Object target;
    6. public JdkProxyFactory(Object target) {
    7. this.target = target;
    8. }
    9. public Object getProxyInstance(){
    10. Object proxyClassObj = Proxy.newProxyInstance(target.getClass().getClassLoader(),
    11. target.getClass().getInterfaces(),
    12. new InvocationHandler(){
    13. @Override
    14. public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
    15. System.out.println("方法调用前,可以添加其他功能....");
    16. // 执行目标对象方法
    17. Object returnValue = method.invoke(target, args);
    18. System.out.println("方法调用后,可以添加其他功能....");
    19. return returnValue;
    20. }
    21. });
    22. return proxyClassObj;
    23. }
    24. }
  • 测试类

    1. public class TestJdkProxy {
    2. public static void main(String[] args) {
    3. //目标对象
    4. JdkCalculator target = new JdkCalculatorImpl();
    5. System.out.println(target.getClass());
    6. //代理对象
    7. JdkCalculator proxyClassObj = (JdkCalculator) new JdkProxyFactory(target).getProxyInstance();
    8. System.out.println(proxyClassObj.getClass());
    9. //执行代理方法
    10. Integer result = proxyClassObj.add(1,2);
    11. System.out.println("相加结果:" + result);
    12. }
    13. }
  • 输出结果

    1. class com.example.java.proxy.jdk1.JdkCalculatorImpl
    2. class com.sun.proxy.$Proxy0
    3. 方法调用前,可以添加其他功能....
    4. 方法调用后,可以添加其他功能....
    5. 相加结果:3

    采用 JDK 技术动态创建interface实例的步骤如下:

  1. 首先定义一个 InvocationHandler 实例,它负责实现接口的方法调用
  2. 通过 Proxy.newProxyInstance() 创建 interface 实例,它需要 3 个参数:
    (1)使用的 ClassLoader,通常就是接口类的 ClassLoader
    (2)需要实现的接口数组,至少需要传入一个接口进去;
    (3)用来处理接口方法调用的 InvocationHandler 实例。
  3. 将返回的 Object 强制转型为接口

动态代理实际上是 JVM 在运行期动态创建class字节码并加载的过程,它并没有什么黑魔法技术,把上面的动态代理改写为静态实现类大概长这样:

  1. public class JdkCalculatorDynamicProxy implements JdkCalculator {
  2. private InvocationHandler handler;
  3. public JdkCalculatorDynamicProxy(InvocationHandler handler) {
  4. this.handler = handler;
  5. }
  6. public void add(Integer num1, Integer num2) {
  7. handler.invoke(
  8. this,
  9. JdkCalculator.class.getMethod("add", Integer.class, Integer.class),
  10. new Object[] { num1, num2 });
  11. }
  12. }

本质就是 JVM 自动编写了一个上述类(不需要源码,可以直接生成字节码)。

3.2、cglib 生成代理对象的用法

除了 jdk 能实现动态的创建代理对象以外,还有一个非常有名的第三方框架:cglib,它也可以做到运行时在内存中动态生成一个子类对象从而实现对目标对象功能的扩展。
cglib 特点如下:

  • cglib 不仅可以代理接口还可以代理类,而 JDK 的动态代理只能代理接口
  • cglib 是一个强大的高性能的代码生成包,它广泛的被许多 AOP 的框架使用,例如熟知的 Spring AOP,cglib 为他们提供方法的 interception(拦截)。
  • CGLIB包的底层是通过使用一个小而快的字节码处理框架ASM,来转换字节码并生成新的类,速度非常快。

在使用 cglib 之前,需要添加依赖包,如果已经有spring-core的jar包,则无需引入,因为spring中包含了cglib。

  1. <dependency>
  2. <groupId>cglib</groupId>
  3. <artifactId>cglib</artifactId>
  4. <version>3.2.5</version>
  5. </dependency>

下面还是以两数相加为例,介绍具体的玩法!

  • 创建接口

    1. public interface CglibCalculator {
    2. /**
    3. * 计算两个数之和
    4. * @param num1
    5. * @param num2
    6. * @return
    7. */
    8. Integer add(Integer num1, Integer num2);
    9. }
  • 目标对象 ```java public class CglibCalculatorImpl implements CglibCalculator {

  1. @Override
  2. public Integer add(Integer num1, Integer num2) {
  3. Integer result = num1 + num2;
  4. return result;
  5. }

}

  1. - 动态代理对象
  2. ```java
  3. public class CglibProxyFactory implements MethodInterceptor {
  4. /**
  5. * 维护一个目标对象
  6. */
  7. private Object target;
  8. public CglibProxyFactory(Object target) {
  9. this.target = target;
  10. }
  11. /**
  12. * 为目标对象生成代理对象
  13. * @return
  14. */
  15. public Object getProxyInstance() {
  16. //工具类
  17. Enhancer en = new Enhancer();
  18. //设置父类
  19. en.setSuperclass(target.getClass());
  20. //设置回调函数
  21. en.setCallback(this);
  22. //创建子类对象代理
  23. return en.create();
  24. }
  25. @Override
  26. public Object intercept(Object o, Method method, Object[] args, MethodProxy methodProxy) throws Throwable {
  27. System.out.println("方法调用前,可以添加其他功能....");
  28. // 执行目标对象方法
  29. Object returnValue = method.invoke(target, args);
  30. System.out.println("方法调用后,可以添加其他功能....");
  31. return returnValue;
  32. }
  33. }
  • 测试类

    1. public class TestCglibProxy {
    2. public static void main(String[] args) {
    3. //目标对象
    4. CglibCalculator target = new CglibCalculatorImpl();
    5. System.out.println(target.getClass());
    6. //代理对象
    7. CglibCalculator proxyClassObj = (CglibCalculator) new CglibProxyFactory(target).getProxyInstance();
    8. System.out.println(proxyClassObj.getClass());
    9. //执行代理方法
    10. Integer result = proxyClassObj.add(1,2);
    11. System.out.println("相加结果:" + result);
    12. }
    13. }
  • 输出结果

    1. class com.example.java.proxy.cglib1.CglibCalculatorImpl
    2. class com.example.java.proxy.cglib1.CglibCalculatorImpl$$EnhancerByCGLIB$$3ceadfe4
    3. 方法调用前,可以添加其他功能....
    4. 方法调用后,可以添加其他功能....
    5. 相加结果:3

    将 cglib 生成的代理类改写为静态实现类大概长这样: ```java public class CglibCalculatorImplByCGLIB extends CglibCalculatorImpl implements Factory {

  1. private static final MethodInterceptor methodInterceptor;
  2. private static final Method method;
  3. public final Integer add(Integer var1, Integer var2) {
  4. return methodInterceptor.intercept(this, method, new Object[]{var1, var2}, methodProxy);
  5. }
  6. //....

}

  1. 其中,拦截思路与 JDK 类似,都是通过一个接口方法进行拦截处理!<br />在上文中咱们还介绍到了,cglib 不仅可以代理接口还可以代理类,下面试试代理类。
  2. - 创建新的目标对象
  3. ```java
  4. public class CglibCalculatorClass {
  5. /**
  6. * 计算两个数之和
  7. * @param num1
  8. * @param num2
  9. * @return
  10. */
  11. public Integer add(Integer num1, Integer num2) {
  12. Integer result = num1 + num2;
  13. return result;
  14. }
  15. }
  • 测试类

    1. public class TestCglibProxyClass {
    2. public static void main(String[] args) {
    3. //目标对象
    4. CglibCalculatorClass target = new CglibCalculatorClass();
    5. System.out.println(target.getClass());
    6. //代理对象
    7. CglibCalculatorClass proxyClassObj = (CglibCalculatorClass) new CglibProxyFactory(target).getProxyInstance();
    8. System.out.println(proxyClassObj.getClass());
    9. //执行代理方法
    10. Integer result = proxyClassObj.add(1,2);
    11. System.out.println("相加结果:" + result);
    12. }
    13. }
  • 输出结果

    1. class com.example.java.proxy.cglib1.CglibCalculatorClass
    2. class com.example.java.proxy.cglib1.CglibCalculatorClass$$EnhancerByCGLIB$$e68ff36c
    3. 方法调用前,可以添加其他功能....
    4. 方法调用后,可以添加其他功能....
    5. 相加结果:3

    四、静态织入

    在上文中,介绍的代理方案都是在代码运行时动态的生成class文件达到动态代理的目的。
    回到问题的本质,其实动态代理的技术目的,主要为了解决静态代理模式中当目标接口发生了扩展,代理类也要跟着一遍变动的问题,避免造成了工作伤的繁琐和复杂。
    在 Java 生态里面,还有一个非常有名的第三方代理框架,那就是AspectJ,AspectJ通过特定的编译器可以将目标类编译成class字节码的时候,在方法周围加上业务逻辑,从而达到静态代理的效果。
    采用AspectJ进行方法植入,主要有四种:

  • 方法调用前拦截

  • 方法调用后拦截
  • 调用方法结束拦截
  • 抛出异常拦截

使用起来也非常简单,首先是在项目中添加AspectJ编译器插件。

  1. <plugin>
  2. <groupId>org.codehaus.mojo</groupId>
  3. <artifactId>aspectj-maven-plugin</artifactId>
  4. <version>1.5</version>
  5. <executions>
  6. <execution>
  7. <goals>
  8. <goal>compile</goal>
  9. <goal>test-compile</goal>
  10. </goals>
  11. </execution>
  12. </executions>
  13. <configuration>
  14. <source>1.6</source>
  15. <target>1.6</target>
  16. <encoding>UTF-8</encoding>
  17. <complianceLevel>1.6</complianceLevel>
  18. <verbose>true</verbose>
  19. <showWeaveInfo>true</showWeaveInfo>
  20. </configuration>
  21. </plugin>

然后,编写一个方法,准备进行代理。

  1. @RequestMapping({"/hello"})
  2. public String hello(String name) {
  3. String result = "Hello World";
  4. System.out.println(result);
  5. return result;
  6. }

编写代理配置类

  1. @Aspect
  2. public class ControllerAspect {
  3. /***
  4. * 定义切入点
  5. */
  6. @Pointcut("execution(* com.example.demo.web..*.*(..))")
  7. public void methodAspect(){}
  8. /**
  9. * 方法调用前拦截
  10. */
  11. @Before("methodAspect()")
  12. public void before(){
  13. System.out.println("代理 -> 调用方法执行之前......");
  14. }
  15. /**
  16. * 方法调用后拦截
  17. */
  18. @After("methodAspect()")
  19. public void after(){
  20. System.out.println("代理 -> 调用方法执行之后......");
  21. }
  22. /**
  23. * 调用方法结束拦截
  24. */
  25. @AfterReturning("methodAspect()")
  26. public void afterReturning(){
  27. System.out.println("代理 -> 调用方法结束之后......");
  28. }
  29. /**
  30. * 抛出异常拦截
  31. */
  32. @AfterThrowing("methodAspect()")
  33. public void afterThrowing() {
  34. System.out.println("代理 -> 调用方法异常......");
  35. }
  36. }

编译后,hello方法会变成这样。

  1. @RequestMapping({"/hello"})
  2. public String hello(Integer name) throws SQLException {
  3. JoinPoint var2 = Factory.makeJP(ajc$tjp_0, this, this, name);
  4. Object var7;
  5. try {
  6. Object var5;
  7. try {
  8. //调用before
  9. Aspectj.aspectOf().doBeforeTask2(var2);
  10. String result = "Hello World";
  11. System.out.println(result);
  12. var5 = result;
  13. } catch (Throwable var8) {
  14. Aspectj.aspectOf().after(var2);
  15. throw var8;
  16. }
  17. //调用after
  18. Aspectj.aspectOf().after(var2);
  19. var7 = var5;
  20. } catch (Throwable var9) {
  21. //调用抛出异常
  22. Aspectj.aspectOf().afterthrowing(var2);
  23. throw var9;
  24. }
  25. //调用return
  26. Aspectj.aspectOf().afterRutuen(var2);
  27. return (String)var7;
  28. }

很显然,代码被AspectJ编译器修改了,AspectJ并不是动态的在运行时生成代理类,而是在编译的时候就植入代码到class文件。
由于是静态织入的,所以性能相对来说比较好!

五、小结

看到上面的介绍静态织入方案,跟现在使用Spring AOP的方法极其相似,可能有的同学会发出疑问,现在使用的Spring AOP动态代理,到底是动态生成的还是静态织入的呢?
实际上,Spring AOP代理是对JDK代理和CGLIB代理做了一层封装,同时引入了AspectJ中的一些注解@pointCut@after@before等等,本质是使用的动态代理技术。
总结起来就三点:

  • 如果目标是接口的话,默认使用 JDK 的动态代理技术;
  • 如果目标是类的话,使用 cglib 的动态代理技术;
  • 引入了AspectJ中的一些注解@pointCut@after@before,主要是为了简化使用,跟AspectJ的关系并不大;

那为什么Spring AOP不使用AspectJ这种静态织入方案呢?
虽然AspectJ编译器非常强,性能非常高,但是只要目标类发生了修改就需要重新编译,主要原因可能还是AspectJ的编译器太过于复杂,还不如动态代理来的省心!