当前位置: > > > > 在 Go 中向构造函数添加可变参数时如何进行版本控制?
来源:stackoverflow
2024-05-01 21:00:34
0浏览
收藏
本篇文章向大家介绍《在 Go 中向构造函数添加可变参数时如何进行版本控制?》,主要包括,具有一定的参考价值,需要的朋友可以参考一下。
问题内容
我相信向常规函数或方法添加可变参数函数正在破坏基于这篇文章的更改。但是向构造函数添加可变参数怎么样?例如添加功能选项。
通过使用 semver,此代码为 v1.0.0
type foo struct{} // constructor with default behavior func newfoo() *foo { return &foo{} }
添加可变参数
type Foo struct{} type Option func(&Foo) // constructor with option func NewFoo(opts ...Option) *Foo { // process option before return // ... return &Foo{} }
在调用构造函数时,旧代码仍然可以正常工作,并且没有人将构造函数分配给变量并将构造函数传递给另一个函数,就像本例一样。
那么,在上面的代码中,我应该将主要版本增加到 v2.0.0 还是将次要版本增加到 v1.1.0?
解决方案
在 go 中,我应该将主要版本增加到 v2.0.0 还是次要版本 到 v1.1.0?
在 go 中,newfoo
函数类型
v1.0.0
:
type foo struct{} func newfoo() *foo {}
和
v2.0.0
:
type foo struct{} type option func(*foo) func newfoo(opts ...option) *foo { }
是不同的类型。这使其成为一项重大更改,即对主要版本号的更新。
但是,这并不是真正的重大更改,只是扩展,因此请更新次要版本号。使用相似但不同的函数名称。例如,newfoo
和 newfooopts
。
v1.1.0
:
type Foo struct{} func NewFoo() *Foo { return NewFooOpts() } type Option func(*Foo) func NewFooOpts(opts ...Option) *Foo { var foo Foo for _, opt := range opts { // handle opt _ = opt } return &foo }
演示:
使用记录函数的注释为用户提供有关使用哪个函数的指导。例如,也许函数 newfoo
已被弃用,取而代之的是函数 newfooopts
。
没有人将构造函数分配给变量并传递 另一个函数的构造函数。
既然有人这样做了,那么这个说法就是错误的。
我认为两者都可以,因为这是一个灰色地带。原则上,您会破坏向后兼容性,因为函数的签名发生了变化,但实际上调用者不太可能受到影响。
这相当于将字段添加到结构中,该结构对新字段具有合理的默认零值解释。使用这些结构的代码可能会有不同的行为(例如,如果他们查看结构的大小,或者如果他们使用反射),但称其为破坏性更改是不务实的,除非您期望人们正在执行这些边缘情况事情。
到这里,我们也就讲完了《在 Go 中向构造函数添加可变参数时如何进行版本控制?》的内容了。个人认为,基础知识的学习和巩固,是为了更好的将其运用到项目中,欢迎关注公众号,带你了解更多关于的知识点!