今天我们介绍一个在 Go 语言中非常流行的编程模式:函数式选项模式(Functional Options)。该模式解决的问题是,如何更动态灵活地为对象配置参数。可能读者不太明白该痛点,不急,我们将在下文详细详解。
假设我们在代码中定义了一个用户的结构体对象 User,它拥有以下属性。
复制
type User struct { ID string // 必需项 Name string // 必需项 Age int // 非必需项 Gender bool // 非必需项}
1.
2.
3.
4.
5.
6.
初始化该对象时,最简单的方式是直接填充属性值,例如
复制
u := &User{ID: "12glkui234d", Name: "菜刀", Age: 18, Gender: true}
1.
但是这里存在一个问题:User 对象中的属性并不一定都是可导出的,例如 User 有一个属性字段为 password(首字母小写,非导出),如果在其他模块中需要构造 User 对象,这样就不能填充该 password 字段了。
所以我们需要定义构造 User 对象的函数,首先能想到最简单的构造函数方式如下。
复制
func NewUser(id, name string, age int, gender bool) *User { return &User{ ID: id, Name: name, Age: age, Gender: gender, }}
1.
2.
3.
4.
5.
6.
7.
8.
但是这样也存在一些问题:对于 User 对象而言,只有 ID、Name 属性是必须的,Age 与 Gender 为非必需项,且并不能设置默认值,例如 Age 的默认值为 0,Gender 的默认值是 false ,这显然不太合理。
面对该问题,我们可以采用的解决方案有哪些呢?
我们能想到最粗暴地解决方法是:为每种参数情况设置一种构造函数。如下代码所示
复制
func NewUser(id, name string) *User { return &User{ID: id, Name: name}}func NewUserWithAge(id, name string, age int) *User { return &User{ID: id, Name: name, Age: age}}func NewUserWithGender(id, name string, gender bool) *User { return &User{ID: id, Name: name, Gender: gender}}func NewUserWithAgeGender(id, name string, age int, gender bool) *User { return &User{ID: id, Name: name, Age: age, Gender: gender}}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
15.
这种方式适合参数较少且不易发生变化的情况。该方式在 Go 标准库中也有使用,例如 net 包中的 Dial 和 DialTimeout 方法。
复制
func Dial(network, address string) (Conn, error) {}func DialTimeout(network, address string, timeout time.Duration) (Conn, error) {}
1.
2.
但该方式的缺陷也很明显:试想,如果构造对象 User 增加了参数字段 Phone,那么我们需要新增多少个组合函数?
另外一种常见的方式是配置化,我们将所有可选的参数放入一个 Config 的配置结构体中。
复制
type User struct { ID string Name string Cfg *Config}type Config struct { Age int Gender bool}func NewUser(id, name string, cfg *Config) *User { return &User{ID: id, Name: name, Cfg: cfg}}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
12.
13.
14.
这样,我们只需要一个 NewUser() 函数,不管之后增加多少配置选项,NewUser 函数都不会得到破坏。
但是,这种方式,我们需要先构造 Config 对象,这时候对 Config 的构造又回到了方案一中存在的问题。
面对这样的问题,我们还可以选择函数式选项模式。
首先,我们定义一个 Option 函数类型
复制
type Option func(*User)
1.
然后,为每个属性值定义一个返回 Option 函数的函数
复制
func WithAge(age int) Option { return func(u *User) { u.Age = age }}func WithGender(gender bool) Option { return func(u *User) { u.Gender = gender }}
1.
2.
3.
4.
5.
6.
7.
8.
9.
10.
11.
此时,我们将 User 对象的构造函数改为如下所示
复制
func NewUser(id, name string, options ...Option) *User { u := &User{ID: id, Name: name} for _, option := range options { option(u) } return u}
1.
2.
3.
4.
5.
6.
7.
按照这种构造方式,我们就可以这样配置 User 对象了
复制
u := NewUser("12glkui234d", "菜刀", WithAge(18), WithGender(true))
1.
以后不管 User 增加任何参数 XXX,我们只需要增加对应的 WithXXX 函数即可,是不是非常地优雅?
Functional Options 这种编程模式,我们经常能在各种项目中找到它的身影。例如,我在 tidb 项目中仅使用 opts ... 关键字搜索,就能看到这么多使用了 Functional Options 的代码(截图还未包括全部)。
函数式选项模式解决了如何动态灵活地为对象配置参数的问题, 但是需要在合适的场景才使用它。
当对象的配置参数复杂,例如可选参数多、非导入字段、参数可能随版本增加等情况,这时函数式选项模式就可以很好地帮助到我们。