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 产出不同平台资源