深入探索JDK动态代理:从入门到原理的全面解析

在这里插入图片描述

动态代理系列文章:
深入探索JDK动态代理:从入门到原理的全面解析
探索Cglib:解析动态代理的神奇之处
全网最全解析!Spring与非Spring环境下获取动态代理对象的原始目标对象

前言

在我们日常开发中,代理模式是一种非常常见也非常有用的设计模式。它能够为其他对象提供一种代理以控制对这个对象的访问(说人话就是,增强我们原有对象的功能,在原有对象基础上增加一些我们自己要的操作,比如:事务处理、记录日志等)。在 Java 中,代理可以是静态的也可以是动态的。接下来我将深入探索 JDK 中的动态代理——会从基础概念讲起,通过入门示例到探究其实现原理,助你彻底理解动态代理。

基本概念

JDK动态代理是一种在运行时创建代理对象的技术,它允许我们在不修改目标类代码的情况下,增强目标对象的功能。这种代理模式主要用于实现AOP(面向切面编程)

入门案例

实现JDK动态代理的步骤

  1. 接口的定义:首先,需要有一个或多个接口来定义代理类的行为。这些接口将被代理类实现,从而确保代理类能够执行目标对象的方法
  2. 创建代理类:使用Proxy类和InvocationHandler接口来创建代理类。Proxy类提供了静态方法newProxyInstance(),它接受三个参数:类加载器、接口数组和一个InvocationHandler实例。通过这个方法,可以在运行时动态地创建代理类的实例
  3. 编写InvocationHandlerInvocationHandler是一个接口,用于处理代理对象的调用。开发者需要实现这个接口,并在其中定义如何处理目标对象的方法调用。这包括了方法的增强处理,如日志记录、事务管理等
  4. 注册InvocationHandler:通过Proxy.newProxyInstance ()方法创建代理对象时,传入的InvocationHandler实例就是用来注册这个处理程序的。这样,当代理对象的方法被调用时,就会触发InvocationHandler中的逻辑
  5. 使用代理对象:最后,可以像使用普通对象一样使用代理对象。由于代理对象实现了目标接口,因此可以调用其方法。当这些方法被调用时,实际上是调用了代理对象内部的增强逻辑
    在这里插入图片描述

入门实操

首先,我们需要定义一个接口,例如 ServiceInterface,其中包含一些方法,比如 execute。同时我们创建一个实现了 ServiceInterface 接口的类,例如 ServiceImpl,并实现这些方法。

// 定义服务接口
public interface ServiceInterface {
    void execute();
}

// 实现服务接口
public class ServiceImpl implements ServiceInterface {
    public void execute() {
        System.out.println("执行服务方法");
    }
}

现在,我们将使用动态代理来创建代理对象。我们需要实现一个 InvocationHandler 接口,并重写它的 invoke 方法。

// 实现 InvocationHandler
public class MyInvocationHandler implements InvocationHandler {
    private Object target;

    public MyInvocationHandler(Object target) {
        this.target = target;
    }

    @Override
    public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
        System.out.println("方法执行前的代理操作...");
        // 通过反射调用目标方法
        Object result = method.invoke(target, args);
        System.out.println("方法执行后的代理操作...");
        return result;
    }
}

现在,我们可以编写一个测试类来验证动态代理的使用,这个例子中,我们通过动态代理实现了一个代理对象,当调用代理对象的方法时,会先执行 invoke 方法中的前置处理逻辑,然后再调用目标对象的方法,最后执行后置处理逻辑。

  • 其中Proxy.newProxyInstance动态生成代理并使用

  • 注意这行代码System.setProperty("sun.misc.ProxyGenerator.saveGeneratedFiles", "true"); 是生成动态代理类的字节码的,接下来我们讲讲有几种方式生成!

// 动态生成代理并使用
public class ProxyTest {
    public static void main(String[] args) {
		System.setProperty("sun.misc.ProxyGenerator.saveGeneratedFiles", "true");

        ServiceInterface service = new ServiceImpl();
        InvocationHandler handler = new MyInvocationHandler(service);

        ServiceInterface proxyInstance = (ServiceInterface) Proxy.newProxyInstance(
                ServiceInterface.class.getClassLoader(),// 指定类加载器
                new Class<?>[] {ServiceInterface.class},// 指定要代理的接口
                handler);// 指定InvocationHandler

        // 执行的是代理的方法
        proxyInstance.execute();
    }
}

拓展–动态生成代理类的几种方法

方式一:通过getProxyClass方法获取代理实例
  1. 根据类加载器和接口数组获取代理类的Class对象
  2. 过Class对象的构造器创建一个实例(代理类的实例)
  3. 将代理实例强转成目标接口ServiceInterface(因为代理类实现了目标接口,所以可以强转)。
  4. 最后使用代理进行方法调用。
@Test
public void test1() throws Exception {
    ServiceInterface service = new ServiceImpl();
    // 根据类加载器和接口数组获取代理类的Class对象
    Class<?> proxyClass = Proxy.getProxyClass(ServiceInterface.class.getClassLoader(), ServiceInterface.class);

    // 通过Class对象的构造器创建一个实例(代理类的实例)
    ServiceInterface serviceInterfaceProxy = (ServiceInterface) proxyClass.getConstructor(InvocationHandler.class)
        .newInstance(new MyInvocationHandler(ServiceInterface));

    // 调用 execute 方法
    String value = serviceInterfaceProxy.execute();

}
方式二:通过newProxyInstance方法获取代理实例(常用!)

也就是我们上面的例子,通过这种方法是最简单的,也是推荐使用的,通过该方法可以直接获取代理对象。

注:其实该方法后台实现实际与上面使用getProxyClass方法的过程一样。

ServiceInterface service = new ServiceImpl();
InvocationHandler handler = new MyInvocationHandler(service);

ServiceInterface proxyInstance = (ServiceInterface) Proxy.newProxyInstance(
        ServiceInterface.class.getClassLoader(),
        new Class<?>[] {ServiceInterface.class},
        handler);

// 执行的是代理的方法
proxyInstance.execute();
方式三:通过Lambda表达式简化实现

其实InvocationHander接口也不用创建一个实现类,可以使用Lambad表达式进行简化的实现,如下代码:

@Test
public void test3() {
    ServiceInterface service = new ServiceImpl();

    ServiceInterface proxyInstance = (ServiceInterface) Proxy.newProxyInstance(
            ServiceInterface.class.getClassLoader(),
            new Class<?>[] {ServiceInterface.class},(proxy, method, args1) ->{
                System.out.println("方法执行前的代理操作...");
                // 通过反射调用目标方法
                Object result = method.invoke(service, args);
                System.out.println("方法执行后的代理操作...");
                return result;
            }
          );
   // 执行的是代理的方法
	proxyInstance.execute();
}

生成并查看JDK动态代理类的的字节码

在标准的Java JDK实现中,生成的动态代理类(字节码)默认是在内存中动态生成并直接加载的,不会写入磁盘成为文件。所以,通常我们无法直接获取到这些字节码文件。

不过,有一种办法可以让JVM生成的代理类字节码被保存到磁盘上,这是通过设置系统属性来实现的。可以在启动Java应用程序时通过命令行设置系统属性

JDK8及之前版本

在Java 8及以下版本,可以在idea启动时这样设置属性:

-Dsun.misc.ProxyGenerator.saveGeneratedFiles=true

image-20240324163232054
在程序中,可通过以下代码进行设置:

System.setProperty("sun.misc.ProxyGenerator.saveGeneratedFiles", "true");

Java 9及之后

对于Java 9及之后的版本,由于模块化系统的引入,该系统属性可能不再起作用,相应的系统属性变更为:

-Djdk.proxy.ProxyGenerator.saveGeneratedFiles=true

或者在Java代码中进行设置:

System.setProperty("jdk.proxy.ProxyGenerator.saveGeneratedFiles", "true");

添加了这个系统属性后,当创建动态代理实例的时候,JVM会将生成的代理类以 .class 文件形式保存在工程的根目录或者 com/sun/proxy 目录下。

如何查看?

为了调试目的,我们要查看或修改这些动态生成的代理类,正常我们还需要反编译工具(比如JD-GUI或JAD)来查看生成的类的源代码,但是我们不用那么麻烦,直接用IDEA打开即可

如何确定版本?

如果还有人不知道如何确定是sun.misc.ProxyGenerator.saveGeneratedFiles还是jdk.proxy.ProxyGenerator.saveGeneratedFiles,可以打开sun.misc.ProxyGenerator类查看,注意这个变量saveGeneratedFiles

 boolean saveGeneratedFiles = (Boolean)AccessController.doPrivileged(new GetBooleanAction("sun.misc.ProxyGenerator.saveGeneratedFiles"));

image-20240324162403033

为什么这样设置就可以生成代理类字节码到本地?

还是在sun.misc.ProxyGenerator这里,搜索查看sun.misc.ProxyGenerator#generateProxyClass(java.lang.String, java.lang.Class<?>[], int)这个方法,可以发现上面设置完了后,我们的saveGeneratedFiles是true,此时就会生成对应的字节码到本地图中那个路径com/sun/poxy

image-20240324162853030

我的项目中生成如下

image-20240324163138825

底层原理解析

JDK动态代理是基于Java的反射机制实现的。在创建代理对象时,JDK会动态生成一个新的类,实现了目标对象所实现的接口,并将代理逻辑写入 invoke 方法中。当调用代理对象的方法时,实际上是调用了 invoke 方法,然后由 invoke 方法根据方法名来调用目标对象的方法。

代理类的创建

Java动态代理的实现是通过 java.lang.reflect.Proxy 类来完成的。当我们调用 Proxy.newProxyInstance 方法时,它会做以下几件事情:

  1. 检查提供的接口是否全部为公共接口。
  2. 确定要使用的类加载器。
  3. 生成代理类的二进制字节码。
  4. 加载这些二进制字节码,定义代理类。
 ServiceInterface proxyInstance = (ServiceInterface) Proxy.newProxyInstance(
                ServiceInterface.class.getClassLoader(),// 指定类加载器
                new Class<?>[] {ServiceInterface.class},// 指定要代理的接口
                handler);// 指定InvocationHandler
   // 执行的是代理的方法
  proxyInstance.execute();

生成的代理类将会继承 Proxy 类,并实现了指定的所有接口方法。在这个过程中,JVM将使用一个叫做 $Proxy0 的类实现了 ServiceInterface 接口(序号可能会根据实际生成的代理数量不同而变化)。这个代理类从 Proxy 继承了很多处理逻辑,同时也将接口方法全部委托给 InvocationHandler 处理。

Proxy.newProxyInstance方法分析
public class Proxy {
    // 获取或创建一个动态代理类的实例的静态方法
    public static Object newProxyInstance(ClassLoader loader,
                                          Class<?>[] interfaces,
                                          InvocationHandler h)
        throws IllegalArgumentException
    {
        // 确保提供的InvocationHandler不为null
        Objects.requireNonNull(h);

        // 克隆接口数组,以避免对原数组的潜在修改
        final Class<?>[] intfs = interfaces.clone();
        // 获取系统的安全管理器
        final SecurityManager sm = System.getSecurityManager();
        // 如果有安全管理器,检查创建代理实例的权限
        if (sm != null) {
            checkProxyAccess(Reflection.getCallerClass(), loader, intfs);
        }

        /*
         * 查找或生成指定的代理类。
         */
        // 获取代理类
        Class<?> cl = getProxyClass0(loader, intfs);

        /*
         * 调用其构造函数并用指定的调用处理器InvocationHandler作为参数。
         */
        try {
            // 如果安全管理器存在,进一步检查权限
            if (sm != null) {
                checkNewProxyPermission(Reflection.getCallerClass(), cl);
            }

            // 查找代理类的构造函数,这个构造函数预期接收一个InvocationHandler作为参数
            final Constructor<?> cons = cl.getConstructor(constructorParams);
            final InvocationHandler ih = h;
            // 如果代理类不是public的,需要特权访问权限,以便设置构造函数为可访问状态
            if (!Modifier.isPublic(cl.getModifiers())) {
                AccessController.doPrivileged(new PrivilegedAction<Void>() {
                    public Void run() {
                        cons.setAccessible(true);
                        return null;
                    }
                });
            }
            // 使用提供的InvocationHandler实例化代理类
            return cons.newInstance(new Object[]{h});
        } catch (IllegalAccessException|InstantiationException e) {
            // 如果代理对象无法正常创建,抛出内部错误
            throw new InternalError(e.toString(), e);
        } catch (InvocationTargetException e) {
            // 如果构造函数调用抛出异常,解包异常并处理
            Throwable t = e.getCause();
            if (t instanceof RuntimeException) {
                throw (RuntimeException) t;
            } else {
                throw new InternalError(t.toString(), t);
            }
        } catch (NoSuchMethodException e) {
            // 如果没有找到预期的构造函数,抛出内部错误
            throw new InternalError(e.toString(), e);
        }
    }
    // 其他省略的代码...
}

此方法的执行流程如下:

  1. 参数验证:验证传入的 InvocationHandler h 是否为 null
  2. 安全权限检查(如果存在安全管理器):使用 checkProxyAccess 方法检查是否有创建代理实例的权限。
  3. 代理类的查找或生成:调用 getProxyClass0 方法来获取或生成相应的代理类。
  4. 调用代理类的构造函数创建实例:找到代理类的唯一构造函数(该构造函数以 InvocationHandler 为参数),并判断是否需要通过权限检查调用 setAccessible 来允许访问非公共构造函数。
  5. 创建并返回代理实例:最后,通过反射调用构造器的 newInstance 方法,并将 InvocationHandler h 传递为参数,创建代理对象的实例。

代理类$Proxy是什么样子

那么生成的proxyInstance对象到底是什么,为什么调用它的execute方法会执行MyInvocationHandler的invoke方法呢???

看到下面生成的代理对象的字节码文件,是不是一切都明白你了,原理竟然如此简单!

上面我们已经介绍了如何生成代理类的字节码到本地,打开进行查看

public final class $Proxy0 extends Proxy implements ServiceInterface {
    private static Method m1;
    private static Method m2;
    private static Method m3;
    private static Method m0;

    public $Proxy0(InvocationHandler var1) throws  {
        super(var1);
    }

    public final void execute() throws  {
        try {
            super.h.invoke(this, m3, (Object[])null);
        } catch (RuntimeException | Error var2) {
            throw var2;
        } catch (Throwable var3) {
            throw new UndeclaredThrowableException(var3);
        }
    }

	.....省略toString/hashCode/equals等方法

    static {
        try {
            m1 = Class.forName("java.lang.Object").getMethod("equals", Class.forName("java.lang.Object"));
            m2 = Class.forName("java.lang.Object").getMethod("toString");
            m3 = Class.forName("com.useful.tool.ServiceInterface").getMethod("execute");
            m0 = Class.forName("java.lang.Object").getMethod("hashCode");
        } catch (NoSuchMethodException var2) {
            throw new NoSuchMethodError(var2.getMessage());
        } catch (ClassNotFoundException var3) {
            throw new NoClassDefFoundError(var3.getMessage());
        }
    }
}

通过该文件可以看出:

  • 代理类继承了Proxy类,其主要目的是为了传递InvocationHandler
  • 代理类实现了被代理的接口ServiceInterface,这也是为什么代理类可以直接强转成接口的原因。
  • 有一个公开的构造函数,参数为指定的InvocationHandler,并将参数传递到父类Proxy中。
  • 每一个实现的方法,都会调用InvocationHandler中的invoke方法,并将代理类本身、Method实例、入参三个参数进行传递。这也是为什么调用代理类中的方法时,总会分派到InvocationHandler中的invoke方法的原因。

注意的地方

    public final void execute() throws  {
        try {
            super.h.invoke(this, m3, (Object[])null);
        } catch (RuntimeException | Error var2) {
            throw var2;
        } catch (Throwable var3) {
            throw new UndeclaredThrowableException(var3);
        }
    }

上面的super也就是我们的Proxy类,super.h也就是Proxy里面的InvocationHandler h变量

protected InvocationHandler h;

image-20240324171335334

不知道细心的小伙伴有没有注意到,为什么我们在debug的时候生成的代理类的变量总是一个h,我之前就一直很奇怪,直到这次深入了解后发现原来如此~~~

image-20240324171701213

参考文章:
https://segmentfault.com/a/1190000039303463#item-3
https://blog.csdn.net/MrYushiwen/article/details/111473126

  • 15
    点赞
  • 23
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Apple_Web

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值