什么是 Java 中的动态代理？

Java 中的动态代理详解

1. 动态代理概述

动态代理是 Java 在运行时动态创建代理类和代理对象的机制。它允许在不修改原始类代码的情况下，对方法调用进行拦截、增强或修改。

核心特点

• 运行时生成：代理类在程序运行时动态创建，而非编译时
• 无侵入性：不需要修改被代理类的源代码
• 灵活性：可以统一处理多个类的相同逻辑

2. 动态代理 vs 静态代理

// 静态代理：编译时确定interfaceUserService{voidaddUser(Stringname);}classUserServiceImplimplementsUserService{publicvoidaddUser(Stringname){System.out.println("添加用户: "+name);}}classUserServiceProxyimplementsUserService{privateUserServicetarget;publicUserServiceProxy(UserServicetarget){this.target=target;}publicvoidaddUser(Stringname){System.out.println("前置增强：日志记录");target.addUser(name);System.out.println("后置增强：提交事务");}}// 使用UserServiceproxy=newUserServiceProxy(newUserServiceImpl());proxy.addUser("张三");

静态代理的问题：

• 每个接口需要单独编写代理类
• 代码重复，维护困难
• 不够灵活

3. Java 动态代理实现

3.1 基本结构

importjava.lang.reflect.InvocationHandler;importjava.lang.reflect.Method;importjava.lang.reflect.Proxy;// 1. 定义接口interfaceUserService{voidaddUser(Stringname);voiddeleteUser(Stringname);}// 2. 实现真实对象classUserServiceImplimplementsUserService{publicvoidaddUser(Stringname){System.out.println("添加用户: "+name);}publicvoiddeleteUser(Stringname){System.out.println("删除用户: "+name);}}// 3. 创建调用处理器classLogInvocationHandlerimplementsInvocationHandler{privateObjecttarget;// 被代理对象publicLogInvocationHandler(Objecttarget){this.target=target;}@OverridepublicObjectinvoke(Objectproxy,Methodmethod,Object[]args)throwsThrowable{// 前置增强System.out.println("【前置】调用方法: "+method.getName());System.out.println("【前置】参数: "+Arrays.toString(args));longstart=System.currentTimeMillis();// 调用真实对象的方法Objectresult=method.invoke(target,args);longend=System.currentTimeMillis();// 后置增强System.out.println("【后置】方法执行耗时: "+(end-start)+"ms");System.out.println("【后置】返回值: "+result);returnresult;}}// 4. 使用动态代理publicclassDynamicProxyDemo{publicstaticvoidmain(String[]args){// 创建真实对象UserServicerealService=newUserServiceImpl();// 创建代理对象UserServiceproxy=(UserService)Proxy.newProxyInstance(realService.getClass().getClassLoader(),// 类加载器realService.getClass().getInterfaces(),// 接口列表newLogInvocationHandler(realService)// 调用处理器);// 使用代理对象proxy.addUser("张三");System.out.println("----------");proxy.deleteUser("李四");}}

输出结果：

【前置】调用方法: addUser 【前置】参数: [张三] 添加用户: 张三 【后置】方法执行耗时: 0ms 【后置】返回值: null ---------- 【前置】调用方法: deleteUser 【前置】参数: [李四] 删除用户: 李四 【后置】方法执行耗时: 0ms 【后置】返回值: null

3.2 Proxy.newProxyInstance 参数说明

Objectproxy=Proxy.newProxyInstance(ClassLoaderloader,// 类加载器：通常使用被代理类的类加载器Class<?>[]interfaces,// 接口数组：代理对象需要实现的接口InvocationHandlerh// 调用处理器：方法调用的拦截逻辑);

4. InvocationHandler 接口

publicinterfaceInvocationHandler{/** * @param proxy 代理对象本身 * @param method 被调用的方法 * @param args 方法参数 * @return 方法返回值 */Objectinvoke(Objectproxy,Methodmethod,Object[]args)throwsThrowable;}

invoke 方法执行流程

客户端调用代理方法 ↓ Proxy 拦截调用 ↓ InvocationHandler.invoke() ↓ 前置处理（日志、权限等） ↓ method.invoke(target, args) // 调用真实对象 ↓ 后置处理（事务、统计等） ↓ 返回结果

5. 实际应用场景

5.1 日志记录

classLoggingHandlerimplementsInvocationHandler{privateObjecttarget;publicLoggingHandler(Objecttarget){this.target=target;}@OverridepublicObjectinvoke(Objectproxy,Methodmethod,Object[]args)throwsThrowable{System.out.println("[LOG] "+newDate()+" - 调用 "+method.getName());try{Objectresult=method.invoke(target,args);System.out.println("[LOG] "+method.getName()+" 执行成功");returnresult;}catch(Exceptione){System.out.println("[LOG] "+method.getName()+" 执行失败: "+e.getMessage());throwe;}}}

5.2 事务管理

classTransactionHandlerimplementsInvocationHandler{privateObjecttarget;@OverridepublicObjectinvoke(Objectproxy,Methodmethod,Object[]args)throwsThrowable{if(method.getName().startsWith("update")||method.getName().startsWith("delete")||method.getName().startsWith("insert")){System.out.println("开启事务");try{Objectresult=method.invoke(target,args);System.out.println("提交事务");returnresult;}catch(Exceptione){System.out.println("回滚事务");throwe;}}else{returnmethod.invoke(target,args);}}}

5.3 权限控制

classSecurityHandlerimplementsInvocationHandler{privateObjecttarget;privateStringcurrentUser;publicSecurityHandler(Objecttarget,StringcurrentUser){this.target=target;this.currentUser=currentUser;}@OverridepublicObjectinvoke(Objectproxy,Methodmethod,Object[]args)throwsThrowable{// 检查是否有权限if(method.isAnnotationPresent(RequiresAdmin.class)){if(!"admin".equals(currentUser)){thrownewSecurityException("无权限访问: "+method.getName());}}returnmethod.invoke(target,args);}}

5.4 缓存代理

classCacheHandlerimplementsInvocationHandler{privateObjecttarget;privateMap<String,Object>cache=newHashMap<>();@OverridepublicObjectinvoke(Objectproxy,Methodmethod,Object[]args)throwsThrowable{Stringkey=method.getName()+Arrays.toString(args);// 检查缓存if(cache.containsKey(key)){System.out.println("从缓存获取: "+key);returncache.get(key);}// 调用真实方法Objectresult=method.invoke(target,args);cache.put(key,result);returnresult;}}

6. 链式代理（多重代理）

// 创建多个代理UserServicerealService=newUserServiceImpl();// 第一层：日志代理UserServicelogProxy=(UserService)Proxy.newProxyInstance(realService.getClass().getClassLoader(),realService.getClass().getInterfaces(),newLogInvocationHandler(realService));// 第二层：事务代理（代理日志代理）UserServicetxProxy=(UserService)Proxy.newProxyInstance(logProxy.getClass().getClassLoader(),logProxy.getClass().getInterfaces(),newTransactionHandler(logProxy));// 调用txProxy.addUser("张三");

执行顺序：

事务前置 → 日志前置 → 真实方法 → 日志后置 → 事务后置

7. 动态代理的局限性

7.1 只能代理接口

// ❌ 错误：不能代理类classNoInterface{publicvoiddoSomething(){}}// 编译错误：NoInterface 不是接口NoInterfaceproxy=(NoInterface)Proxy.newProxyInstance(NoInterface.class.getClassLoader(),NoInterface.class.getInterfaces(),// 空数组handler);

7.2 解决方案：CGLIB

// CGLIB 可以代理类（通过继承）Enhancerenhancer=newEnhancer();enhancer.setSuperclass(NoInterface.class);enhancer.setCallback(newMethodInterceptor(){@OverridepublicObjectintercept(Objectobj,Methodmethod,Object[]args,MethodProxyproxy)throwsThrowable{System.out.println("前置增强");Objectresult=proxy.invokeSuper(obj,args);System.out.println("后置增强");returnresult;}});NoInterfaceproxy=(NoInterface)enhancer.create();

8. 动态代理在框架中的应用

Spring AOP

// Spring 使用动态代理实现 AOP@Service@TransactionalpublicclassUserService{@TransactionalpublicvoidcreateUser(Stringname){// Spring 会自动创建代理，处理事务}}

MyBatis Mapper

// MyBatis 使用动态代理创建 Mapper 接口实现UserMappermapper=sqlSession.getMapper(UserMapper.class);// mapper 是动态代理对象，方法调用会转换为 SQL 执行Useruser=mapper.selectById(1);

Retrofit

// Retrofit 使用动态代理创建 HTTP 接口publicinterfaceApiService{@GET("users/{id}")Call<User>getUser(@Path("id")intid);}ApiServiceservice=retrofit.create(ApiService.class);// service 是动态代理对象

9. 总结

动态代理是 Java 实现面向切面编程（AOP）的核心技术，广泛应用于各种框架中！