本文意在讲解CGLIB的基础使用及基本原理。
一、CGLIB的基本原理：
依赖ASM字节码工具，通过动态生成实现接口或继承类的类字节码，实现动态代理。
针对接口，生成实现接口的类，即implements方式；针对类，生成继承父类的类，即extends方式。
二、为什么使用CGLIB？
JDK的动态代理只能基于接口，有时候我们想基于类生成动态代理，这个时候CGLIB是一个选择。
没什么场景下是必须使用CGLIB生成类代理的(个人观点)，如果有，可能是代码简洁，某些情况下性能较好。
CGLIB基于类生成动态代理需要注意？(CGLIB生成的代理是继承类的)
1. final声明的类是不能被代理的；
2. 类中的private,final方法不能被代理,static方法不生成代理方法。
二、使用方法：
基础示例代码：
public interface UserInterface {
boolean login(int userid);
}
public class UserInterfaceImpl implements UserInterface {
public boolean login(int userid) {
System.out.println("do Login!");
return false;
}
}
1. 代理接口：
public class CGlibProxy implements net.sf.cglib.proxy.InvocationHandler{ //这里的InvocationHandler是cglib包中的
private UserInterface ref;
public CGlibProxy(UserInterface ref){
this.ref = ref;
}
public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
System.out.println("before");
method.invoke(ref, args);
System.out.println("after");
return null;
}
}
public class Test {
public static void main(String[] args) throws IOException {
Enhancer en = new Enhancer();
en.setSuperclass(UserInterface.class);
en.setCallback(new CGlibProxy(new UserInterfaceImpl()));
UserInterface interfaced = (UserInterface) en.create();
interfaced.login(1);
}
}
代理接口和JDK的使用方法基本没啥区别，传入被代理实例对象，调用实例的对象的method方法。
所以如果是代理接口，完全没必要使用CGLIB。
2. 代理类：
public class CGlibProxy implements MethodInterceptor{
public Object intercept(Object obj, Method method, Object[] args, MethodProxy proxy) throws Throwable {
System.out.println("before");
Object o = proxy.invokeSuper(obj, args);
System.out.println("after");
return o;
}
}
public class Test {
public static void main(String[] args) throws IOException {
Enhancer en = new Enhancer();
en.setSuperclass(UserInterfaceImpl.class);
en.setCallback(new CGlibProxy());
UserInterface interfaced = (UserInterface) en.create();
interfaced.login(1);
}
}
3. Callback接口
Callback即代理方法，上述示例中MethodInterceptor就是Callback的子接口。Callback定义一个空接口，可以方便扩展。
Enhancer中有两个设置Callback的方法： setCallback(Callback callback), setCallbacks(Callback[] callbacks)。
你可能定义多个Callback,然后定义不同的代理行为，如下：
public class LoginProxy implements MethodInterceptor{
public Object intercept(Object obj, Method method, Object[] args, MethodProxy proxy) throws Throwable {
System.out.println("before login");
proxy.invokeSuper(obj, args);
System.out.println("after loign");
return null;
}
}
public class OtherProxy implements MethodInterceptor{
public Object intercept(Object obj, Method method, Object[] args, MethodProxy proxy) throws Throwable {
System.out.println("before");
proxy.invokeSuper(obj, args);
System.out.println("after");
return null;
}
}
cglib代理只能调用一个代理方法，所以当设置多个Callback时，你还需要指定一个CallbackFilter,通过Method条件指定Callback，
CallbackFilter接口：
public interface CallbackFilter {
int accept(Method method); //返回值为指定的Callback数组的下标索引
}
示例：
public class Test {
public static void main(String[] args) throws IOException {
Enhancer en = new Enhancer();
en.setSuperclass(UserInterfaceImpl.class);
en.setCallbacks(new Callback[]{new LoginProxy(),new OtherProxy()}); //callback数组
en.setCallbackFilter(new CallbackFilter() {
public int accept(Method method) {
if(method.getName().equals("login")){
return 0; //索引为0 ， 即 LoginProxy
}
return 1; // 索引为1， 即 OtherProxy
}
});
UserInterfaceImpl interfaced = (UserInterfaceImpl) en.create();
interfaced.login(1);
interfaced.other();
}
}
4. MethodInterceptor：MethodInterceptor接口是Callback的子接口，最常用。
public interface MethodInterceptorextends Callback {
//obj: 代理对象本身，即cglib生成的代理实例
//method: 被代理对象中的方法
//args：方法的参数
//proxy: 存储了代理类，也就是obj
public Object intercept(Object obj, Method method, Object[] args, MethodProxy proxy) throws Throwable;
}
如何调用被代理的目标方法?
MethodProxy的 invokeSuper(obj,args) 方法；obj就是 代理对象本身 ，args是对象参数；
MethodProxy还有一个invoke(obj,args)方法；obj参数是被代理对象，没搞懂这个方法的意图，个人觉得没什么必要。
5. NamingPolicy，自定义代理类名称，默认实现是DefaultNamingPolicy
public interface NamingPolicy {
String getClassName(String prefix, String source, Object key, Predicate names);
}
6. GeneratorStrategy，字节码生成策略，默认实现是DefaultGeneratorStrategy
public interface GeneratorStrategy {
byte[] generate(ClassGenerator cg) throws Exception;
}
你可以重写DefaultGeneratorStrategy中的方法来替换字节码生成器，也可以访问或修改生成的字节码，如下：
Enhancer en = new Enhancer();
en.setStrategy(new DefaultGeneratorStrategy(){
protected byte[] transform(byte[] b) throws Exception {
return b; //b 是生成的字节码
}
protected ClassGenerator transform(ClassGenerator cg) throws Exception {
return cg; //cg 是字节码生成器
}
});
7. interceptDuringConstruction，设置构造函数中的方法调用是否使用代理方法，默认为true。
示例：
public class UserInterfaceImpl implements UserInterface {
public UserInterfaceImpl(){
login(1); //构造函数中调用方法
}
public boolean login(int userid) {
System.out.println("do Login!");
return false;
}
}
public class Test {
public static void main(String[] args) throws IOException {
Enhancer en = new Enhancer();
en.setInterceptDuringConstruction(true);
en.setSuperclass(UserInterfaceImpl.class);
en.setCallback(new LoginProxy());
UserInterfaceImpl interfaced = (UserInterfaceImpl) en.create();
interfaced.login(1);
}
}
运行测试代码，结果如下，即login方法被代理了两次。
en.setInterceptDuringConstruction(false) 时，运行结果如下，即login方法被代理了一次
8. 没有默认构造函数时创建代理的方法：
public class UserInterfaceImpl implements UserInterface {
public UserInterfaceImpl(String param){
}
public boolean login(int userid) {
System.out.println("do Login!");
return false;
}
}
public class Test {
public static void main(String[] args) throws IOException {
Enhancer en = new Enhancer();
en.setSuperclass(UserInterfaceImpl.class);
en.setCallback(new LoginProxy());
UserInterfaceImpl interfaced = (UserInterfaceImpl) en.create(new Class[]{String.class}, new Object[]{"name"}); //创建方法中指定构造函数的参数类型及对应的参数值
interfaced.login(1);
}
}
三、cglib创建类代理的基本原理
如果让你实现类代理？ ---- 难点在哪里？
1. 创建代理的过程：
根据各种参数生成缓存的key --> 生成代理类(先缓存获取，缓存没有则用ClassGenerator生成代理类存入缓存) --> 根据代理类构造器生成代理对象实例。
2. 代理类对象：
可以设置系统参数cglib.debugLocation，开启代理类存入文件，该参数为文件存储路径。
示例代码：
public class UserInterfaceImpl implements UserInterface {
public boolean login(int userid) {
return false;
}
}
public class Test {
public static void main(String[] args) throws IOException {
System.setProperty("cglib.debugLocation", "E://test");
Enhancer en = new Enhancer();
en.setSuperclass(UserInterfaceImpl.class);
en.setCallback(new LoginProxy());
en.create();
}
}
运行后，test目录下会生成一些class文件，找到同包(自己的package)目录，反编译打开(用的luyten,比jdgui好用)
为了方便看，删除了一些不必要的代码；
package cglibproxy;
import java.lang.reflect.*;
import net.sf.cglib.proxy.*;
import net.sf.cglib.core.*;
public class UserInterfaceImpl$$EnhancerByCGLIB$$f2d3e293 extends UserInterfaceImpl implements Factory
{private MethodInterceptor CGLIB$CALLBACK_0;
private static Object CGLIB$CALLBACK_FILTER;
private static final Method CGLIB$login$0$Method;
private static final MethodProxy CGLIB$login$0$Proxy;
private static final Method CGLIB$equals$1$Method;
private static final MethodProxy CGLIB$equals$1$Proxy;
private static final Method CGLIB$toString$2$Method;
private static final MethodProxy CGLIB$toString$2$Proxy;
private static final Method CGLIB$hashCode$3$Method;
private static final MethodProxy CGLIB$hashCode$3$Proxy;
private static final Method CGLIB$clone$4$Method;
private static final MethodProxy CGLIB$clone$4$Proxy;
final boolean CGLIB$login$0(final int n) {
return super.login(n);
} public final boolean login(final int n) {
MethodInterceptor cglib$CALLBACK_2;
MethodInterceptor cglib$CALLBACK_0;
if ((cglib$CALLBACK_0 = (cglib$CALLBACK_2 = this.CGLIB$CALLBACK_0)) == null) {
CGLIB$BIND_CALLBACKS(this);
cglib$CALLBACK_2 = (cglib$CALLBACK_0 = this.CGLIB$CALLBACK_0);
}
if (cglib$CALLBACK_0 != null) {
final Object intercept = cglib$CALLBACK_2.intercept((Object)this, UserInterfaceImpl$$EnhancerByCGLIB$$f2d3e293.CGLIB$login$0$Method, new Object[] { new Integer(n) }, UserInterfaceImpl$$EnhancerByCGLIB$$f2d3e293.CGLIB$login$0$Proxy);
return intercept != null && (boolean)intercept;
}
return super.login(n);
}
}
可以从反编译的代理类中看到：
代理类继承了被代理类，Factory接口是cglib的内部接口，有兴趣的可以去看一下；
代理类代理了两种方法，一种是被代理类(即我们自定义的方法)，一种是Object中的4个方法(toString, equals, hashCode, clone);
代理类针对每个方法，生成了两个方法(一个代理方法，一个原方法) (为什么这么做？想想MethodProxy.invokeSuper(),这里是一个关键点)；
代理类中的目标方法都使用了final声明，禁止继续被代理；
以上就是个人总结的cglib的一些基础，水平有限，有问题欢迎评论中指正，谢谢！
原创文章，转载请注明出处。