在C++项目里，如果一个类包含很多字段，而且其中不少是可选配置，用构造函数传一堆参数不仅难读还容易把顺序搞错。对象构建器把创建逻辑挪到单独的builder类里，通过流式接口一步步设值，最后才生成真正需要的对象。
为什么需要对象构建器
假设有一个网络服务配置类，有IP、端口、超时时间、是否加密、线程数等字段。若用传统构造方式，调用方必须记住参数顺序；而构建器把每个设置变成有意义的函数名，链式写下来就像在读配置说明。
流式接口的基本写法
流式接口的核心是成员函数返回builder自身的引用（或指针），从而能连续点号调用。下面给出一个简化示例。
#include <string>
#include <iostream>
class ServerConfig {
public:
std::string ip;
int port;
int timeout;
};
class ServerConfigBuilder {
private:
ServerConfig config;
public:
ServerConfigBuilder& set_ip(const std::string& ip) {
config.ip = ip;
return *this;
}
ServerConfigBuilder& set_port(int port) {
config.port = port;
return *this;
}
ServerConfigBuilder& set_timeout(int timeout) {
config.timeout = timeout;
return *this;
}
ServerConfig build() {
return config;
}
};
int main() {
ServerConfig cfg = ServerConfigBuilder()
.set_ip("192.168.0.1")
.set_port(8080)
.set_timeout(30)
.build();
std::cout << cfg.ip << ":" << cfg.port << std::endl;
return 0;
}
分步构建复杂对象
当对象构建分多个阶段，比如先建连接、再设参数、最后校验，可把builder的方法按阶段分组，甚至用不同的子builder控制每一步的可见性。
使用阶段子构建器
下面示例展示分步构建：先通过连接阶段设地址，再进入配置阶段设参数，最后build。
#include <string>
class DbConnection {
public:
std::string host;
int pool_size;
};
class DbBuilder {
private:
DbConnection conn;
public:
// 第一步：连接阶段
DbBuilder& connect(const std::string& host) {
conn.host = host;
return *this;
}
// 第二步：参数阶段
DbBuilder& with_pool(int size) {
conn.pool_size = size;
return *this;
}
DbConnection build() {
return conn;
}
};
// 使用方式
// DbConnection db = DbBuilder().connect("127.0.0.1").with_pool(10).build();
注意事项
- builder最好与产品类分离，产品类构造函数可以设为私有并友元builder。
- 如果构建过程涉及资源申请，记得在build里做校验，失败抛异常或返回空对象。
- 对于多线程场景，builder本身不建议共享，每个线程用自己的实例更安全。
小结
用C++实现对象构建器并不复杂，关键就是让设置函数返回自身引用形成流式调用，并按业务阶段拆分设置步骤。这样既能保证复杂对象构建清晰，也方便后期扩展新的配置项。