1. 代理模式的核心概念与应用场景代理模式Proxy Pattern是23种经典设计模式中结构型模式的代表之一。它通过创建一个代理对象来控制对原始对象的访问这种模式在实际开发中有着广泛的应用场景。我第一次接触代理模式是在处理一个需要权限控制的文件系统项目时当时需要根据不同用户的权限级别限制对某些敏感文件的访问。代理模式的核心在于控制访问它就像一个看门人决定谁可以进入、什么时候可以进入以及进入后能做什么。这种模式特别适用于以下场景远程代理Remote Proxy为位于不同地址空间的对象提供本地代表就像我们常用的远程服务调用RPC框架底层实现虚拟代理Virtual Proxy用于延迟加载大对象如图片懒加载、大数据分页查询保护代理Protection Proxy控制对原始对象的访问权限比如Spring Security的权限控制智能引用代理Smart Reference Proxy在访问对象时执行额外操作如引用计数、对象锁定检查等提示代理模式与装饰器模式在结构上很相似但目的不同。装饰器模式重在增强功能而代理模式重在控制访问。2. 代理模式的三种实现方式与代码示例2.1 静态代理实现静态代理是最基础的实现方式需要手动创建代理类。下面是一个Java实现的文件访问控制示例// 抽象主题接口 public interface FileAccess { void read(String fileName); void write(String fileName, String content); } // 真实主题类 public class RealFileAccess implements FileAccess { Override public void read(String fileName) { System.out.println(读取文件: fileName); } Override public void write(String fileName, String content) { System.out.println(写入文件: fileName , 内容: content); } } // 代理类 public class FileAccessProxy implements FileAccess { private RealFileAccess realFileAccess; private String userRole; public FileAccessProxy(String userRole) { this.userRole userRole; this.realFileAccess new RealFileAccess(); } Override public void read(String fileName) { if (checkAccess(fileName, read)) { realFileAccess.read(fileName); } else { System.out.println(无权限读取文件: fileName); } } Override public void write(String fileName, String content) { if (checkAccess(fileName, write)) { realFileAccess.write(fileName, content); } else { System.out.println(无权限写入文件: fileName); } } private boolean checkAccess(String fileName, String operation) { // 简单的权限检查逻辑 if (admin.equals(userRole)) return true; if (read.equals(operation)) return true; return false; } }静态代理的优点是简单直接但缺点是每个真实主题类都需要创建一个对应的代理类当系统规模变大时会非常繁琐。2.2 JDK动态代理实现Java提供了内置的动态代理机制可以运行时动态创建代理类。下面是一个使用JDK动态代理的示例import java.lang.reflect.InvocationHandler; import java.lang.reflect.Method; import java.lang.reflect.Proxy; public class DynamicProxyHandler implements InvocationHandler { private Object target; public DynamicProxyHandler(Object target) { this.target target; } Override public Object invoke(Object proxy, Method method, Object[] args) throws Throwable { // 前置处理 System.out.println(准备执行方法: method.getName()); // 调用真实对象的方法 Object result method.invoke(target, args); // 后置处理 System.out.println(方法执行完成: method.getName()); return result; } public static Object createProxy(Object target) { return Proxy.newProxyInstance( target.getClass().getClassLoader(), target.getClass().getInterfaces(), new DynamicProxyHandler(target) ); } } // 使用示例 FileAccess realFileAccess new RealFileAccess(); FileAccess proxy (FileAccess) DynamicProxyHandler.createProxy(realFileAccess); proxy.read(test.txt);JDK动态代理的优点是无需为每个类创建代理类但缺点是只能代理接口不能代理类。2.3 CGLIB动态代理实现对于没有实现接口的类可以使用CGLIB库实现动态代理。下面是一个CGLIB示例import net.sf.cglib.proxy.Enhancer; import net.sf.cglib.proxy.MethodInterceptor; import net.sf.cglib.proxy.MethodProxy; public class CglibProxy implements MethodInterceptor { private Object target; public CglibProxy(Object target) { this.target target; } public Object getProxyInstance() { Enhancer enhancer new Enhancer(); enhancer.setSuperclass(target.getClass()); enhancer.setCallback(this); return enhancer.create(); } Override public Object intercept(Object obj, Method method, Object[] args, MethodProxy proxy) throws Throwable { System.out.println(CGLIB代理前置处理); Object result method.invoke(target, args); System.out.println(CGLIB代理后置处理); return result; } } // 使用示例 RealFileAccess realFileAccess new RealFileAccess(); RealFileAccess proxy (RealFileAccess) new CglibProxy(realFileAccess).getProxyInstance(); proxy.read(test.txt);CGLIB通过继承目标类来实现代理因此不能代理final类或final方法。3. 代理模式在主流框架中的应用3.1 Spring AOP中的代理实现Spring框架广泛使用代理模式来实现AOP面向切面编程。根据目标对象是否实现接口Spring会自动选择JDK动态代理或CGLIB代理Configuration EnableAspectJAutoProxy(proxyTargetClass true) // 强制使用CGLIB public class AppConfig { // 配置类 } Service public class UserService { Transactional public void createUser(String username) { // 业务逻辑 } }Spring AOP的代理机制使得我们可以在不修改业务代码的情况下为方法添加事务管理、日志记录、性能监控等横切关注点。3.2 MyBatis中的Mapper接口代理MyBatis通过JDK动态代理为Mapper接口生成实现类public interface UserMapper { Select(SELECT * FROM users WHERE id #{id}) User getUserById(int id); } // 使用时代码 SqlSession session sqlSessionFactory.openSession(); try { UserMapper mapper session.getMapper(UserMapper.class); // 获取代理对象 User user mapper.getUserById(1); } finally { session.close(); }MyBatis在运行时动态生成Mapper接口的实现将接口方法调用转换为对应的SQL执行。3.3 RPC框架中的远程代理远程方法调用RPC框架如Dubbo、gRPC都使用了代理模式// 服务接口 public interface GreetingService { String sayHello(String name); } // 客户端调用 Reference private GreetingService greetingService; public void test() { String result greetingService.sayHello(World); // 实际是通过代理发起远程调用 System.out.println(result); }RPC框架在客户端生成服务接口的代理对象将本地方法调用转换为网络请求发送到服务端。4. 代理模式的性能考量与最佳实践4.1 代理模式的性能影响使用代理模式会带来一定的性能开销主要体现在方法调用转发开销每次方法调用都需要经过代理对象反射调用开销动态代理使用反射机制调用方法类加载开销动态代理需要生成新的类在实际项目中这些开销通常可以忽略不计但在高性能场景下需要考虑对于频繁调用的简单方法可以考虑直接调用缓存代理对象而不是每次都创建新实例在AOP配置中合理设置切点避免不必要的代理4.2 代理模式的最佳实践根据多年项目经验我总结了以下代理模式使用建议接口设计原则为需要代理的类定义清晰的接口便于代理实现职责单一原则代理类应该只负责访问控制不包含业务逻辑性能监控对代理方法进行性能监控及时发现性能问题日志记录在代理中添加适当的日志记录便于调试异常处理合理处理代理过程中的异常避免原始异常被吞没注意过度使用代理模式会导致系统复杂度增加应该只在确实需要控制访问或添加横切逻辑时使用。4.3 代理模式与其他模式的对比与装饰器模式对比代理模式控制访问通常一对一关系装饰器模式增强功能可以多层嵌套与适配器模式对比代理模式保持接口一致适配器模式转换接口与门面模式对比代理模式控制对单个对象的访问门面模式提供复杂子系统的简化接口5. 代理模式在实际项目中的典型问题与解决方案5.1 代理对象无法被正确序列化在使用分布式缓存或RPC框架时可能会遇到代理对象序列化问题// 错误示例 Autowired private UserService userService; // 可能是代理对象 public void saveToCache() { cache.put(userService, userService); // 序列化失败 }解决方案获取原始目标对象Spring中可以通过AopProxyUtils获取序列化原始对象而非代理对象或者设计不需要序列化代理对象的方案5.2 自调用方法代理失效在Spring管理的Bean中自调用方法不会经过代理Service public class OrderService { public void placeOrder() { this.validateOrder(); // 直接调用不会触发AOP代理 } Transactional public void validateOrder() { // 事务注解不会生效 } }解决方案将方法拆分到不同类中通过ApplicationContext获取代理对象再调用使用AspectJ编译时织入代替Spring AOP5.3 代理导致的equals和hashCode问题代理对象可能会破坏equals和hashCode的约定UserService proxy1 createProxy(userService); UserService proxy2 createProxy(userService); System.out.println(proxy1.equals(proxy2)); // 可能返回false解决方案在代理类中正确实现equals和hashCode方法比较时获取原始对象进行比较避免将代理对象用作Map的键或Set的元素5.4 CGLIB代理的final方法问题CGLIB无法代理final方法这可能导致意料之外的行为public class UserService { public final void updateUser(User user) { // 业务逻辑 } } // 使用Transactional注解final方法会失效解决方案避免在需要代理的类中使用final方法将final方法重构为非final方法使用接口JDK动态代理代替类继承6. 代理模式的现代应用与演进随着技术发展代理模式在现代系统中有了新的应用形式6.1 微服务中的API网关模式API网关本质上是代理模式在分布式系统中的体现// 简化的API网关路由配置示例 Bean public RouteLocator customRouteLocator(RouteLocatorBuilder builder) { return builder.routes() .route(user-service, r - r.path(/api/users/**) .uri(lb://user-service)) .route(order-service, r - r.path(/api/orders/**) .uri(lb://order-service)) .build(); }API网关作为所有微服务的统一入口提供了路由转发、负载均衡、权限控制等功能。6.2 Service Mesh中的Sidecar代理Service Mesh架构如Istio使用Sidecar代理如Envoy管理服务间通信# Istio VirtualService示例 apiVersion: networking.istio.io/v1alpha3 kind: VirtualService metadata: name: reviews spec: hosts: - reviews http: - route: - destination: host: reviews subset: v1 weight: 90 - destination: host: reviews subset: v2 weight: 10Sidecar代理实现了流量管理、熔断、监控等功能而业务代码无需感知这些细节。6.3 前端领域的Proxy应用现代前端框架也广泛使用代理模式// Vue3的响应式数据实现 const original { count: 0 }; const observed new Proxy(original, { get(target, key) { track(target, key); // 依赖收集 return target[key]; }, set(target, key, value) { trigger(target, key); // 触发更新 target[key] value; return true; } });前端框架通过代理实现数据绑定、计算属性等功能大大简化了开发复杂度。在实际项目中我经常使用代理模式来解决跨域问题。比如开发前端时配置webpack的devServer代理// webpack.config.js module.exports { devServer: { proxy: { /api: { target: http://localhost:8080, pathRewrite: { ^/api: } } } } }这种配置使得前端开发时可以绕过浏览器的同源策略限制同时保持与生产环境相似的API路径。
1. 代理模式的核心概念与应用场景代理模式Proxy Pattern是23种经典设计模式中结构型模式的代表之一。它通过创建一个代理对象来控制对原始对象的访问这种模式在实际开发中有着广泛的应用场景。我第一次接触代理模式是在处理一个需要权限控制的文件系统项目时当时需要根据不同用户的权限级别限制对某些敏感文件的访问。代理模式的核心在于控制访问它就像一个看门人决定谁可以进入、什么时候可以进入以及进入后能做什么。这种模式特别适用于以下场景远程代理Remote Proxy为位于不同地址空间的对象提供本地代表就像我们常用的远程服务调用RPC框架底层实现虚拟代理Virtual Proxy用于延迟加载大对象如图片懒加载、大数据分页查询保护代理Protection Proxy控制对原始对象的访问权限比如Spring Security的权限控制智能引用代理Smart Reference Proxy在访问对象时执行额外操作如引用计数、对象锁定检查等提示代理模式与装饰器模式在结构上很相似但目的不同。装饰器模式重在增强功能而代理模式重在控制访问。2. 代理模式的三种实现方式与代码示例2.1 静态代理实现静态代理是最基础的实现方式需要手动创建代理类。下面是一个Java实现的文件访问控制示例// 抽象主题接口 public interface FileAccess { void read(String fileName); void write(String fileName, String content); } // 真实主题类 public class RealFileAccess implements FileAccess { Override public void read(String fileName) { System.out.println(读取文件: fileName); } Override public void write(String fileName, String content) { System.out.println(写入文件: fileName , 内容: content); } } // 代理类 public class FileAccessProxy implements FileAccess { private RealFileAccess realFileAccess; private String userRole; public FileAccessProxy(String userRole) { this.userRole userRole; this.realFileAccess new RealFileAccess(); } Override public void read(String fileName) { if (checkAccess(fileName, read)) { realFileAccess.read(fileName); } else { System.out.println(无权限读取文件: fileName); } } Override public void write(String fileName, String content) { if (checkAccess(fileName, write)) { realFileAccess.write(fileName, content); } else { System.out.println(无权限写入文件: fileName); } } private boolean checkAccess(String fileName, String operation) { // 简单的权限检查逻辑 if (admin.equals(userRole)) return true; if (read.equals(operation)) return true; return false; } }静态代理的优点是简单直接但缺点是每个真实主题类都需要创建一个对应的代理类当系统规模变大时会非常繁琐。2.2 JDK动态代理实现Java提供了内置的动态代理机制可以运行时动态创建代理类。下面是一个使用JDK动态代理的示例import java.lang.reflect.InvocationHandler; import java.lang.reflect.Method; import java.lang.reflect.Proxy; public class DynamicProxyHandler implements InvocationHandler { private Object target; public DynamicProxyHandler(Object target) { this.target target; } Override public Object invoke(Object proxy, Method method, Object[] args) throws Throwable { // 前置处理 System.out.println(准备执行方法: method.getName()); // 调用真实对象的方法 Object result method.invoke(target, args); // 后置处理 System.out.println(方法执行完成: method.getName()); return result; } public static Object createProxy(Object target) { return Proxy.newProxyInstance( target.getClass().getClassLoader(), target.getClass().getInterfaces(), new DynamicProxyHandler(target) ); } } // 使用示例 FileAccess realFileAccess new RealFileAccess(); FileAccess proxy (FileAccess) DynamicProxyHandler.createProxy(realFileAccess); proxy.read(test.txt);JDK动态代理的优点是无需为每个类创建代理类但缺点是只能代理接口不能代理类。2.3 CGLIB动态代理实现对于没有实现接口的类可以使用CGLIB库实现动态代理。下面是一个CGLIB示例import net.sf.cglib.proxy.Enhancer; import net.sf.cglib.proxy.MethodInterceptor; import net.sf.cglib.proxy.MethodProxy; public class CglibProxy implements MethodInterceptor { private Object target; public CglibProxy(Object target) { this.target target; } public Object getProxyInstance() { Enhancer enhancer new Enhancer(); enhancer.setSuperclass(target.getClass()); enhancer.setCallback(this); return enhancer.create(); } Override public Object intercept(Object obj, Method method, Object[] args, MethodProxy proxy) throws Throwable { System.out.println(CGLIB代理前置处理); Object result method.invoke(target, args); System.out.println(CGLIB代理后置处理); return result; } } // 使用示例 RealFileAccess realFileAccess new RealFileAccess(); RealFileAccess proxy (RealFileAccess) new CglibProxy(realFileAccess).getProxyInstance(); proxy.read(test.txt);CGLIB通过继承目标类来实现代理因此不能代理final类或final方法。3. 代理模式在主流框架中的应用3.1 Spring AOP中的代理实现Spring框架广泛使用代理模式来实现AOP面向切面编程。根据目标对象是否实现接口Spring会自动选择JDK动态代理或CGLIB代理Configuration EnableAspectJAutoProxy(proxyTargetClass true) // 强制使用CGLIB public class AppConfig { // 配置类 } Service public class UserService { Transactional public void createUser(String username) { // 业务逻辑 } }Spring AOP的代理机制使得我们可以在不修改业务代码的情况下为方法添加事务管理、日志记录、性能监控等横切关注点。3.2 MyBatis中的Mapper接口代理MyBatis通过JDK动态代理为Mapper接口生成实现类public interface UserMapper { Select(SELECT * FROM users WHERE id #{id}) User getUserById(int id); } // 使用时代码 SqlSession session sqlSessionFactory.openSession(); try { UserMapper mapper session.getMapper(UserMapper.class); // 获取代理对象 User user mapper.getUserById(1); } finally { session.close(); }MyBatis在运行时动态生成Mapper接口的实现将接口方法调用转换为对应的SQL执行。3.3 RPC框架中的远程代理远程方法调用RPC框架如Dubbo、gRPC都使用了代理模式// 服务接口 public interface GreetingService { String sayHello(String name); } // 客户端调用 Reference private GreetingService greetingService; public void test() { String result greetingService.sayHello(World); // 实际是通过代理发起远程调用 System.out.println(result); }RPC框架在客户端生成服务接口的代理对象将本地方法调用转换为网络请求发送到服务端。4. 代理模式的性能考量与最佳实践4.1 代理模式的性能影响使用代理模式会带来一定的性能开销主要体现在方法调用转发开销每次方法调用都需要经过代理对象反射调用开销动态代理使用反射机制调用方法类加载开销动态代理需要生成新的类在实际项目中这些开销通常可以忽略不计但在高性能场景下需要考虑对于频繁调用的简单方法可以考虑直接调用缓存代理对象而不是每次都创建新实例在AOP配置中合理设置切点避免不必要的代理4.2 代理模式的最佳实践根据多年项目经验我总结了以下代理模式使用建议接口设计原则为需要代理的类定义清晰的接口便于代理实现职责单一原则代理类应该只负责访问控制不包含业务逻辑性能监控对代理方法进行性能监控及时发现性能问题日志记录在代理中添加适当的日志记录便于调试异常处理合理处理代理过程中的异常避免原始异常被吞没注意过度使用代理模式会导致系统复杂度增加应该只在确实需要控制访问或添加横切逻辑时使用。4.3 代理模式与其他模式的对比与装饰器模式对比代理模式控制访问通常一对一关系装饰器模式增强功能可以多层嵌套与适配器模式对比代理模式保持接口一致适配器模式转换接口与门面模式对比代理模式控制对单个对象的访问门面模式提供复杂子系统的简化接口5. 代理模式在实际项目中的典型问题与解决方案5.1 代理对象无法被正确序列化在使用分布式缓存或RPC框架时可能会遇到代理对象序列化问题// 错误示例 Autowired private UserService userService; // 可能是代理对象 public void saveToCache() { cache.put(userService, userService); // 序列化失败 }解决方案获取原始目标对象Spring中可以通过AopProxyUtils获取序列化原始对象而非代理对象或者设计不需要序列化代理对象的方案5.2 自调用方法代理失效在Spring管理的Bean中自调用方法不会经过代理Service public class OrderService { public void placeOrder() { this.validateOrder(); // 直接调用不会触发AOP代理 } Transactional public void validateOrder() { // 事务注解不会生效 } }解决方案将方法拆分到不同类中通过ApplicationContext获取代理对象再调用使用AspectJ编译时织入代替Spring AOP5.3 代理导致的equals和hashCode问题代理对象可能会破坏equals和hashCode的约定UserService proxy1 createProxy(userService); UserService proxy2 createProxy(userService); System.out.println(proxy1.equals(proxy2)); // 可能返回false解决方案在代理类中正确实现equals和hashCode方法比较时获取原始对象进行比较避免将代理对象用作Map的键或Set的元素5.4 CGLIB代理的final方法问题CGLIB无法代理final方法这可能导致意料之外的行为public class UserService { public final void updateUser(User user) { // 业务逻辑 } } // 使用Transactional注解final方法会失效解决方案避免在需要代理的类中使用final方法将final方法重构为非final方法使用接口JDK动态代理代替类继承6. 代理模式的现代应用与演进随着技术发展代理模式在现代系统中有了新的应用形式6.1 微服务中的API网关模式API网关本质上是代理模式在分布式系统中的体现// 简化的API网关路由配置示例 Bean public RouteLocator customRouteLocator(RouteLocatorBuilder builder) { return builder.routes() .route(user-service, r - r.path(/api/users/**) .uri(lb://user-service)) .route(order-service, r - r.path(/api/orders/**) .uri(lb://order-service)) .build(); }API网关作为所有微服务的统一入口提供了路由转发、负载均衡、权限控制等功能。6.2 Service Mesh中的Sidecar代理Service Mesh架构如Istio使用Sidecar代理如Envoy管理服务间通信# Istio VirtualService示例 apiVersion: networking.istio.io/v1alpha3 kind: VirtualService metadata: name: reviews spec: hosts: - reviews http: - route: - destination: host: reviews subset: v1 weight: 90 - destination: host: reviews subset: v2 weight: 10Sidecar代理实现了流量管理、熔断、监控等功能而业务代码无需感知这些细节。6.3 前端领域的Proxy应用现代前端框架也广泛使用代理模式// Vue3的响应式数据实现 const original { count: 0 }; const observed new Proxy(original, { get(target, key) { track(target, key); // 依赖收集 return target[key]; }, set(target, key, value) { trigger(target, key); // 触发更新 target[key] value; return true; } });前端框架通过代理实现数据绑定、计算属性等功能大大简化了开发复杂度。在实际项目中我经常使用代理模式来解决跨域问题。比如开发前端时配置webpack的devServer代理// webpack.config.js module.exports { devServer: { proxy: { /api: { target: http://localhost:8080, pathRewrite: { ^/api: } } } } }这种配置使得前端开发时可以绕过浏览器的同源策略限制同时保持与生产环境相似的API路径。
