一、什麼是 CGLIB?
CGLIB是一個功能強大,高性能的代碼生成包。它爲沒有實現接口的類提供代理,爲JDK的動態代理提供了很好的補充。通常可以使用Java的動態代理創建代理,但當要代理的類沒有實現接口或者爲了更好的性能,CGLIB是一個好的選擇。
CGLIB作爲一個開源項目,其代碼託管在github,地址爲:https://github.com/cglib/cglib
二、CGLIB 原理
CGLIB 原理:動態生成一個要代理類的子類,子類重寫要代理的類的所有不是final的方法。在子類中採用方法攔截的技術攔截所有父類方法的調用,順勢織入橫切邏輯。它比使用java反射的JDK動態代理要快。
CGLIB 底層:使用字節碼處理框架ASM,來轉換字節碼並生成新的類。不鼓勵直接使用ASM,因爲它要求你必須對JVM內部結構包括class文件的格式和指令集都很熟悉。
CGLIB缺點:對於final方法,無法進行代理。
三、CGLIB 的應用
廣泛的被許多AOP的框架使用,例如Spring AOP和dynaop。Hibernate使用CGLIB來代理單端single-ended(多對一和一對一)關聯。
四、爲什麼使用 CGLIB?
CGLIB代理主要通過對字節碼的操作,爲對象引入間接級別,以控制對象的訪問。我們知道Java中有一個動態代理也是做這個事情的,那我們爲什麼不直接使用Java動態代理,而要使用CGLIB呢?答案是CGLIB相比於JDK動態代理更加強大,JDK動態代理雖然簡單易用,但是其有一個致命缺陷是,只能對接口進行代理。如果要代理的類爲一個普通類、沒有接口,那麼Java動態代理就沒法使用了。
五、CGLIB組成結構
CGLIB底層使用了ASM(一個短小精悍的字節碼操作框架)來操作字節碼生成新的類。除了CGLIB庫外,腳本語言(如Groovy何BeanShell)也使用ASM生成字節碼。ASM使用類似SAX的解析器來實現高性能。我們不鼓勵直接使用ASM,因爲它需要對Java字節碼的格式足夠的瞭解。
六、CGLIB的API
1、Jar包:
- cglib-nodep-2.2.jar:使用nodep包不需要關聯asm的jar包,jar包內部包含asm的類.
- cglib-2.2.jar:使用此jar包需要關聯asm的jar包,否則運行時報錯.
2、CGLIB類庫:
由於基本代碼很少,學起來有一定的困難,主要是缺少文檔和示例,這也是CGLIB的一個不足之處。
本系列使用的CGLIB版本是2.2。
- net.sf.cglib.core: 底層字節碼處理類,他們大部分與ASM有關係。
- net.sf.cglib.transform: 編譯期或運行期類和類文件的轉換
- net.sf.cglib.proxy: 實現創建代理和方法攔截器的類
- net.sf.cglib.reflect: 實現快速反射和C#風格代理的類
- net.sf.cglib.util: 集合排序等工具類
- net.sf.cglib.beans: JavaBean相關的工具類
本篇介紹通過MethodInterceptor和Enhancer實現一個動態代理。
一、首先說一下JDK中的動態代理:
JDK中的動態代理是通過反射類Proxy以及InvocationHandler回調接口實現的,但是,JDK中所要進行動態代理的類必須要實現一個接口,也就是說只能對該類所實現接口中定義的方法進行代理,這在實際編程中具有一定的侷限性,而且使用反射的效率也並不是很高。
二、使用CGLib實現:
使用CGLib實現動態代理,完全不受代理類必須實現接口的限制,而且CGLib底層採用ASM字節碼生成框架,使用字節碼技術生成代理類,比使用Java反射效率要高。唯一需要注意的是,CGLib不能對聲明爲final的方法進行代理,因爲CGLib原理是動態生成被代理類的子類。
下面,將通過一個實例介紹使用CGLib實現動態代理。
1、被代理類:
首先,定義一個類,該類沒有實現任何接口。
public class TargetObject {
public String method1(String paramName) {
return paramName;
}
public int method2(int count) {
return count;
}
public int method3(int count) {
return count;
}
@Override
public String toString() {
return "TargetObject []"+ getClass();
}
}
2、攔截器:
定義一個攔截器。在調用目標方法時,CGLib會回調MethodInterceptor接口方法攔截,來實現你自己的代理邏輯,類似於JDK中的InvocationHandler接口。
public class TargetInterceptor implements MethodInterceptor{
@Override
public Object intercept(Object obj, Method method, Object[] params,
MethodProxy proxy) throws Throwable {
System.out.println("調用前");
Object result = proxy.invokeSuper(obj, params);
System.out.println("調用後"+result);
return result;
}
}
參數:Object爲由CGLib動態生成的代理類實例,Method爲上文中實體類所調用的被代理的方法引用,Object[]爲參數值列表,MethodProxy爲生成的代理類對方法的代理引用。
返回:從代理實例的方法調用返回的值。
其中,proxy.invokeSuper(obj,arg) 調用代理類實例上的proxy方法的父類方法(即實體類TargetObject中對應的方法)
在這個示例中,只在調用被代理類方法前後各打印了一句話,當然實際編程中可以是其它複雜邏輯。
3、生成動態代理類:
public class TestCglib {
public static void main(String args[]) {
Enhancer enhancer =new Enhancer();
enhancer.setSuperclass(TargetObject.class);
enhancer.setCallback(new TargetInterceptor());
TargetObject targetObject2=(TargetObject)enhancer.create();
System.out.println(targetObject2);
System.out.println(targetObject2.method1("mmm1"));
System.out.println(targetObject2.method2(100));
System.out.println(targetObject2.method3(200));
}
}
這裏Enhancer類是CGLib中的一個字節碼增強器,它可以方便的對你想要處理的類進行擴展,以後會經常看到它。
首先將被代理類TargetObject設置成父類,然後設置攔截器TargetInterceptor,最後執行enhancer.create()動態生成一個代理類,並從Object強制轉型成父類型TargetObject。
最後,在代理類上調用方法。
4、回調過濾器CallbackFilter
一、作用
在CGLib回調時可以設置對不同方法執行不同的回調邏輯,或者根本不執行回調。
在JDK動態代理中並沒有類似的功能,對InvocationHandler接口方法的調用對代理類內的所以方法都有效。
定義實現過濾器CallbackFilter接口的類:
public class TargetMethodCallbackFilter implements CallbackFilter {
@Override
public int accept(Method method) {
if(method.getName().equals("method1")){
System.out.println("filter method1 == 0");
return 0;
}
if(method.getName().equals("method2")){
System.out.println("filter method2 == 1");
return 1;
}
if(method.getName().equals("method3")){
System.out.println("filter method3 == 2");
return 2;
}
return 0;
}
}
其中return值爲被代理類的各個方法在回調數組Callback[]中的位置索引(見下文)。
public class TestCglib {
public static void main(String args[]) {
Enhancer enhancer =new Enhancer();
enhancer.setSuperclass(TargetObject.class);
CallbackFilter callbackFilter = new TargetMethodCallbackFilter();
/**
* (1)callback1:方法攔截器
(2)NoOp.INSTANCE:這個NoOp表示no operator,即什麼操作也不做,代理類直接調用被代理的方法不進行攔截。
(3)FixedValue:表示鎖定方法返回值,無論被代理類的方法返回什麼值,回調方法都返回固定值。
*/
Callback noopCb=NoOp.INSTANCE;
Callback callback1=new TargetInterceptor();
Callback fixedValue=new TargetResultFixed();
Callback[] cbarray=new Callback[]{callback1,noopCb,fixedValue};
//enhancer.setCallback(new TargetInterceptor());
enhancer.setCallbacks(cbarray);
enhancer.setCallbackFilter(callbackFilter);
TargetObject targetObject2=(TargetObject)enhancer.create();
System.out.println(targetObject2);
System.out.println(targetObject2.method1("mmm1"));
System.out.println(targetObject2.method2(100));
System.out.println(targetObject2.method3(100));
System.out.println(targetObject2.method3(200));
}
}
public class TargetResultFixed implements FixedValue{
/**
* 該類實現FixedValue接口,同時鎖定回調值爲999
* (整型,CallbackFilter中定義的使用FixedValue型回調的方法爲getConcreteMethodFixedValue,該方法返回值爲整型)。
*/
@Override
public Object loadObject() throws Exception {
System.out.println("鎖定結果");
Object obj = 999;
return obj;
}
}
5.延遲加載對象
一、作用:
說到延遲加載,應該經常接觸到,尤其是使用Hibernate的時候,本篇將通過一個實例分析延遲加載的實現方式。 LazyLoader接口繼承了Callback,因此也算是CGLib中的一種Callback類型。
另一種延遲加載接口Dispatcher。
Dispatcher接口同樣繼承於Callback,也是一種回調類型。
但是Dispatcher和LazyLoader的區別在於:LazyLoader只在第一次訪問延遲加載屬性時觸發代理類回調方法,而Dispatcher在每次訪問延遲加載屬性時都會觸發代理類回調方法。
二、示例:
首先定義一個實體類LoaderBean,該Bean內有一個需要延遲加載的屬性PropertyBean。
public class LazyBean {
private String name;
private int age;
private PropertyBean propertyBean;
private PropertyBean propertyBeanDispatcher;
public LazyBean(String name, int age) {
System.out.println("lazy bean init");
this.name = name;
this.age = age;
this.propertyBean = createPropertyBean();
this.propertyBeanDispatcher = createPropertyBeanDispatcher();
}
/**
* 只第一次懶加載
* @return
*/
private PropertyBean createPropertyBean() {
/**
* 使用cglib進行懶加載 對需要延遲加載的對象添加代理,在獲取該對象屬性時先通過代理類回調方法進行對象初始化。
* 在不需要加載該對象時,只要不去獲取該對象內屬性,該對象就不會被初始化了(在CGLib的實現中只要去訪問該對象內屬性的getter方法,
* 就會自動觸發代理類回調)。
*/
Enhancer enhancer = new Enhancer();
enhancer.setSuperclass(PropertyBean.class);
PropertyBean pb = (PropertyBean) enhancer.create(PropertyBean.class,
new ConcreteClassLazyLoader());
return pb;
}
/**
* 每次都懶加載
* @return
*/
private PropertyBean createPropertyBeanDispatcher() {
Enhancer enhancer = new Enhancer();
enhancer.setSuperclass(PropertyBean.class);
PropertyBean pb = (PropertyBean) enhancer.create(PropertyBean.class,
new ConcreteClassDispatcher());
return pb;
}
public String getName() {
return name;
}
public void setName(String name) {
this.name = name;
}
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
public PropertyBean getPropertyBean() {
return propertyBean;
}
public void setPropertyBean(PropertyBean propertyBean) {
this.propertyBean = propertyBean;
}
public PropertyBean getPropertyBeanDispatcher() {
return propertyBeanDispatcher;
}
public void setPropertyBeanDispatcher(PropertyBean propertyBeanDispatcher) {
this.propertyBeanDispatcher = propertyBeanDispatcher;
}
@Override
public String toString() {
return "LazyBean [name=" + name + ", age=" + age + ", propertyBean="
+ propertyBean + "]";
}
}
public class PropertyBean {
private String key;
private Object value;
public String getKey() {
return key;
}
public void setKey(String key) {
this.key = key;
}
public Object getValue() {
return value;
}
public void setValue(Object value) {
this.value = value;
}
@Override
public String toString() {
return "PropertyBean [key=" + key + ", value=" + value + "]" +getClass();
}
}
public class ConcreteClassLazyLoader implements LazyLoader {
/**
* 對需要延遲加載的對象添加代理,在獲取該對象屬性時先通過代理類回調方法進行對象初始化。
* 在不需要加載該對象時,只要不去獲取該對象內屬性,該對象就不會被初始化了(在CGLib的實現中只要去訪問該對象內屬性的getter方法,
* 就會自動觸發代理類回調)。
*/
@Override
public Object loadObject() throws Exception {
System.out.println("before lazyLoader...");
PropertyBean propertyBean = new PropertyBean();
propertyBean.setKey("zghw");
propertyBean.setValue(new TargetObject());
System.out.println("after lazyLoader...");
return propertyBean;
}
}
public class ConcreteClassDispatcher implements Dispatcher{
@Override
public Object loadObject() throws Exception {
System.out.println("before Dispatcher...");
PropertyBean propertyBean = new PropertyBean();
propertyBean.setKey("xxx");
propertyBean.setValue(new TargetObject());
System.out.println("after Dispatcher...");
return propertyBean;
}
}
測試調用:
public class TestCglib3 {
public static void main(String[] args) {
LazyBean lazybean = new LazyBean("wjy", 33);
PropertyBean pb1 = lazybean.getPropertyBean();
System.out.println("key =" + pb1.getKey() + ", value = " + pb1.getValue());
PropertyBean pb2 = lazybean.getPropertyBeanDispatcher();
System.out.println("key =" + pb2.getKey() + ", value = " + pb2.getValue());
}
}
6.接口生成器InterfaceMaker
一、作用:
InterfaceMaker會動態生成一個接口,該接口包含指定類定義的所有方法。
二、示例:
public class TestInterfaceMaker {
public static void main(String[] args) throws NoSuchMethodException, SecurityException, IllegalAccessException, IllegalArgumentException, InvocationTargetException {
InterfaceMaker interfaceMaker =new InterfaceMaker();
//抽取某個類的方法生成接口方法
interfaceMaker.add(TargetObject.class);
Class<?> targetInterface=interfaceMaker.create();
for(Method method : targetInterface.getMethods()){
System.out.println(method.getName());
}
//接口代理並設置代理接口方法攔截
Object object = Enhancer.create(Object.class, new Class[]{targetInterface}, new MethodInterceptor(){
@Override
public Object intercept(Object obj, Method method, Object[] args,
MethodProxy methodProxy) throws Throwable {
if(method.getName().equals("method1")){
System.out.println("filter method1 ");
return "111111";
}
if(method.getName().equals("method2")){
System.out.println("filter method2 ");
return 222222;
}
if(method.getName().equals("method3")){
System.out.println("filter method3 ");
return 333333;
}
return "default";
}});
Method targetMethod1=object.getClass().getMethod("method3",new Class[]{int.class});
int i=(int)targetMethod1.invoke(object, new Object[]{33});
Method targetMethod=object.getClass().getMethod("method1",new Class[]{String.class});
System.out.println(targetMethod.invoke(object, new Object[]{"sdfs"}));
}
}