软件简介

goioc 是一个 Go IOC 框架

使用步骤

1. go get github.com/gosrv/goioc

2. 加载配置文件

   loader := gioc.NewConfigLoader()
   err := loader.Load("example/conf/config.json")
   util.VerifyNoError(err)
   

3. 创建IBeanContainerBuilder

   builder := gioc.NewBeanContainerBuilder()
   

4. 加入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())
   

5. 加入专属bean

   builder.AddBean(otherBeans...)
   

6. 构建容器

   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容器的应用：游戏服务器引擎框架（用来开发游戏引擎的引擎）