1. 引言为什么需要适配器你是否曾为这样的困境而烦恼新系统需要调用老系统的功能却发现接口格格不入想要集成一个强大的第三方库却发现它的 API 与你的设计理念背道而驰。直接修改老系统成本高昂且风险巨大。重写第三方库几乎不可能。这时一个优雅的解决方案应运而生——适配器模式Adapter Pattern。想象一下你带着心爱的中国电器踏上欧洲之旅却发现墙上的插座是两脚圆孔而你的插头却是两脚扁头。是改造电器还是砸掉墙壁不你只需要一个轻巧的电源转换器。适配器模式正是软件世界中的“万能转换器”它让新旧系统无缝对接让不兼容的接口握手言和让代码的“世界语”成为可能。它不仅是解决兼容性问题的利器更是架构师手中的“粘合剂”在系统演进、技术债务治理和第三方集成中扮演着不可或缺的角色。让我们一同揭开适配器模式的神秘面纱探索其如何化“冲突”为“协作”变“不可能”为“可能”。2. 适配器模式的核心概念2.1 官方定义适配器模式是一种结构型设计模式它允许接口不兼容的类能够一起工作。适配器充当两个不兼容接口之间的桥梁将一个类的接口转换成客户期望的另一个接口。2.2 三种角色目标接口Target客户端期望使用的接口适配者Adaptee需要被适配的现有接口适配器Adapter将适配者接口转换成目标接口的类2.3 两种实现方式类适配器通过继承实现多重继承对象适配器通过组合实现更常用更灵活3. 适配器模式的 UML 类图组合依赖«interface»Targetrequest() : voidAdapteespecificRequest() : voidAdapter-adaptee: Adapteerequest() : voidClientdoWork(target: Target) : void图例说明Client只认识Target接口Adapter实现Target接口内部持有Adaptee实例当Client调用target.request()时Adapter将其转换为adaptee.specificRequest()4. 实战案例日志系统升级假设我们有一个老旧的日志系统现在需要接入新的日志框架。4.1 现有系统需要被适配// 老旧的日志系统 - AdapteepublicclassLegacyLogger{publicvoidlogMessage(Stringmessage,intlevel){System.out.println([level] message);}publicvoidlogError(Stringerror){System.out.println(ERROR: error);}}4.2 目标接口期望的接口// 新的日志接口 - TargetpublicinterfaceModernLogger{voiddebug(Stringmessage);voidinfo(Stringmessage);voidwarn(Stringmessage);voiderror(Stringmessage);}4.3 对象适配器实现// 适配器类 - AdapterpublicclassLoggerAdapterimplementsModernLogger{privateLegacyLoggerlegacyLogger;publicLoggerAdapter(LegacyLoggerlegacyLogger){this.legacyLoggerlegacyLogger;}Overridepublicvoiddebug(Stringmessage){// 将debug级别映射到老系统的level1legacyLogger.logMessage(message,1);}Overridepublicvoidinfo(Stringmessage){// 将info级别映射到老系统的level2legacyLogger.logMessage(message,2);}Overridepublicvoidwarn(Stringmessage){// 将warn级别映射到老系统的level3legacyLogger.logMessage(message,3);}Overridepublicvoiderror(Stringmessage){// 直接使用老系统的专用方法legacyLogger.logError(message);}}4.4 客户端使用// 客户端代码publicclassClient{publicstaticvoidmain(String[]args){// 创建老系统实例LegacyLoggeroldLoggernewLegacyLogger();// 创建适配器ModernLoggerloggernewLoggerAdapter(oldLogger);// 使用新接口调用老系统功能logger.debug(调试信息);logger.info(普通信息);logger.warn(警告信息);logger.error(错误信息);// 输出// [1] 调试信息// [2] 普通信息// [3] 警告信息// ERROR: 错误信息}}5. 类适配器 vs 对象适配器5.1 类适配器使用继承// 类适配器 - 通过继承实现publicclassClassLoggerAdapterextendsLegacyLoggerimplementsModernLogger{Overridepublicvoiddebug(Stringmessage){super.logMessage(message,1);}Overridepublicvoidinfo(Stringmessage){super.logMessage(message,2);}// ... 其他方法类似}优点代码更简洁直接调用父类方法可以重写适配者的行为缺点需要多重继承Java 不支持但可通过接口继承模拟耦合度高适配器与适配者绑定5.2 对象适配器使用组合如前面示例所示使用组合方式。优点更灵活可以适配多个不同的适配者符合组合优于继承原则可以在运行时动态切换适配者缺点代码稍多需要维护适配者引用推荐使用对象适配器除非有特殊需求。6. 适配器模式在现实中的应用6.1 JDBC 中的适配器JDBCJava Database Connectivity本身就是适配器模式的典型应用DriverManager作为适配器各种数据库驱动MySQL Driver、Oracle Driver作为适配者统一的Connection、Statement、ResultSet接口作为目标接口6.2 Spring 中的适配器Spring MVC 中的HandlerAdapter// Spring 简化示例publicinterfaceHandlerAdapter{booleansupports(Objecthandler);ModelAndViewhandle(HttpServletRequestrequest,HttpServletResponseresponse,Objecthandler)throwsException;}// 适配不同的处理器类型publicclassSimpleControllerHandlerAdapterimplementsHandlerAdapter{publicbooleansupports(Objecthandler){return(handlerinstanceofController);}publicModelAndViewhandle(HttpServletRequestrequest,HttpServletResponseresponse,Objecthandler)throwsException{return((Controller)handler).handleRequest(request,response);}}6.3 Java I/O 中的适配器InputStreamReader和OutputStreamWriter将字节流适配为字符流InputStreamReader适配InputStream到ReaderOutputStreamWriter适配OutputStream到Writer7. 适配器模式的优缺点7.1 优点单一职责原则将接口转换代码从业务逻辑中分离开闭原则可以在不修改现有代码的情况下引入新的适配器复用性让不兼容的类能够一起工作灵活性可以动态切换不同的适配器实现7.2 缺点增加复杂度引入额外的类和接口过度使用如果接口本身设计不合理应该考虑重构而非适配性能开销额外的间接调用可能带来轻微性能损失8. 适配器模式 vs 其他模式8.1 适配器 vs 装饰器适配器改变接口让不兼容的接口能够协作装饰器不改变接口增强原有功能8.2 适配器 vs 外观适配器解决两个已有接口不兼容的问题外观为复杂子系统提供简化接口8.3 适配器 vs 桥接适配器事后补救让已有的类能够一起工作桥接事前设计将抽象与实现分离以便独立变化9. 最佳实践与注意事项9.1 何时使用适配器模式✅适合场景需要使用现有的类但其接口与需求不匹配想要创建一个可复用的类与不兼容接口的类协作需要适配多个不同接口的类似功能❌不适合场景接口本身设计有问题应该重构而非适配系统还很新有重构的余地性能要求极高的场景额外的间接调用可能成为瓶颈9.2 实现建议优先使用对象适配器更灵活符合组合优于继承原则保持适配器简单只做接口转换不要添加业务逻辑考虑双向适配器如果需要双向转换可以实现两个接口使用依赖注入通过依赖注入配置适配器提高可测试性10. 总结适配器模式这位软件架构中的“和平使者”与“翻译官”以其精巧的设计哲学优雅地弥合了接口间的鸿沟。它不仅是连接新旧系统的桥梁更是拥抱变化、促进复用的智慧结晶。核心价值再审视化冲突为协作其核心使命是接口转换将不兼容变为兼容让孤立的功能模块能够协同奏响和谐的乐章。灵活优于固化对象适配器组合凭借其运行时灵活性在绝大多数场景下都优于类适配器继承完美诠释了“组合优于继承”的设计原则。专注成就纯粹一个优秀的适配器应只负责接口转换如同一位专业的翻译忠实传递信息而不增添个人色彩确保职责单一。策略决定时机在系统设计初期我们应追求接口的和谐统一尽量避免使用适配器但在集成遗留系统、复用成熟组件时它又是我们手中不可或缺的“战略储备”。掌握适配器模式意味着你掌握了在系统集成中“求同存异”的智慧在代码复用中“穿针引线”的技巧在技术债务处理中“平滑过渡”的艺术。它让你在复杂的软件生态中游刃有余真正实现“新旧兼容平滑过渡”的架构愿景。下一步学习计划装饰器模式学习如何在不改变接口的前提下动态地为对象添加新功能实现“锦上添花”。外观模式探索如何为复杂的子系统提供一个统一的简化接口扮演“系统门面”的角色。付诸实践在你的项目中主动寻找那些存在接口冲突的“痛点”尝试用适配器模式进行重构体验其带来的简洁与优雅。