当前位置：首页 > 文章列表 > Golang > Go教程 > Golang建造者模式复杂对象构建示例

Golang建造者模式复杂对象构建示例

2026-05-02 18:01:38 0浏览收藏

学习Golang要努力，但是不要急！今天的这篇文章《Golang建造者模式复杂对象构建示例》将会介绍到等等知识点，如果你想深入学习Golang，可以关注我！我会持续更新相关文章的，希望对大家都能有所帮助！

建造者模式适用于构建含多个可选字段的复杂对象，如HTTP服务器配置。通过链式调用设置主机、端口、超时、TLS、中间件等属性，避免伸缩构造函数问题。示例中ServerConfigBuilder提供默认值并支持逐步配置，Build方法校验参数并返回不可变对象。优势包括可读性强、灵活组合、默认值支持、构造验证和并发安全，提升代码维护性与清晰度。

Golang建造者模式复杂对象构建示例

在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
}

使用建造者创建复杂对象

通过链式调用逐步构建配置，代码清晰直观。

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))
}