← 课程目录 🚀 从零到一
📐 学习维度 阶段7 · 第29章 设计模式 23 讲 🚀 从零到一 📚 课程目录 🏠 首页 🛤️ 学习路径

29.5 适配器模式:接口不合缝时的转接头

审校 2026-09-25 · 素材来源:itstack-demo-design 复盘、深度文49
📑 本篇章节导航 (共8节,点击直达)
手写小例子:第三方 SDK 接入框架里的上岗现场(重头戏)适配器 vs 代理 vs 装饰器:三家易混防腐层:适配器在架构层的放大缺省适配器:为「不想实现全部方法」松绑踩坑清单面试怎么问一句话总结

创建型五讲完,进入结构型七讲。第一位是生活里最好懂的:适配器模式(把一个类的接口转换成调用方期待的另一个接口,让本来不兼容的类协同工作)——就是插头转接头。它的判断信号也最清晰:接口定了、实现现成、就是签名对不上,中间加一层转换,谁都不用改。

手写小例子:第三方 SDK 接入

业务里定义了自己的消息发送接口,新接的第三方推送 SDK 方法签名完全不同:


interface MessageSender {                    // 我方接口(调用方依赖它)
  void send(String to, String content);
}
class VendorSdk {                            // 第三方(改不了)
  void pushMessage(String appId, String target,
                   String body, int priority) {
  }
}
class VendorAdapter implements MessageSender {
  private final VendorSdk sdk;
  VendorAdapter(VendorSdk sdk) { this.sdk = sdk; }
  @Override public void send(String to, String content) {
    sdk.pushMessage("app-001", to, content, 1);  // 转换:补默认值/改签名
  }
}

对象适配器(组合+委托)是主流写法;另有类适配器(继承被适配者+实现目标接口),Java 单继承限制下少用。适配器里只做转换不做业务——补参数、改格式、调方法名,混进业务逻辑就变味了。判断「该适配还是该改接口」:第三方代码改不了、或接口已被几十处依赖不敢动——适配;自家接口刚定还没人用——直接改接口,别硬适配。

框架里的上岗现场(重头戏)

Spring MVC 的 HandlerAdapter(最经典的框架适配器):DispatcherServlet 面对三种控制器——实现 Controller 接口的、注解 @RequestMapping 的老新两代 POJO、HttpRequestHandler——调用方式各异,总不能在 DispatcherServlet 里写 if-else 分支适配每种。解法:HandlerAdapter 接口(supports 判断能否处理+handle 统一调用入口),RequestMappingHandlerAdapter 内部把注解方法的参数解析、反射调用、返回值处理全包了——15.1 的十五件套里它是最厚的一件。新增控制器类型=新增一个 Adapter,DispatcherServlet 零修改——这是适配器模式「对扩展开放」的最高展示。Spring AOP 的 AdvisorAdapter:Before/AfterReturning/ThrowsCut 三种通知统一转成 MethodInterceptor 链(13.3 的拦截链每环都是同一个接口)。MyBatis 的日志适配:MyBatis 定义自己的 Log 接口,给 SLF4J/Log4j2/JDK logging/Commons 各写一个适配器,按 classpath 有哪个就配哪个——日志门面适配的全套示范。Spring Security 的 AuthenticationProvider 适配(18.2):DaoAuthenticationProvider、JwtProvider 把不同认证源适配成统一的 authenticate 流程。JDK 原生:InputStreamReader(字节流转字符流的桥梁适配)、Arrays.asList()(数组适配成 List)、老 collections 的 Enumeration→Iterator。

适配器 vs 代理 vs 装饰器:三家易混

结构型三兄弟都「包一层」,分界线在意图:适配器改接口(签名不匹配,转换后对接);代理不改接口(同一个接口,控制访问——加权限、懒加载、远程转发,29.11 详讲);装饰器也不改接口(同一个接口,加行为——IO 流的缓冲增强,29.8 详讲)。一句话记忆:接口变了是适配器,接口没变但换了个心的是代理,接口没变还顺着加菜的是装饰器。

防腐层:适配器在架构层的放大

适配器从类级别放大到系统级别,就是微服务架构里的防腐层(ACL,Anti-Corruption Layer):自家系统与外部系统(第三方风控、遗留老系统、合作方接口)之间加一层转换边界,外部模型的字段、语义、错误码在这层翻译成本域语言,外部变更被挡在防腐层内消化。价值账要算清楚:不加防腐层,外部接口改一个字段名,你的代码里几十处引用跟着改;加了,只改防腐层一处。它与 26.3 的 MCP 平台是同一思想的两级形态——工具网关把「各家 AI 应用的调用形态」适配到统一协议,防腐层把「各家外部系统的领域模型」适配到本域——凡是「别人的东西要进我的系统」,第一反应就该是「先过一道转换层」。手写消息 SDK 适配器练的就是这层架构手感的最小单元。

缺省适配器:为「不想实现全部方法」松绑

变体「缺省适配器」(抽象类给接口全部方法提供空实现,子类挑着覆写)解决的是「接口方法太多,实现类用不着却被强制空实现」的噪音:MouseListener 五个方法,你只关心 click,MouseAdapter(抽象空实现)让你只写一个方法——WindowAdapter、FocusAdapter 全家同款。JDK 8 接口默认方法(default)把这个变体的地盘抢了大半(接口方法直接带默认空实现),但抽象类版本仍有一席之地:默认方法没有状态,抽象适配器可以带字段(缓存 listener 列表、记录注册状态)。面试问「接口默认方法出来后抽象类还有用吗」,缺省适配器带状态这个点是好答案的素材。适配器数量本身也要治理:一个系统里同一目标的适配器超过五六个,通常是领域模型没收敛(每接一家就长一个翻译层)——该做的是提炼统一的中介模型,让适配器只做「格式级」翻译而非「语义级」重写。

踩坑清单

面试怎么问

一句话总结

适配器模式是「谁都不改」的艺术:接口是调用方的、实现是别人的、转换层是自己的——HandlerAdapter 用一个接口让三代控制器共存,这个案例讲透,适配器就从 UML 图变成了Spring 源码里摸得着的一层。