goioc  - Go IOC 框架
小码哥 2019-08-17 14:44:01

goioc 是一个 Go IOC 框架

使用步骤

  1. go get github.com/gosrv/goioc
  2. 加载配置文件
	loader := gioc.NewConfigLoader()
	err := loader.Load("example/conf/config.json")
	util.VerifyNoError(err)
  1. 创建IBeanContainerBuilder
    builder := gioc.NewBeanContainerBuilder()
  1. 加入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())
  1. 加入专属bean
    builder.AddBean(otherBeans...)
  1. 构建容器
    builder.Build()

bean

放入容器中的对象就是一个bean,容器可以针对bean的成员变量做一些注入操作,比如其它bean实例的注入,或者配置数据的注入

IBeanContainerBuilder

用来构建bean容器,并完成注入,bean的注入操作由ITagProcessor完成
构建过程

  1. 收集满足条件的bean(通过IBeanCondition判断条件十分成立)
  2. 获取所有的ITagProcessor,并按优先级排序
  3. 按ITagProcessor的优先级先后处理所有满足条件的bean,这也是注入处理

IBeanCondition

通过内嵌接口IBeanCondition来实现条件判断,只有生效的bean才会被容器操作

  1. NewConditionAnd() 只有所有的条件都满足才能通过
  2. NewConditionOr() 有一个条件满足就能通过
  3. NewConditionOnValue() 当配置文件中存在配置项时才能通过
  4. NewConditionOnBeanType() 当存在某个类型的bean时才能通过
  5. NewConditionOnBeanName() 当存在某个名字的bean时才能通过

系统级tag

标注在bean上,可以执行一些特定意义的注入,目前支持两种系统级tag: bean和cfg

tag bean

  1. "bean" 通过类型注入,会注入其它同类型的bean,如果不是slice,要求容器内有且仅有一个次类型的bean,如果是slice,则可以有任意个
  2. "bean.name" 通过bean名字注入,必须存在并且只能有一个
  3. "bean.required" 如果没找到会不会报错,默认是true
    type BeanC struct {
        beanA IBeanA	`bean:"" bean.name:"beana" bean.required:"true"`
    }

tag cfg

  1. "cfg" 注入配置文件中的配置项
  2. "cfg.d" 注入特定域的配置项,与IConfigBase配合使用,调整配置注入的根节点
  3. "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容器的应用:游戏服务器引擎框架(用来开发游戏引擎的引擎)