欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页

Javassist实现动态代理

程序员文章站 2022-03-14 23:10:09
...

动态代理模式简述:之所以会出现代理这种模式就是因为我们常有这么一种需求:在被代理类的方法调用前后执行一些其它的逻辑,这些逻辑不适合由被代理类来实现,那这些逻辑谁来实现?当然是代理类。那代理类是谁?从哪里来?代理类是我们利用字节码生成工具动态创建的,然后利用反射实例化而得到代理对象。

tips:这篇文章讲的不是动态代理模式的思想而是怎么实现(简单实现)一个和java.lang.reflect.Proxy类相似的类。

按照JDK动态代理的套路来,先定义一个InvocationHandler来给客户端添加代理的逻辑(这个类和JDK中的一模一样):

package cc.lixiaohui.demo.javassist.proxy;  

import java.lang.reflect.Method;  

/** 
 * @author lixiaohui 
 * @date 2016年9月27日 下午9:53:59 
 *  
 */  
public interface InvocationHandler {  

    /** 
     * 业务逻辑填充 
     *  
     * @param proxy 生成的代理对象 
     * @param method 调用的方法 
     * @param args 调用该方法的参数 
     * @return 调用该方法的返回值 
     * @throws Throwable throws if any exception 
     */  
    Object invoke(Object proxy, Method method, Object[] args) throws Throwable;  

}  

接下来是Proxy类,代理类由该类动态生成并且都继承自该类,和JDK的一样,这也是为什么JDK的动态代理只能代理接口而不能代理父类,这里我就按照JDK的套路来,当然理解了这个后要实现代理父类也没什么难度了。Proxy类是怎么生成类的呢?首先代理的是接口,所以先遍历所有接口,再遍历接口的所有方法,为代理类生成与这些方法同签名同返回值的方法,也就是相当于实现(implement)这些接口的方法,至于生成过程具体是怎么样的我们不用管这也是用javassist的好处(字节码是怎么生成的是javassist的事,我们只需要用它的API即可)。

package cc.lixiaohui.demo.javassist.proxy;  

import java.util.Objects;  
import java.util.concurrent.atomic.AtomicInteger;  

import javassist.CannotCompileException;  
import javassist.ClassPool;  
import javassist.CtClass;  
import javassist.CtConstructor;  
import javassist.CtField;  
import javassist.CtMethod;  
import javassist.Modifier;  
import javassist.NotFoundException;  

import org.slf4j.Logger;  
import org.slf4j.LoggerFactory;  

import cc.lixiaohui.demo.javassist.proxy.util.CompoundKeyWeakHashMap;  

/** 
 * 负责代理类类的生成 
 *  
 * <ul> 
 * 生成的代理类: 
 * <li>public final 修饰(和JDK动态代理不同的是:JDK生成的代理类也是final的, 但不一定是public的, 当所代理的接口中有至少一个以上的接口不是public时生成的代理就不是public的)</li> 
 *  
 * <li>类名以$Proxy为前缀, 后缀为数字, 如cc.lixiaohui.$Proxy0, cc.lixiaohui.$Proxy1...</li> 
 *  
 * <li>生成的代理类继承自{@link Proxy}</li> 
 *  
 * <li>生成的代理类所在package只有一种情况下才是确定的: 当所有接口中有且只有一个接口是non-public时.其他情况所在package不确定</li> 
 * </ul> 
 *   
 * @author lixiaohui 
 * @date 2016年9月27日 下午9:51:24 
 *  
 */  
public class Proxy {  

    private static final Logger logger = LoggerFactory.getLogger(Proxy.class);  

    /** 
     * 生成的代理类名前缀 
     */  
    private static final String PROXY_CLASSNAME_PREFIX = "$Proxy";  

    /** 
     * 类后缀数字生成器 
     */  
    private static final AtomicInteger SUFFIX_GENERATOR = new AtomicInteger();   

    private static final boolean SHOULD_BE_FINAL = true;  
    private static final boolean SHOULD_BE_ABSTRACT = false;  
    private static final boolean SHOULD_BE_PUBLIC = true;  

    protected InvocationHandler invocationHandler;  

    /** 
     * 弱引用已生成的Class的缓存, ClassLoader和被代理Class都相同时生成的代理Class才是相同的(这个类自己实现的,简单扩展一下java.util.Map就可以实现) 
     * <类加载器, 被代理Class, 生成的代理Class> 
     */  
    private static CompoundKeyWeakHashMap<ClassLoader, Class<?>, Class<?>> proxyClassCache = new CompoundKeyWeakHashMap<ClassLoader, Class<?>, Class<?>>();  

    protected Proxy(InvocationHandler invocationHandler) {  
        this.invocationHandler = invocationHandler;  
    }  

    public static Object newProxyInstance(ClassLoader classLoader, Class<?> targetClass, InvocationHandler invocationHandler)   
            throws Exception {  
        // check not null  
        classLoader = Objects.requireNonNull(classLoader, "classLoader cannot be null");  
        targetClass = Objects.requireNonNull(targetClass, "targetClass cannot be null");  
        invocationHandler = Objects.requireNonNull(invocationHandler, "invocationHandler cannot be null");  

        Class<?> proxyClass = proxyClassCache.get(classLoader, targetClass);  
        // 有缓存  
        if (proxyClass != null) {  
            logger.debug("get proxy from cache");  
            return proxyClass.getConstructor(InvocationHandler.class).newInstance(invocationHandler);  
        }  

        // singleton instance of classpool   
        ClassPool pool = ClassPool.getDefault();  
        //生成代理类的全限定名  
        String qualifiedName = generateQualifiedName(targetClass);  
        // 创建代理类  
        CtClass proxy = pool.makeClass(qualifiedName);  
        // 设被代理类继承自Proxy  
        setSuperClass(pool, proxy);  
        // 获取被代理类的所有接口  
        CtClass[] interfaces = pool.get(targetClass.getName()).getInterfaces();  

        int methodIndex = 0;  
        // 遍历这些接口  
        for (CtClass parent : interfaces) {  
            proxy.addInterface(parent);  

            // 获取该接口的所有方法  
            CtMethod[] methods = parent.getDeclaredMethods();  
            for (int j = 0; j < methods.length; ++j) {  
                CtMethod method = methods[j];  
                String fieldSrc = String.format("private static java.lang.reflect.Method method%d = Class.forName(\"%s\").getDeclaredMethods()[%d];"  
                        , methodIndex, parent.getName(), j);  
                logger.debug("field src for method {}: {}", method.getName(), fieldSrc);  
                // 生成字段  
                CtField ctField = CtField.make(fieldSrc, proxy);  
                // 添加字段  
                proxy.addField(ctField);  
                // 生成对应的Method  
                generateMethod(pool, proxy, method, methodIndex);  

                ++methodIndex;  
            }  
        }  
        // 设置代理类的类修饰符  
        setModifiers(proxy, SHOULD_BE_PUBLIC, SHOULD_BE_FINAL, SHOULD_BE_ABSTRACT);  
        // 生成构造方法  
        generateConstructor(pool, proxy);  
        // 持久化class到硬盘, for use of debug  
        proxy.writeFile(".");  
        // to java.lang.Class  
        proxyClass = proxy.toClass(classLoader, null);  
        // 缓存  
        proxyClassCache.put(classLoader, targetClass, proxyClass);  
        return proxyClass.getConstructor(InvocationHandler.class).newInstance(invocationHandler);  
    }  

    /** 
     * 生成代理类的全限定名  
     */  
    private static String generateQualifiedName(Class<?> targetClass) throws Exception {  
        CtClass theInterface = null;  
        for (CtClass parent : ClassPool.getDefault().get(targetClass.getName()).getInterfaces()) {  
            if (theInterface == null) {  
                theInterface = parent;  
            }  
            if (!Modifier.isPublic(parent.getModifiers())) {  
                theInterface = parent;  
                break;  
            }  
        }  
        String name = theInterface.getPackageName() + "." + PROXY_CLASSNAME_PREFIX + SUFFIX_GENERATOR.getAndIncrement();  
        return name;  
    }  


    /** 
     * 设置类的修饰符 
     */  
    private static void setModifiers(CtClass proxy, boolean shouldBePublic, boolean shouldBeFinal, boolean shouldBeAbstract) {  
        int modifier = 0;  
        modifier = shouldBePublic ? modifier | Modifier.PUBLIC : modifier;  
        modifier = shouldBeFinal ? modifier | Modifier.FINAL : modifier;  
        modifier = shouldBeAbstract ? modifier | Modifier.ABSTRACT : modifier;  
        logger.error(Modifier.toString(modifier));  
        proxy.setModifiers(modifier);  
    }  

    /** 
     * 生成构造函数 
     */  
    private static void generateConstructor(ClassPool pool, CtClass proxy) throws NotFoundException, CannotCompileException {  
        CtConstructor ctConstructor = new CtConstructor(new CtClass[]{pool.get(InvocationHandler.class.getName())}, proxy);  
        String methodBodySrc = String.format("super(%s);", "$1");  
        logger.debug("constructor body for constructor {}: {}", ctConstructor.getName(), methodBodySrc);  
        ctConstructor.setBody(methodBodySrc);  
        proxy.addConstructor(ctConstructor);  
    }  


    /** 
     * 生成代理方法 
     */  
    private static void generateMethod(ClassPool pool, CtClass proxy, CtMethod method, int methodIndex) throws NotFoundException, CannotCompileException {  
        CtMethod ctMethod = new CtMethod(method.getReturnType(), method.getName(), method.getParameterTypes(), proxy);  
        String methodBodySrc = String.format("return super.invocationHandler.invoke(this, method%d, $args);", methodIndex);  
        logger.debug("method body for method {}: {}", method.getName(), methodBodySrc);  
        ctMethod.setBody(methodBodySrc);  
        proxy.addMethod(ctMethod);  
    }  

    /** 
     * 把proxy类的父类设置为Proxy 
     *  
     */  
    private static void setSuperClass(ClassPool pool, CtClass proxy) throws CannotCompileException, NotFoundException {  
        proxy.setSuperclass(pool.get(Proxy.class.getName()));  
    }  

}  

使用测试

使用方式和JDK的没啥区别

先定义两个被代理的接口:

package cc.lixiaohui.demo.javassist.proxy.example;  

public interface Talkable {   
    Object talk(String words) throws Exception;   
}  
package cc.lixiaohui.demo.javassist.proxy.example;  

interface Smileable {  
    Object smile() throws Exception;  
}  

Person实现上面两接口:

package cc.lixiaohui.demo.javassist.proxy.example;  

public class Person implements Smileable, Talkable {  

    private String name;  

    public Person(String name) {  
        this.name = name;  
    }  

    public Object talk(String words) throws Exception {  
        System.out.println(name + " says: " + words);  
        return words;  
    }  

    public Object smile() throws Exception {  
        System.out.println(name + " start smiling");  
        System.out.println(name + " stop smiling");  
        return null;  
    }  

}  

代理逻辑的实现:

package cc.lixiaohui.demo.javassist.proxy.example;  

import java.lang.reflect.Method;  

import cc.lixiaohui.demo.javassist.proxy.InvocationHandler;  
import cc.lixiaohui.demo.javassist.proxy.Proxy;  

public class JavassistProxyFactory implements InvocationHandler{  

    //被代理类的对象  
    private Object target;  

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

    /*  
     * @see cc.lixiaohui.demo.javassist.proxy.InvocationHandler#invoke(java.lang.Object, java.lang.reflect.Method, java.lang.Object[]) 
     */  
    public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {  
        System.out.println("------- intercept before --------");  
                // 调用原来的方法  
        Object result = method.invoke(target, args);  
        System.out.println("--------intercept after ---------");  
        return result;  
    }  
    // 获取代理类的对象  
    public Object getProxy() throws Exception {  
        return Proxy.newProxyInstance(Thread.currentThread().getContextClassLoader(), target.getClass(), this);  
    }  

}  

测试主程序:

package cc.lixiaohui.demo.javassist.proxy.example;  

import java.lang.reflect.Modifier;  

import org.junit.Test;  

public class Tester {  

    @Test  
    public void testJavassist() throws Exception {  
        Person person = new Person("小明");  
        Object proxy = new JavassistProxyFactory(person).getProxy();  
                // System.gc(); // 主动触发gc  
        Object proxy1 = new JavassistProxyFactory(person).getProxy();  
        ((Talkable) proxy).talk("hello world");  
        ((Smileable) proxy).smile();  

        System.out.println("package: " + proxy.getClass().getPackage().getName());  
        System.out.println("classname: " + proxy.getClass().getName());  
        System.out.println("modifiers: " + Modifier.toString(proxy.getClass().getModifiers()));  
                System.out.println(proxy.getClass() == proxy1.getClass()); // 测试缓存是否起作用  
    }  

}  

结果输出:
Javassist实现动态代理

在 Proxy类中生成代理Class时把这个Class持久化了到硬盘中,通过反编译工具查看生成的代理类的源码:

/*** Eclipse Class Decompiler plugin, copyright (c) 2016 Chen Chao (aaa@qq.com) ***/  
package cc.lixiaohui.demo.javassist.proxy.example;  

import cc.lixiaohui.demo.javassist.proxy.InvocationHandler;  
import cc.lixiaohui.demo.javassist.proxy.Proxy;  
import java.lang.reflect.Method;  

public final class $Proxy0 extends Proxy implements Smileable, Talkable {  
    private static Method method0 = java.lang.Class.forName("cc.lixiaohui.demo.javassist.proxy.example.Smileable").getDeclaredMethods()[0];  
    private static Method method1 = java.lang.Class.forName("cc.lixiaohui.demo.javassist.proxy.example.Talkable").getDeclaredMethods()[0];  

    public Object smile() {  
        return this.invocationHandler.invoke(this, method0, new Object[0]);  
    }  

    public Object talk(String paramString) {  
        return this.invocationHandler.invoke(this, method1, new Object[] { paramString });  
    }  

    public $Proxy0(InvocationHandler paramInvocationHandler) {  
        super(paramInvocationHandler);  
    }  
}  

转载自http://lixiaohui.iteye.com/blog/2328182