Java动态代理的具体使用

原文链接：https://www.cnblogs.com/xiaoluo501395377/p/3383130.html

        在学习Spring的时候，我们知道Spring主要有两大思想，一个是IoC，另一个就是AOP，对于IoC，依赖注入就不用多说了，而对于Spring的核心AOP来说，我们不但要知道怎么通过AOP来满足的我们的功能，我们更需要学习的是其底层是怎么样的一个原理，而AOP的原理就是java的动态代理机制，所以本篇随笔就是对java的动态机制进行一个回顾。

        在java的动态代理机制中，有一个重要的类和一个重要的接口：一个是 InvocationHandler(Interface)、另一个则是 Proxy(Class)，这个类和接口是实现java动态代理所必须用到的。

一、java的API文档对它们的描述：

    1、InvocationHandler接口:

InvocationHandler is the interface implemented by the invocation handler of a proxy instance. 

Each proxy instance has an associated invocation handler. When a method is invoked on a proxy instance,
the method invocation is encoded and dispatched to the invoke method of its invocation handler.

        每一个动态代理类都必须要实现InvocationHandler这个接口，并且每个代理类的实例都关联到了一个handler，当我们通过代理对象调用一个方法的时候，这个方法的调用就会被转发为由InvocationHandler这个接口的 invoke 方法来进行调用。我们来看看InvocationHandler这个接口的唯一一个方法 invoke 方法：

Object invoke(Object proxy, Method method, Object[] args) throws Throwable

proxy:　 指代我们所代理的那个真实对象
method:　指代的是我们所要调用真实对象的某个方法的Method对象
args:　　指代的是调用真实对象某个方法时接受的参数

    2、Proxy类：

Proxy provides static methods for creating dynamic proxy classes and instances, 
and it is also the superclass of all dynamic proxy classes created by those methods. 

    Proxy这个类的作用就是用来动态创建一个代理对象的类，它提供了许多的方法，但是我们用的最多的就是 newProxyInstance 这个方法：

public static Object newProxyInstance(ClassLoader loader, Class<?>[] interfaces,  InvocationHandler h)
        throws IllegalArgumentException

Returns an instance of a proxy class for the specified interfaces that dispatches method invocations to 
the specified invocation handler.

        这个方法的作用就是得到一个动态的代理对象，其接收三个参数，我们来看看这三个参数所代表的含义：

public static Object newProxyInstance(ClassLoader loader, Class<?>[] interfaces, InvocationHandler h)
        throws IllegalArgumentException

loader:　　    一个ClassLoader对象，定义了由哪个ClassLoader对象来对生成的代理对象进行加载

interfaces:　　一个Interface对象的数组，表示的是我将要给我需要代理的对象提供一组什么接口，如果我提供了
              一组接口给它，那么这个代理对象就宣称实现了该接口(多态)，这样我就能调用这组接口中的方法了

h:　　         一个InvocationHandler对象，表示的是当我这个动态代理对象在调用方法的时候，
              会关联到哪一个InvocationHandler对象上

二、java动态代理模式的实例：

    1、定义一个Subject类型的接口，为其声明了两个方法：

public interface Subject {
    public void rent();
    
    public void hello(String str);
}

    2、定义Subject接口的一个实现类RealSubjext，并实现接口中声明的方法：

public class RealSubject implements Subject {
    @Override
    public void rent() {
        System.out.println("I want to rent my house");
    }
    
    @Override
    public void hello(String str) {
        System.out.println("hello: " + str);
    }
}

    3、定义一个动态代理类DynamicProxy：（每一个动态代理类都必须要实现 InvocationHandler接口）

public class DynamicProxy implements InvocationHandler {
    //　这个就是我们要代理的真实对象
    private Object subject;
    
    //  构造方法，给我们要代理的真实对象赋初值
    public DynamicProxy(Object subject) {
        this.subject = subject;
    }
    
    @Override
    public Object invoke(Object object, Method method, Object[] args) throws Throwable {
        // 在代理真实对象前我们可以添加一些自己的操作
        System.out.println("before rent house");
        
        // 当代理对象调用真实对象的方法时，其会自动的跳转到代理对象关联的handler对象的invoke方法来进行调用
        method.invoke(subject, args);
        
        // 在代理真实对象后我们也可以添加一些自己的操作
        System.out.println("after rent house");
        
        return null;
    }
 }

    4、ProxyTest类：

public class ProxyTest {
    public static void main(String[] args) {
        // 我们要代理的真实对象
        Subject subject = new RealSubject();

        // 我们要代理哪个真实对象，就将该对象传进去，最后是通过该真实对象来调用其方法的
        InvocationHandler handler = new DynamicProxy(subject);

        /*
         * 通过Proxy的newProxyInstance方法来创建我们的代理对象，我们来看看其三个参数
         * 第一个参数subject.getClass().getClassLoader()，即Subject接口的实现类的ClassLoader对象来加载我们的代理对象
         * 第二个参数subject.getClass().getInterfaces()，即Subject接口的实现类所实现的一组接口（包括Subject接口）
         * 第三个参数handler， 即实现了InvocationHandler接口的动态代理类的对象
         */
        Subject proxy = (Subject)Proxy.newProxyInstance(subject.getClass().getClassLoader(), 
                            subject.getClass().getInterfaces(), handler);
        
        System.out.println(proxy.getClass().getName());
        proxy.rent();
        proxy.hello("world");
    }
}

    5、控制台的测试输出：

$Proxy0

before rent house
I want to rent my house
after rent house

before rent house
hello: world
after rent house

    我们首先来看看 $Proxy0 这东西，我们看到，这个东西是由 System.out.println(subject.getClass().getName()); 这条语句打印出来的，那么为什么我们返回的这个代理对象的类名是这样的呢？

Subject proxy = (Subject)Proxy.newProxyInstance(subject.getClass().getClassLoader(), 
                    subject.getClass().getInterfaces(), handler);

    可能我以为返回的这个代理对象会是Subject类型的对象，或者是InvocationHandler的对象，结果却不是。首先我们解释一下为什么我们这里可以将其转化为Subject类型的对象？原因就是在newProxyInstance这个方法的第二个参数上，我们给这个代理对象提供了一组真实对象所实现的接口，那么这个代理对象就会实现这组（合法的）接口，所以我们可以将这个代理对象强制类型转化为这组接口中的任意一个的实现类。

    需要注意的是，通过 Proxy.newProxyInstance 创建的代理对象是在jvm运行时动态生成的一个对象，它并不是我们的InvocationHandler类型，也不是我们定义的那组接口的类型，而是在运行是动态生成的一个对象，其命名方式是$ProxyN的形式，N为代理类的编号。

    接着我们来看看这两句

proxy.rent();
proxy.hello("world");

    这里是通过代理对象来调用实现的那种接口中的方法，这个时候程序就会跳转到由这个代理对象关联到的 handler 中的invoke方法去执行，而我们的这个 handler 对象又接受了一个 RealSubject类型的参数，表示我要代理的就是这个真实对象，所以此时就会调用 handler 中的invoke方法去执行：

public Object invoke(Object object, Method method, Object[] args) throws Throwable {
        // 在代理真实对象前我们可以添加一些自己的操作
        System.out.println("before rent house");
        
        // 当代理对象调用真实对象的方法时，其会自动的跳转到代理对象关联的handler对象的invoke方法来进行调用
        method.invoke(subject, args);
        
        // 在代理真实对象后我们也可以添加一些自己的操作
        System.out.println("after rent house");
        
        return null;
    }

    本篇随笔详细的讲解了java中的动态代理机制，这个知识点非常非常的重要，包括我们Spring的AOP其就是通过动态代理的机制实现的，所以我们必须要好好的理解动态代理的机制。