如何使用Golang实现建造者模式生成复杂对象_分步配置属性

建造者模式在Golang中通过分离构造过程与表示实现灵活配置，适用于多可选属性、依赖校验的复杂结构体；定义不可导出目标结构体和链式调用的Builder结构体，提供带校验的WithXXX方法返回自身指针。

用 Golang 实现建造者模式，核心是把对象的构造过程与表示分离，让相同的构建流程能创建不同的配置结果。它特别适合需要分步设置多个可选属性、且部分属性有依赖或校验逻辑的复杂结构体。

定义目标结构体与建造者接口

先明确你要构建的对象类型，比如一个 HTTPClientConfig，包含超时、重试、证书路径、代理等字段。它本身应设为不可导出（小写首字母），避免外部直接初始化：

type httpClientConfig struct {
  timeout        time.Duration
  maxRetries    int
  caCertPath    string
  proxyURL      string
  disableKeepAlive bool
}

再定义建造者接口（可选）或直接使用结构体方法链。Go 更常用后者——用一个 builder 结构体封装字段和方法：

type HTTPClientBuilder struct {
  config *httpClientConfig
}

构造器函数返回新 builder 实例，并初始化默认值：

func NewHTTPClientBuilder() *HTTPClientBuilder {
  return &HTTPClientBuilder{
    config: &httpClientConfig{
      timeout:       30 * time.Second,
      maxRetries:    3,
      disableKeepAlive: false,
    },
  }
}

提供链式设置方法（每个返回 *builder）

每个配置方法接收参数、校验（如 timeout > 0）、更新内部 config 字段，并返回 b *HTTPClientBuilder，实现链式调用：

• func (b *HTTPClientBuilder) WithTimeout(d time.Duration) *HTTPClientBuilder {
    if d     panic("timeout must be greater than 0")
    }
    b.config.timeout = d
    return b
  }
• func (b *HTTPClientBuilder) WithRetry(max int) *HTTPClientBuilder {
    if max     panic("maxRetries cannot be negative")
    }
    b.config.maxRetries = max
    return b
  }
• func (b *HTTPClientBuilder) WithCACert(path string) *HTTPClientBuilder {
    if path != "" {
      b.config.caCertPath = path
    }
    return b
  }

添加校验与构建方法

Build 方法负责最终检查和返回不可变对象。建议在 Build 中做必要校验（例如：若启用了 TLS 但未提供证书路径，可报错）：

func (b *HTTPClientBuilder) Build() (*http.Client, error) {
  // 可选：校验逻辑
  if b.config.caCertPath != "" {
    if _, err := os.Stat(b.config.caCertPath); os.IsNotExist(err) {
      return nil, fmt.Errorf("CA cert file not found: %s", b.config.caCertPath)
    }
  }

  // 构建真实 http.Client（示例逻辑）
  transport := &http.Transport{
    TLSClientConfig: &tls.Config{
      RootCAs: x509.NewCertPool(), // 实际中需加载证书
    },
    IdleConnTimeout: b.config.timeout,
    MaxIdleConns:    100,
  }
  return &http.Client{
    Transport: transport,
    Timeout:   b.config.timeout,
  }, nil
}

使用示例：分步配置，清晰直观

调用方可以按需组合配置，跳过不关心的项，语义清晰：

client, err := NewHTTPClientBuilder().
  WithTimeout(15 * time.Second).
  WithRetry(5).
  WithCACert("./certs/ca.pem").
  Build()
if err != nil {
  log.Fatal(err)
}
// client 已就绪

也支持只设关键项：

client, _ := NewHTTPClientBuilder().WithTimeout(5 * time.Second).Build()

这种写法比传一大串参数或手动 new + 赋值更安全、易读、易维护。