代理模式Cglib案例

wen java案例 2026-08-09 2

代理模式Cglib案例深度剖析：从动态代理到实战应用

目录导读

代理模式概述：为什么需要Cglib？
Cglib与JDK动态代理的核心差异
Cglib代理底层原理：字节码生成与继承机制
实战案例：基于Cglib实现方法拦截器
性能对比与使用陷阱
高频面试问答（QA精选）
总结与扩展阅读

代理模式概述：为什么需要Cglib？

在Java生态中，代理模式是一种结构型设计模式，它通过提供一个代理对象来控制对真实对象的访问，这种模式常用于AOP编程、延迟加载、访问控制等场景，传统JDK动态代理只能代理接口，而实际开发中很多业务类并未实现接口（如第三方库的类），此时Cglib（Code Generation Library）成为最佳替代方案。

代理模式Cglib案例

Cglib通过继承目标类并动态生成子类来实现代理，无需接口约束，它利用ASM字节码操作框架，在运行时生成目标类的子类，并重写需要拦截的方法，这种“继承式代理”让Cglib在Spring、Hibernate等框架中广泛应用。

Cglib与JDK动态代理的核心差异

对比维度	JDK动态代理	Cglib代理
代理对象生成方式	基于接口的Proxy类	基于继承的子类生成
目标类要求	必须实现接口	无接口限制
方法调用方式	InvocationHandler反射调用	MethodInterceptor+FastClass机制
性能（JDK8+）	反射调用开销略高	底层方法调用较快（但子类生成略耗时）
适用场景	接口明确的轻量代理	无接口类、复杂继承结构的代理

关键点：Cglib的FastClass机制为每个方法生成索引，调用时直接通过索引跳转，避免了反射开销,这也是其性能优势的来源之一。

Cglib代理底层原理：字节码生成与继承机制

Cglib核心工作流程如下：

通过Enhancer类指定父类（目标类）和回调（MethodInterceptor）。
使用ASM动态生成目标类的子类，并重写非final方法（final方法无法被覆盖）。
子类中维护MethodInterceptor引用，方法调用时触发intercept()方法。
intercept()方法接收四个参数：代理对象、被代理方法、参数数组、MethodProxy（方法代理）。

关键类：

net.sf.cglib.proxy.Enhancer：代理生成入口
net.sf.cglib.proxy.MethodInterceptor：方法拦截器
net.sf.cglib.proxy.MethodProxy：方法代理，提供invokeSuper()直接调用父类方法

实战案例：基于Cglib实现方法拦截器

假设我们有一个未实现任何接口的OrderService类，需要对其createOrder方法进行日志记录和性能监控。

引入依赖

<dependency>
    <groupId>cglib</groupId>
    <artifactId>cglib</artifactId>
    <version>3.3.0</version>
</dependency>

定义目标类

public class OrderService {
    public void createOrder(String orderId) {
        System.out.println("创建订单: " + orderId);
    }
    public final void cancelOrder(String orderId) { // final方法不会被代理
        System.out.println("取消订单: " + orderId);
    }
}

实现MethodInterceptor

public class LogInterceptor implements MethodInterceptor {
    @Override
    public Object intercept(Object obj, Method method, Object[] args, MethodProxy proxy) throws Throwable {
        System.out.println("【日志】方法 " + method.getName() + " 开始执行，参数: " + Arrays.toString(args));
        long start = System.currentTimeMillis();
        Object result = proxy.invokeSuper(obj, args); // 调用父类方法
        System.out.println("【日志】方法 " + method.getName() + " 执行完毕，耗时: " + (System.currentTimeMillis() - start) + "ms");
        return result;
    }
}

生成代理并测试

public class CglibDemo {
    public static void main(String[] args) {
        Enhancer enhancer = new Enhancer();
        enhancer.setSuperclass(OrderService.class);
        enhancer.setCallback(new LogInterceptor());
        OrderService proxy = (OrderService) enhancer.create();
        proxy.createOrder("ORD-20231001");
        // 注意：final方法无法被拦截，仍走原逻辑
        proxy.cancelOrder("ORD-20231001");
    }
}

运行输出：

【日志】方法 createOrder 开始执行，参数: [ORD-20231001]
创建订单: ORD-20231001
【日志】方法 createOrder 执行完毕，耗时: 1ms
取消订单: ORD-20231001

性能对比与使用陷阱

性能对比（基于JMH基准测试）

单次调用：Cglib（FastClass）比JDK动态代理快约10%-30%（JDK8+反射API优化后差异缩小）。
代理创建耗时：Cglib生成子类较慢,但一旦生成可复用。

使用陷阱

final方法不可代理：Cglib只能重写非final方法,若尝试代理final方法会报错或静默失效。
构造器问题：Cglib通过Enhancer.create()默认调用无参构造器，若目标类只有有参构造器，需设置enhancer.setConstructorArgs()。
包内私有及受保护方法：Cglib代理类位于目标类同包下，可代理受保护方法,但private方法无法被重写。
与Spring AOP的兼容性：Spring AOP默认使用JDK代理，若目标类无接口则自动切换Cglib（需确保依赖存在）。

高频面试问答（QA精选）

Q1：Cglib代理能否代理final类？ A：不能，Cglib通过生成子类实现代理，final类无法被继承，因此会抛出IllegalArgumentException。

Q2：Cglib代理和JDK代理如何选择？ A：若目标类实现了接口且无需代理非接口方法，优先选JDK代理（更轻量、易维护）；反之选Cglib，Spring AOP中若目标类无接口,Beans默认使用Cglib代理。

Q3：Cglib性能为什么比JDK代理好？ A：Cglib采用FastClass机制，为每个方法生成索引，调用时直接通过索引定位并执行方法，避开了反射的Method.invoke()开销，但JDK8+反射性能大幅提升,两者差距缩小。

Q4：Cglib代理中如何调用原始方法？ A：在MethodInterceptor.intercept()中，使用MethodProxy.invokeSuper(obj, args)调用父类（目标类）的原始方法，这比反射调用method.invoke()更高效。

Q5：Cglib会在什么情况下生成多个代理类？ A：每次Enhancer.create()可能生成新的代理类字节码，但Cglib内部自带类缓存（AbstractClassGenerator的子类缓存），相同配置会复用已有代理类,避免重复生成。

总结与扩展阅读

Cglib代理模式突破了JDK代理的接口限制，通过继承机制和ASM字节码技术，为无接口类提供了高效的动态代理方案，在实际项目中，它常与Spring AOP、MyBatis等框架集成，实现事务管理、日志监控等横切逻辑。

扩展建议：

深入研究ASM字节码框架,理解Cglib底层类生成过程。
结合Spring源码分析其DefaultAopProxyFactory如何决策使用JDK还是Cglib。
学习MethodProxy的invoke()与invokeSuper()差异（前者可递归触发拦截器，后者绕过拦截器）。

注：文中所有代码示例均基于Cglib 3.3.0版本，实际使用时请根据项目依赖版本适当调整，若需阅读更多技术分析，可检索“Cglib源码解析”“ASM字节码入门”等相关主题。

（本文已深度整合搜索引擎资料，并结合实战经验进行伪原创精简，确保内容对SEO友好且具有实际参考价值。）