3 Builder
自动关联目录:3 Builder
Builder 解决的是"复杂对象的构造过程很稳定,但每一步的表示很多变":把构建过程与表示分离,让同样的构建流程产出不同的结果。
原笔记里抓住了最关键的一点——它本质是模板方法在构造阶段的运用:绕开"构造函数里调虚函数不生效"的限制,用一个 Construct() 把构造流程固定下来。
结构
| 角色 | 职责 |
|---|---|
Builder | 声明各个部件的建造步骤 |
ConcreteBuilder | 实现步骤,并持有/产出最终产品 |
Director | 固定调用顺序(可变,常省略) |
Product | 被构造出来的复杂对象 |
原笔记里的写法:
class Abstract {
Abstract(){};
// 其实就是 模板方法,然后新建一个 初始化函数,以完成构造流程。
// 绕开构造函数无法调用虚函数的限制。
// 初始化函数足够复杂,可以拆出去作为新类,则,子类中不会继承这一块内容。
Construct(){
this->ConstructA();
this->ConstructB();
}
virtual void ConstructA() = 0;
virtual void ConstructB() = 0;
}为什么必须"绕开构造函数"
C++ 里构造函数中调用虚函数不会派发到子类(此时子类部分尚未构造,虚表还是基类的)。所以想让"构造流程"复用、让"每一步"可重写,只能把流程挪到一个普通成员函数里,在对象构造完成之后调用。
这条限制是 Builder 在 C++ 里最常见的落地形态,比 GoF 的 Director 版本实用得多。
何时用
| 场景 | 说明 |
|---|---|
| 构造参数多且有可选项 | telescoping constructor(构造函数重载爆炸) |
| 构造有顺序要求 | 必须先 A 后 B,靠调用方自觉不可靠 |
| 同一个流程产出不同表示 | 导出 Json / XML / 二进制 |
| 对象构造完还要"初始化" | 两段式构造(构造函数 + Init) |
C++ 里最常见的轻量版是流式 Builder:
auto cfg = ServerConfig::Builder()
.Host("127.0.0.1")
.Port(8080)
.TimeoutMs(3000)
.Build(); // Build() 里做校验与不变量检查与邻居的区别
| 关注点 | |
|---|---|
| Builder | 怎么一步步拼出一个复杂对象 |
| Factory Method | 用哪个类 |
| Abstract Factory | 这一套是不是配套 |
Builder 常和工厂组合:Builder 负责拼,工厂负责决定用哪个 Builder。
工程要点
| 要点 | 说明 |
|---|---|
Build() 里做校验 | 参数不完整直接失败,别造出半成品对象 |
| 区分必需与可选 | 必需参数进构造函数或 Build() 的必检查项 |
| 不可变产品 | 构造完成后对象只读,省掉一整类状态 bug |
| 别为每个字段生成 setter | 那只是把构造函数爆炸换成了 setter 爆炸 |
常见坑
| 坑 | 说明 |
|---|---|
| Builder 对象被复用 | 状态残留导致第二个产品串味,用一次就丢 |
忘记调 Build() | 得到未初始化对象,最好让类型系统强制(返回不同中间类型) |
| 建造步骤暴露了内部表示 | 又变回"依赖内部结构",客户端一样要改 |
| 简单对象也上 Builder | 三个字段以内直接构造函数,别过度设计 |
与引擎的对应
| 引擎机制 | 对应 |
|---|---|
FActorSpawnParameters、FComponentQueryParams | 可选参数集合的构造 |
FTableRowBase / 资产构造流程 | 构造与初始化分离 |
| 资源导入管线 | 同一份源数据,不同 Builder 产出不同平台资源 |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/8c35c344.html
更新于:2026年11月16日