[仅发布] 该项目仅为最终发布,开发请关注 go-spring 项目。
实现了一个功能完善的运行时 IoC 容器。
- SpringContext
- Condition
- Bean
- IsRefType
- IsValueType
- TypeName
- BeanSelector
- beanStatus
- BeanDefinition
- Bean
- Type
- Value
- TypeName
- Name
- BeanId
- FileLine
- WithName
- Or
- And
- ConditionOn
- ConditionNot
- ConditionOnProperty
- ConditionOnMissingProperty
- ConditionOnPropertyValue
- ConditionOnOptionalPropertyValue
- ConditionOnBean
- ConditionOnMissingBean
- ConditionOnExpression
- ConditionOnMatches
- ConditionOnProfile
- Options
- DependsOn
- Primary
- Init
- Destroy
- Export
- Bean 创建函数
SpringContext 定义了 IoC 容器接口。它的工作过程可以分为三个大的阶段:注册 Bean 列表、加载属性配置文件、自动绑定。其中自动绑定又分为两个小阶段:解析(决议)和绑定。
一条需要谨记的注册规则是: AutoWireBeans
调用后就不能再注册新的 Bean 了,这样做是因为实现起来更简单而且性能更高。
加载属性配置文件,支持 properties、yaml 和 toml 三种文件格式。
func LoadProperties(filename string)
读取属性配置文件,支持 properties、yaml 和 toml 三种文件格式。
func ReadProperties(reader io.Reader, configType string)
返回 keys 中第一个存在的属性值,属性名称统一转成小写。
func GetProperty(keys ...string) interface{}
返回 keys 中第一个存在的布尔型属性值,属性名称统一转成小写。
func GetBoolProperty(keys ...string) bool
返回 keys 中第一个存在的有符号整型属性值,属性名称统一转成小写。
func GetIntProperty(keys ...string) int64
返回 keys 中第一个存在的无符号整型属性值,属性名称统一转成小写。
func GetUintProperty(keys ...string) uint64
返回 keys 中第一个存在的浮点型属性值,属性名称统一转成小写。
func GetFloatProperty(keys ...string) float64
返回 keys 中第一个存在的字符串型属性值,属性名称统一转成小写。
func GetStringProperty(keys ...string) string
返回 keys 中第一个存在的 Duration 类型属性值,属性名称统一转成小写。
func GetDurationProperty(keys ...string) time.Duration
返回 keys 中第一个存在的 Time 类型的属性值,属性名称统一转成小写。
func GetTimeProperty(keys ...string) time.Time
返回属性值,如果没有找到则使用指定的默认值,属性名称统一转成小写。
func GetDefaultProperty(key string, def interface{}) (interface{}, bool)
设置属性值,属性名称统一转成小写。
func SetProperty(key string, value interface{})
返回指定前缀的属性值集合,属性名称统一转成小写。
func GetPrefixProperties(prefix string) map[string]interface{}
返回指定前缀的属性值集合并进行分组,属性名称统一转成小写。
func GetGroupedProperties(prefix string) map[string]map[string]interface{}
返回所有的属性值,属性名称统一转成小写。
func GetProperties() map[string]interface{}
根据类型获取属性值,属性名称统一转成小写。
func BindProperty(key string, i interface{})
根据类型获取属性值,属性名称统一转成小写。
func BindPropertyIf(key string, i interface{}, allAccess bool)
返回上下文接口。
func Context() context.Context
返回运行环境。
func GetProfile() string
设置运行环境。
func SetProfile(profile string)
注册单例 Bean,不指定名称,重复注册会 panic。
func RegisterBean(bean interface{}) *BeanDefinition
注册单例 Bean,需指定名称,重复注册会 panic。
func RegisterNameBean(name string, bean interface{}) *BeanDefinition
注册单例构造函数 Bean,不指定名称,重复注册会 panic。
func RegisterBeanFn(fn interface{}, tags ...string) *BeanDefinition
注册单例构造函数 Bean,需指定名称,重复注册会 panic。
func RegisterNameBeanFn(name string, fn interface{}, tags ...string) *BeanDefinition
注册成员方法单例 Bean,不指定名称,重复注册会 panic。必须给定方法名而不能通过遍历方法列表比较方法类型的方式获得函数名,因为不同方法的类型可能相同。而且 interface 的方法类型不带 receiver 而成员方法的类型带有 receiver,两者类型也不好匹配。
func RegisterMethodBean(selector BeanSelector, method string, tags ...string) *BeanDefinition
RegisterNameMethodBean 注册成员方法单例 Bean,需指定名称,重复注册会 panic。必须给定方法名而不能通过遍历方法列表比较方法类型的方式获得函数名,因为不同方法的类型可能相同。而且 interface 的方法类型不带 receiver 而成员方法的类型带有 receiver,两者类型也不好匹配。
func RegisterNameMethodBean(name string, selector BeanSelector, method string, tags ...string) *BeanDefinition
注册成员方法单例 Bean,不指定名称,重复注册会 panic。method 形如 ServerInterface.Consumer (接口) 或 (*Server).Consumer (类型)。
func RegisterMethodBeanFn(method interface{}, tags ...string) *BeanDefinition
注册成员方法单例 Bean,需指定名称,重复注册会 panic。method 形如 ServerInterface.Consumer (接口) 或 (*Server).Consumer (类型)。
func RegisterNameMethodBeanFn(name string, method interface{}, tags ...string) *BeanDefinition
注册 BeanDefinition 对象。
func RegisterBeanDefinition(bd *BeanDefinition)
对所有 Bean 进行依赖注入和属性绑定。
func AutoWireBeans()
对外部的 Bean 进行依赖注入和属性绑定。
func WireBean(i interface{})
获取单例 Bean,若多于 1 个则 panic;找到返回 true 否则返回 false。它和 FindBean 的区别是它在调用后能够保证返回的 Bean 已经完成了注入和绑定过程。
func GetBean(i interface{}, selector ...BeanSelector) bool
查询单例 Bean,若多于 1 个则 panic;找到返回 true 否则返回 false。它和 GetBean 的区别是它在调用后不能保证返回的 Bean 已经完成了注入和绑定过程。
func FindBean(selector BeanSelector) (*BeanDefinition, bool)
收集数组或指针定义的所有符合条件的 Bean,收集到返回 true,否则返回 false。该函数有两种模式:自动模式和指定模式。自动模式是指 selectors 参数为空,这时候不仅会收集符合条件的单例 Bean,还会收集符合条件的数组 Bean (是指数组的元素符合条件,然后把数组元素拆开一个个放到收集结果里面)。指定模式是指 selectors 参数不为空,这时候只会收集单例 Bean,而且要求这些单例 Bean 不仅需要满足收集条件,而且必须满足 selector 条件。另外,自动模式下不对收集结果进行排序,指定模式下根据selectors 列表的顺序对收集结果进行排序。
func CollectBeans(i interface{}, selectors ...BeanSelector) bool
获取所有 Bean 的定义,不能保证解析和注入,请谨慎使用该函数!
func GetBeanDefinitions() []*BeanDefinition
根据条件判断是否立即执行一个一次性的任务。
func Run(fn interface{}, tags ...string) *Runner
立即执行一个一次性的任务。
func RunNow(fn interface{}, tags ...string) error
注册一个配置函数。
func Config(fn interface{}, tags ...string) *Configer
注册一个配置函数,名称的作用是对 Config 进行排重和排顺序。
func ConfigWithName(name string, fn interface{}, tags ...string) *Configer
关闭容器上下文,用于通知 Bean 销毁等。该函数可以确保 Bean 的销毁顺序和注入顺序相反。
func Close(beforeDestroy ...func())
安全地启动一个 goroutine
func SafeGoroutine(fn GoFunc)
定义一个判断条件。
NewFunctionCondition
基于 Matches 方法的 Condition 实现。
NewNotCondition
对 Condition 取反的 Condition 实现。
NewPropertyCondition
基于属性值存在的 Condition 实现。
NewMissingPropertyCondition
基于属性值不存在的 Condition 实现。
NewPropertyValueCondition
基于属性值匹配的 Condition 实现。
NewBeanCondition
基于 Bean 存在的 Condition 实现。
NewMissingBeanCondition
基于 Bean 不能存在的 Condition 实现。
NewExpressionCondition
基于表达式的 Condition 实现。
NewProfileCondition
基于运行环境匹配的 Condition 实现。
NewConditions
基于条件组的 Condition 实现。
NewConditional
Condition 计算式。
Or
c=a||bAnd
c=a&&bOnCondition
设置一个 Condition。OnConditionNot
设置一个取反的 Condition。ConditionOnProperty
返回设置了 propertyCondition 的 Conditional 对象。ConditionOnMissingProperty
返回设置了 missingPropertyCondition 的 Conditional 对象。ConditionOnPropertyValue
返回设置了 propertyValueCondition 的 Conditional 对象。ConditionOnOptionalPropertyValue
返回属性值不存在时默认条件成立的 Conditional 对象。OnOptionalPropertyValue
设置一个 propertyValueCondition,当属性值不存在时默认条件成立。ConditionOnBean
返回设置了 beanCondition 的 Conditional 对象。ConditionOnMissingBean
返回设置了 missingBeanCondition 的 Conditional 对象。ConditionOnExpression
返回设置了 expressionCondition 的 Conditional 对象。ConditionOnMatches
返回设置了 functionCondition 的 Conditional 对象。ConditionOnProfile
返回设置了 profileCondition 的 Conditional 对象。
返回是否是引用类型。
func IsRefType(k reflect.Kind) bool
返回是否是值类型。
func IsValueType(k reflect.Kind) bool
返回原始类型的全限定名,Go 语言允许不同的路径下存在相同的包,因此有全限定名的需求,形如 "github.com/go-spring/spring-core/SpringCore.BeanDefinition"。
func TypeName(typOrPtr TypeOrPtr) string
Bean 选择器,可以是 BeanId 字符串,可以是 reflect.Type 对象或者形如 (*error)(nil) 的对象指针,还可以是 *BeanDefinition 对象。
type BeanSelector interface{}
Bean 的状态值。
beanStatus_Default = beanStatus(0) // 默认状态
beanStatus_Resolving = beanStatus(1) // 正在决议
beanStatus_Resolved = beanStatus(2) // 已决议
beanStatus_Wiring = beanStatus(3) // 正在注入
beanStatus_Wired = beanStatus(4) // 注入完成
beanStatus_Deleted = beanStatus(5) // 已删除
用于存储 Bean 的各种元数据。
返回 Bean 的源。
func (d *BeanDefinition) Bean() interface{}
返回 Bean 的类型。
func (d *BeanDefinition) Type() reflect.Type
返回 Bean 的值。
func (d *BeanDefinition) Value() reflect.Value
返回 Bean 的原始类型的全限定名。
func (d *BeanDefinition) TypeName() string
返回 Bean 的名称。
func (d *BeanDefinition) Name() string
返回 Bean 的唯一 ID。
func (d *BeanDefinition) BeanId() string
返回 Bean 的注册点。
func (d *BeanDefinition) FileLine() string
设置 Bean 的名称。
func (d *BeanDefinition) WithName(name string) *BeanDefinition
c=a||b。
func (d *BeanDefinition) Or() *BeanDefinition
c=a&&b。
func (d *BeanDefinition) And() *BeanDefinition
为 Bean 设置一个 Condition。
func (d *BeanDefinition) ConditionOn(cond Condition) *BeanDefinition
为 Bean 设置一个取反的 Condition。
func (d *BeanDefinition) ConditionNot(cond Condition) *BeanDefinition
为 Bean 设置一个 PropertyCondition。
func (d *BeanDefinition) ConditionOnProperty(name string) *BeanDefinition
为 Bean 设置一个 MissingPropertyCondition。
func (d *BeanDefinition) ConditionOnMissingProperty(name string) *BeanDefinition
为 Bean 设置一个 PropertyValueCondition。
func (d *BeanDefinition) ConditionOnPropertyValue(name string, havingValue interface{}, options ...PropertyValueConditionOption) *BeanDefinition
为 Bean 设置一个 PropertyValueCondition,当属性值不存在时默认条件成立。
func (d *BeanDefinition) ConditionOnOptionalPropertyValue(name string, havingValue interface{}) *BeanDefinition
为 Bean 设置一个 BeanCondition。
func (d *BeanDefinition) ConditionOnBean(selector BeanSelector) *BeanDefinition
为 Bean 设置一个 MissingBeanCondition。
func (d *BeanDefinition) ConditionOnMissingBean(selector BeanSelector) *BeanDefinition
为 Bean 设置一个 ExpressionCondition。
func (d *BeanDefinition) ConditionOnExpression(expression string) *BeanDefinition
为 Bean 设置一个 FunctionCondition。
func (d *BeanDefinition) ConditionOnMatches(fn ConditionFunc) *BeanDefinition
为 Bean 设置一个 ProfileCondition。
func (d *BeanDefinition) ConditionOnProfile(profile string) *BeanDefinition
设置 Option 模式函数的 Option 参数绑定。
func (d *BeanDefinition) Options(options ...*optionArg) *BeanDefinition
// NewOptionArg optionArg 的构造函数,tags 是 Option 函数的一般参数绑定
func NewOptionArg(fn interface{}, tags ...string) *optionArg {}
设置 Bean 的间接依赖项。
func (d *BeanDefinition) DependsOn(selectors ...BeanSelector) *BeanDefinition
设置 Bean 为主版本。
func (d *BeanDefinition) Primary(primary bool) *BeanDefinition
设置 Bean 的初始化函数,tags 是初始化函数的一般参数绑定。
func (d *BeanDefinition) Init(fn interface{}, tags ...string) *BeanDefinition
设置 Bean 的销毁函数,tags 是销毁函数的一般参数绑定。
func (d *BeanDefinition) Destroy(fn interface{}, tags ...string) *BeanDefinition
显式指定 Bean 的导出接口。
func (d *BeanDefinition) Export(exports ...TypeOrPtr) *BeanDefinition
将 Bean 转换为 BeanDefinition 对象
func ObjectBean(i interface{}) *BeanDefinition
将构造函数转换为 BeanDefinition 对象
func ConstructorBean(fn interface{}, tags ...string) *BeanDefinition
将成员方法转换为 BeanDefinition 对象
func MethodBean(selector BeanSelector, method string, tags ...string) *BeanDefinition