goiocGo IOC 框架
goioc 是一个 Go IOC 框架
使用步骤
- go get github.com/gosrv/goioc
- 加载配置文件
loader := gioc.NewConfigLoader()
err := loader.Load("example/conf/config.json")
util.VerifyNoError(err)
- 创建IBeanContainerBuilder
builder := gioc.NewBeanContainerBuilder()
- 加入1个ITagParser和若干个ITagProcessor
builder.AddBean(loader)
builder.AddBean(gioc.NewBeanTagProcessor(builder.GetBeanContainer()))
builder.AddBean(gioc.NewConfigValueTagProcessor(loader))
builder.AddBean(gioc.NewTagParser())
builder.AddBean(gioc.NewBeanBeanConditionInjector())
- 加入专属bean
builder.AddBean(otherBeans...)
- 构建容器
builder.Build()
bean
放入容器中的对象就是一个bean,容器可以针对bean的成员变量做一些注入操作,比如其它bean实例的注入,或者配置数据的注入
IBeanContainerBuilder
用来构建bean容器,并完成注入,bean的注入操作由ITagProcessor完成
构建过程
- 收集满足条件的bean(通过IBeanCondition判断条件十分成立)
- 获取所有的ITagProcessor,并按优先级排序
- 按ITagProcessor的优先级先后处理所有满足条件的bean,这也是注入处理
IBeanCondition
通过内嵌接口IBeanCondition来实现条件判断,只有生效的bean才会被容器操作
- NewConditionAnd() 只有所有的条件都满足才能通过
- NewConditionOr() 有一个条件满足就能通过
- NewConditionOnValue() 当配置文件中存在配置项时才能通过
- NewConditionOnBeanType() 当存在某个类型的bean时才能通过
- NewConditionOnBeanName() 当存在某个名字的bean时才能通过
系统级tag
标注在bean上,可以执行一些特定意义的注入,目前支持两种系统级tag: bean和cfg
tag bean
- "bean" 通过类型注入,会注入其它同类型的bean,如果不是slice,要求容器内有且仅有一个次类型的bean,如果是slice,则可以有任意个
- "bean.name" 通过bean名字注入,必须存在并且只能有一个
- "bean.required" 如果没找到会不会报错,默认是true
type BeanC struct {
beanA IBeanA `bean:"" bean.name:"beana" bean.required:"true"`
}
tag cfg
- "cfg" 注入配置文件中的配置项
- "cfg.d" 注入特定域的配置项,与IConfigBase配合使用,调整配置注入的根节点
- "cfg.default" 如果配置文件中不存,则使用的默认配置
type BeanConfig struct {
Name string
Level int
Age int
}
type Bean struct {
// 注入配置文件的配置项"cfg.a"
ConfigA *BeanConfig `cfg:"cfg.a"`
// 注入配置文件的配置项"cfg.b"
ConfigB *BeanConfig `cfg:"cfg.b"`
}
ITagProcessor
可以通过实现接口ITagProcessor来自定义tag注入器,你还可以为它指定一个优先级,如果它没有任何依赖,则可以设置为系统级tag
ITagParser
解析tag标签,容器中只能存在一个,而且必须有一个,用来解析tag
exaple
请查看example1.go/example2.go/example3.go/example4.go
gcluster
https://github.com/gosrv/gcluster
ioc容器的应用:游戏服务器引擎框架(用来开发游戏引擎的引擎)
评论