文章目录
我在两年前实现了一个Golang的依赖注入框架,并且集成了gin、xorm、redis、cron、消息中间件等功能,自己觉得还挺好用的;之前一直没有时间写文档推广,现在"毕业了",有时间来完善完善了。
github地址:https://github.com/gone-io/gone
如果有可能,请帮忙在github上点个 ⭐️??万分感谢!!
Goner的定义
在Gone应用中,所有的组件都被要求定义为Goner(就是"继承"了gone.Flag
的结构体,实际上golang中根本没有"集成"这个概念,它有的只有匿名嵌套);如果Goner的某个属性标注了gone:""
标签,Gone框架将尝试自动装配该属性。下面是定义一个Goner的例子:
go
package example
import "github.com/gone-io/gone"
type AGoner struct {
gone.Flag
}
在另一个Goner中注入上面定义的AGoner:
go
package example
import "github.com/gone-io/gone"
type BGoner struct{
gone.Flag
A *AGoner `gone:"*"` //gone标签的作用在于告诉Gone,该属性需要被自动注入一个值
}
其中,注入的和被注入的结构体都要求是Goner
(也就是匿名嵌套了gone.Flag
的结构体),BGoner
的A
属性的gone:"*"
标签的作用在于告诉框架:这个属性需要被注入一个值。
在Gone中是如何完成依赖注入的?
在Java Spring中,给class打上@Component
、@Service
等标注,Spring启动时会自动扫描到这些特殊的类,然后实例化他们并且给他们有特定标注的属性注入对应的值。
Spring之所以能够实现这样的功能,Java有一个特性很关键,就是Java代码在编译成jar后,会保留所有class的字节码,哪怕是没有被main
函数依赖的class代码;然而,在Golang中,编译后的代码会被裁剪,二进制文件中只会保留main
函数依赖的相关代码。所以我们仅是定义Goner,在编译后我们会发现我们Goner代码全部被裁剪了。
如何让我们的Goners 不被裁剪掉呢?答案很简单,我们显式的将所有Goner加入到一个"仓库"中;在Gone中,这个仓库叫做Cemetery
。Goner
有"死者"的意思;Cemetery
是墓地,用于埋葬(Bury)Goner
。我们可以在程序启动时,将所有的Goner 实例化后并加入到Cemetery中:
go
package main
import "example"
import "github.com/gone-io/gone"
func main() {
gone.Run(func(cemetery gone.Cemetery) error {
cemetery.Bury(&example.AGoner{})
cemetery.Bury(&example.BGoner{})
return nil
})
}
在上面的代码中,我们看到gone.Run
可以接收形式如 func (cemetery gone.Cemetery) error
的函数;实际上这个函数,我们称之为 Priest ,是牧师的意思,他专门负责将 Goner 埋葬到 墓地(Cemetery)。