5 Facade

自动关联目录:5 Facade

门面为子系统的一组接口提供一个一致(稳定)的高层入口,让外部更容易使用,同时把外部与子系统内部解耦。

原笔记的定性很重要:它解决的是架构层面的设计,而不只是一个类的设计——门面是系统边界,不是工具函数集合。

结构

角色职责
Facade对外的高层接口,把一次外部调用编排成子系统内部的若干次调用
子系统类各司其职,对外不暴露

门面不新增功能,它只做编排与翻译。判断标准:如果门面里出现了子系统里没有的业务规则,那这块逻辑放错位置了。

何时用

场景说明
子系统很复杂调用方要按正确顺序调 5 个对象才能完成一件事
要隔离变化子系统重构/换实现,外部不该感知
分层架构的层间接口上层只依赖门面,不依赖下层的任何具体类
封装第三方 SDK给自己一套干净接口,换 SDK 只改门面
需要"粗粒度"接口网络边界上尤其重要,减少往返

与其他结构型的区别

目的客户端是否知道内部
Facade简化、解耦不需要知道
Adapter接口转换,让不兼容的能用知道,只是换了个接口
Proxy控制访问不知道,以为就在用真身
门面 + 适配器常见组合:门面定接口,适配器把老系统接上来——

Facade 定义新接口(更简单),Adapter 实现已有接口(为了兼容)。

设计要点

要点说明
门面要窄只暴露外部真正需要的操作,多一个方法就多一份维护义务
允许多个门面不同使用者可以有不同视角的门面,别做一个万能类
不要禁止直连子系统高级用户需要逃生通道,强行封死反而逼他们绕过门面
门面不持有业务状态它是编排层,状态在子系统里
与依赖方向一致门面依赖子系统,子系统不依赖门面

常见坑

坑说明
门面变成上帝类什么功能都往里加,最后谁都不敢改
业务逻辑写在门面里换一条调用路径(绕过门面)就丢失了规则,正确做法是下沉到子系统
门面返回值泄漏内部结构返回子系统内部对象,等于没封装
一个门面服务所有场景不同场景的需求互相污染,接口越来越臃肿
为了门面而门面子系统就两个类,直接调就行

与引擎的对应

引擎机制对应
UEngine / UGameInstance 子系统集合对外的粗粒度入口
USubsystem(UGameInstanceSubsystem 等)模块对外的统一门面,隐藏内部实现
平台层 FPlatformMisc 等屏蔽平台差异的高层接口
资源管理器对外接口编排加载、缓存、引用计数等内部细节