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

29.9 外观模式:给复杂子系统开一扇正门

审校 2026-09-25 · 素材来源:itstack-demo-design 复盘、深度文49
📑 本篇章节导航 (共10节,点击直达)
问题:调用方被迫懂内部手写小例子:订单创建的正门框架里的上岗现场外观 vs 中介者 vs 代理:三个「中间人」设计判断:什么时候开门正门的位置:分层与防腐的中间形态外观与 SDK 设计:从三个入口到一个踩坑清单面试怎么问一句话总结

结构型第五讲:外观模式(给复杂子系统提供一个统一的高层入口,让调用方不必直面一堆内部类)。它是 23 种里最没有「技术含量」、却最能体现工程判断力的一种——知道什么时候该开正门,比会画 UML 重要。SLF4J 的 F 就是它(Facade)。

问题:调用方被迫懂内部

原始 JDBC 查询六步:注册驱动、拿连接、建语句、执行、遍历 ResultSet、逐一关资源(关还要按顺序 try-catch 嵌套 try-catch)。业务代码里每个查询都抄这六步——调用方被迫成为子系统专家,改一处内部约定(换连接池、改资源关闭策略)全线崩。

手写小例子:订单创建的正门

下单真实流程要协调五个内部服务:库存扣减、价格计算、优惠券核销、风控检查、消息通知。不加外观时,Controller 要按正确顺序调五个 Bean、自己处理每步失败补偿——编排逻辑散在每个调用点。加正门:


@Service
public class OrderFacade {                 // 正门:编排五步,只暴露一个意图
  private final InventoryService inventory;
  private final PricingService pricing;
  private final CouponService coupon;
  private final RiskService risk;
  private final NotifyService notify;

  public OrderResult placeOrder(OrderCmd cmd) {
    risk.check(cmd);                       // 编排顺序收拢在门内
    inventory.deduct(cmd.getSku(), cmd.getQty());
    Money total = pricing.calc(cmd).apply(coupon.redeem(cmd));
    Order order = orderRepo.save(cmd, total);
    notify.orderCreated(order);
    return OrderResult.of(order);
  }
}

Controller 只剩一行 facade.placeOrder(cmd)——正门收拢了三样东西:调用顺序、参数组装、异常语义。注意外观不禁止细粒度访问(特殊场景仍可直调内部服务),它只是提供默认的合理路径——「开门不拆窗」是外观与完全封装的分寸。

框架里的上岗现场

JdbcTemplate(教科书级):query/update/sql 一行入口,内部消化连接获取、语句创建、ResultSet 映射、资源关闭四件脏活——与手写 JDBC 六步对比就是外观模式的招贴画;JPA/MyBatis 在更高层再来一次。SLF4J:名字自带 F,Logger 门面统一入口,底层 Logback/Log4j2 任意换(外观+适配器+工厂三合一的杰作)。TransactionTemplate:事务的开启提交回滚收进一个 execute 回调入口(13.3 讲过它比 @Transactional 更显式的场景)。Spring 的 HibernateTemplate、RedisTemplate:Template 家族全是外观——Spring 的半壁江山叫 xxxTemplate,全是外观模式的马甲。计算机领域的远亲:操作系统系统调用对硬件、浏览器对网络协议栈——分层架构的层间接口广义都是正门。

外观 vs 中介者 vs 代理:三个「中间人」

外观:单向简化——外部调子系统,门内编排,子系统之间不认识(与中介者的分界:中介者是双向解耦,同事对象互相通过它转达,如机场塔台;外观里子系统互不通信)。外观 vs 代理:代理管一个对象的访问(同接口),外观管一群对象的入口(新接口)。三句话记牢:一个对象的门房是代理,一群对象的正门是外观,一群对象互相传话的调度台是中介者。

设计判断:什么时候开门

三个信号:调用方代码里子系统类名出现频次过高;同一套编排逻辑在多个调用点重复;子系统即将重构但调用方不该跟着震。反面也要敢说:只有一个调用方、或子系统本来就简单时,硬加外观是仪式主义——多一层转发多一层心智,模式不是越多越好(这句话在面试里说出口,比背十个模式加分)。

正门的位置:分层与防腐的中间形态

外观在架构里常以「层间 API」出现,位置感值得专门复盘。典型分层架构里,Controller 调 Service、Service 调若干内部组件与外部服务——Service 层本身就是整个系统的正门,Controller 不该知道下单要碰风控与库存;而 29.5 讲的防腐层是「对外部系统」的正门,方向相反。位置错放的典型病灶:Controller 直接编排五个内部服务(门开在了门外),或一个 Service 把所有用例都塞进同一扇门(上帝门)。判断口诀:一个用例一扇门、门内编排跨域协作、门名说业务不说技术——placeOrder 是好门名,OrderManager 是坏门名(说「管理」不说意图,最后什么都往里塞)。这个命名细节在 Code Review 里抓上帝类,一抓一个准。

外观与 SDK 设计:从三个入口到一个

给外部提供 SDK 时的实用推论:宁可三个窄门(初始化门、查询门、回调门),不要一个宽门。宽门的每个方法都是全部内部服务的排列组合,方法数随用例数线性膨胀;窄门按使用场景分档,每扇门内部共享编排组件——门数跟使用场景走,不跟内部服务数走。反例是把内部五个 Service 原样暴露成五个 SDK 接口:调用方被迫复刻你的编排顺序,SDK 的版本升级变成双方联调事故。26.3 的 MCP 平台「工具注册一次通用」是同一判断的倒影——平台是门,工具是子系统,门的存在让 AI 应用不必懂每个工具的调用细节。

踩坑清单

面试怎么问

一句话总结

外观模式是「调用方不该是子系统专家」这句抱怨的工程化回应:开一扇正门、收拢编排与异常、允许细粒度后门——Spring 用一整个 Template 家族证明,最朴素的模式也能扛起框架的半壁江山。