建造者模式适用于构建含多个可选字段的复杂对象，如HTTP服务器配置。通过链式调用设置主机、端口、超时、TLS、中间件等属性，避免伸缩构造函数问题。示例中ServerConfigBuilder提供默认值并支持逐步配置，Build方法校验参数并返回不可变对象。优势包括可读性强、灵活组合、默认值支持、构造验证和并发安全，提升代码维护性与清晰度。
在Go语言中，建造者模式（Builder Pattern）适用于构建复杂对象，尤其当对象的构造过程涉及多个可选字段、组合配置或需要分步初始化时。它能有效避免“ telescoping constructor ”（伸缩构造函数）问题，提升代码可读性和维护性。
场景设定：构建一个HTTP服务器配置
假设我们要创建一个 ServerConfig 对象，包含主机地址、端口、超时设置、TLS配置、中间件列表等。部分字段可选，且配置逻辑较复杂。使用建造者模式可以清晰地分步设置这些属性。
示例代码：
package main
import "time"
// ServerConfig 代表一个复杂的服务器配置对象
type ServerConfig struct {
Host string
Port int
ReadTimeout time.Duration
WriteTimeout time.Duration
EnableTLS bool
CertFile string
KeyFile string
Middleware []string
}
// ServerConfigBuilder 建造者结构体
type ServerConfigBuilder struct {
config *ServerConfig
}
// NewServerConfigBuilder 创建一个新的建造者
func NewServerConfigBuilder() *ServerConfigBuilder {
return &ServerConfigBuilder{
config: &ServerConfig{
Host: "localhost",
Port: 8080,
ReadTimeout: 5 * time.Second,
WriteTimeout: 5 * time.Second,
Middleware: make([]string, 0),
},
}
}
// SetHost 设置主机地址
func (b *ServerConfigBuilder) SetHost(host string) *ServerConfigBuilder {
b.config.Host = host
return b
}
// SetPort 设置端口
func (b *ServerConfigBuilder) SetPort(port int) *ServerConfigBuilder {
b.config.Port = port
return b
}
// SetTimeouts 设置读写超时
func (b *ServerConfigBuilder) SetTimeouts(read, write time.Duration) *ServerConfigBuilder {
b.config.ReadTimeout = read
b.config.WriteTimeout = write
return b
}
// EnableSecure 设置启用TLS并提供证书路径
func (b *ServerConfigBuilder) EnableSecure(cert, key string) *ServerConfigBuilder {
b.config.EnableTLS = true
b.config.CertFile = cert
b.config.KeyFile = key
return b
}
// AddMiddleware 添加中间件
func (b *ServerConfigBuilder) AddMiddleware(mw string) *ServerConfigBuilder {
b.config.Middleware = append(b.config.Middleware, mw)
return b
}
// Build 返回最终的配置对象（不可变）
func (b *ServerConfigBuilder) Build() *ServerConfig {
// 可在此处添加验证逻辑
if b.config.Port <= 0 || b.config.Port > 65535 {
panic("invalid port")
}
// 返回副本以保证不可变性（可选）
return b.config
}使用建造者创建复杂对象
通过链式调用逐步构建配置，代码清晰直观。
立即学习“go语言免费学习笔记（深入）”；
func main() {
config := NewServerConfigBuilder().
SetHost("0.0.0.0").
SetPort(8443).
SetTimeouts(10*time.Second, 10*time.Second).
EnableSecure("/certs/server.crt", "/certs/server.key").
AddMiddleware("logger").
AddMiddleware("auth").
AddMiddleware("rate-limiter").
Build()
// 使用 config 启动服务器...
println("Server running on", config.Host, ":", config.Port)
println("TLS Enabled:", config.EnableTLS)
println("Middleware count:", len(config.Middleware))
}建造者模式的优势
这种实现方式在Go中特别实用，原因如下：
- 可读性强：配置项命名明确，无需记住参数顺序
- 灵活性高：可自由组合可选参数，跳过不需要的设置
- 默认值支持：Builder内部可预设合理默认值
- 构造验证：Build阶段可集中校验参数合法性
- 线程安全准备：Build后返回不可变对象，便于并发使用
基本上就这些。建造者模式在Go中虽无抽象类或接口强制约束，但通过结构体和链式调用已足够应对大多数复杂对象构建需求。
