5 Facade
自动关联目录:5 Facade
门面为子系统的一组接口提供一个一致(稳定)的高层入口,让外部更容易使用,同时把外部与子系统内部解耦。
原笔记的定性很重要:它解决的是架构层面的设计,而不只是一个类的设计——门面是系统边界,不是工具函数集合。
结构
| 角色 | 职责 |
|---|---|
Facade | 对外的高层接口,把一次外部调用编排成子系统内部的若干次调用 |
| 子系统类 | 各司其职,对外不暴露 |
门面不新增功能,它只做编排与翻译。判断标准:如果门面里出现了子系统里没有的业务规则,那这块逻辑放错位置了。
何时用
| 场景 | 说明 |
|---|---|
| 子系统很复杂 | 调用方要按正确顺序调 5 个对象才能完成一件事 |
| 要隔离变化 | 子系统重构/换实现,外部不该感知 |
| 分层架构的层间接口 | 上层只依赖门面,不依赖下层的任何具体类 |
| 封装第三方 SDK | 给自己一套干净接口,换 SDK 只改门面 |
| 需要"粗粒度"接口 | 网络边界上尤其重要,减少往返 |
与其他结构型的区别
| 目的 | 客户端是否知道内部 | |
|---|---|---|
| Facade | 简化、解耦 | 不需要知道 |
| Adapter | 接口转换,让不兼容的能用 | 知道,只是换了个接口 |
| Proxy | 控制访问 | 不知道,以为就在用真身 |
| 门面 + 适配器 | 常见组合:门面定接口,适配器把老系统接上来 | —— |
Facade 定义新接口(更简单),Adapter 实现已有接口(为了兼容)。
设计要点
| 要点 | 说明 |
|---|---|
| 门面要窄 | 只暴露外部真正需要的操作,多一个方法就多一份维护义务 |
| 允许多个门面 | 不同使用者可以有不同视角的门面,别做一个万能类 |
| 不要禁止直连子系统 | 高级用户需要逃生通道,强行封死反而逼他们绕过门面 |
| 门面不持有业务状态 | 它是编排层,状态在子系统里 |
| 与依赖方向一致 | 门面依赖子系统,子系统不依赖门面 |
常见坑
| 坑 | 说明 |
|---|---|
| 门面变成上帝类 | 什么功能都往里加,最后谁都不敢改 |
| 业务逻辑写在门面里 | 换一条调用路径(绕过门面)就丢失了规则,正确做法是下沉到子系统 |
| 门面返回值泄漏内部结构 | 返回子系统内部对象,等于没封装 |
| 一个门面服务所有场景 | 不同场景的需求互相污染,接口越来越臃肿 |
| 为了门面而门面 | 子系统就两个类,直接调就行 |
与引擎的对应
| 引擎机制 | 对应 |
|---|---|
UEngine / UGameInstance 子系统集合 | 对外的粗粒度入口 |
USubsystem(UGameInstanceSubsystem 等) | 模块对外的统一门面,隐藏内部实现 |
平台层 FPlatformMisc 等 | 屏蔽平台差异的高层接口 |
| 资源管理器对外接口 | 编排加载、缓存、引用计数等内部细节 |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/462eceee.html
更新于:2026年11月16日