binding

Documentation

Overview

Package binding 提供了数据绑定和依赖注入的底层支持。

设计原则

• 构造器注入优先：通过工厂函数参数显式声明依赖，编译期类型安全
• 字段注入补充：通过 inject 标签绑定，适用于简化代码
• 配置绑定：通过 value 标签绑定配置值，支持类型转换

注入方式

构造器注入（推荐）：

core.Register(container, "userService", func(c core.Container) *UserService {
    db := core.MustGet[*Database](c, "db")  // 显式声明依赖
    return &UserService{DB: db}
})

字段注入：

type MyBean struct {
    DB *Database `inject:"db"`
}

binder := binding.NewBinder()
binder.BindFields(&myBean, container)

配置绑定：

type Config struct {
    Timeout int    `value:"app.timeout"`
    Name    string `value:"app.name"`
}

binder.BindValue(&config, resolver)

泛型注入 API

提供 Inject[T] 和 MustInject[T] 泛型函数，编译期类型安全：

svc := binding.MustInject[*UserService](container, "userService")

Index

• func Inject[T any](container core.BeanGet, beanName string) (T, error)
• func MustInject[T any](container core.BeanGet, beanName string) T
• type Binder
  • func NewBinder() Binder
• type InjectOption
  • func WithOptional() InjectOption
  • func WithRequired() InjectOption
• type TypeConverter
  • func NewTypeConverter() TypeConverter
• type ValueResolver
• type ValueResolverFunc
  • func (f ValueResolverFunc) Resolve(key string) (string, bool)

Functions

func Inject

func Inject[T any](container core.BeanGet, beanName string) (T, error)

Inject 泛型注入函数，从容器中获取指定类型的 Bean 并注入。

这是用户 API 层使用的函数，提供编译期类型安全。 具体实现在 binding_impl.go 中。

参数:

• container: IoC 容器
• beanName: Bean 名称（可选）

返回:

• T: Bean 实例
• error: 错误信息

func MustInject

func MustInject[T any](container core.BeanGet, beanName string) T

MustInject 泛型注入函数，失败时 panic。

参数:

• container: IoC 容器
• beanName: Bean 名称（可选）

返回:

• T: Bean 实例

Types

type Binder

type Binder interface {
	// BindFields 将容器中的 Bean 注入到目标对象的字段中。
	// 支持 inject 标签和 @Autowired 注解。
	//
	// 参数:
	//   - target: 目标对象（必须是指针）
	//   - container: IoC 容器
	//
	// 返回:
	//   - error: 错误信息
	BindFields(target any, container core.BeanGet) error

	// BindValue 将配置值绑定到目标对象的字段中。
	// 支持 value 标签和 @Value 注解。
	//
	// 参数:
	//   - target: 目标对象（必须是指针）
	//   - resolver: 配置值解析器
	//
	// 返回:
	//   - error: 错误信息
	BindValue(target any, resolver ValueResolver) error

	// BindAll 执行完整的绑定流程（字段注入 + 配置绑定）。
	//
	// 参数:
	//   - target: 目标对象（必须是指针）
	//   - container: IoC 容器
	//   - resolver: 配置值解析器
	//
	// 返回:
	//   - error: 错误信息
	BindAll(target any, container core.BeanGet, resolver ValueResolver) error
}

Binder 数据绑定器接口。

负责将依赖注入到 Bean 实例中。

func NewBinder

func NewBinder() Binder

NewBinder 创建数据绑定器实例。

type InjectOption

type InjectOption func(*injectConfig)

InjectOption 注入选项函数类型。

func WithOptional

func WithOptional() InjectOption

WithOptional 设置依赖为可选。

func WithRequired

func WithRequired() InjectOption

WithRequired 设置依赖为必需。

type TypeConverter

type TypeConverter interface {
	// Convert 将字符串值转换为目标类型。
	//
	// 参数:
	//   - value: 字符串值
	//   - targetType: 目标类型名称
	//
	// 返回:
	//   - any: 转换后的值
	//   - error: 转换错误
	Convert(value string, targetType string) (any, error)
}

TypeConverter 类型转换器接口。

用于将字符串配置值转换为目标类型。

func NewTypeConverter

func NewTypeConverter() TypeConverter

NewTypeConverter 创建类型转换器实例。

type ValueResolver

type ValueResolver interface {
	// Resolve 解析配置键对应的值。
	//
	// 参数:
	//   - key: 配置键
	//
	// 返回:
	//   - string: 配置值
	//   - bool: 是否存在
	Resolve(key string) (string, bool)
}

ValueResolver 配置值解析器接口。

用于解析配置键对应的值。

type ValueResolverFunc

type ValueResolverFunc func(key string) (string, bool)

ValueResolverFunc 配置值解析器函数类型。

实现 ValueResolver 接口，方便使用函数式解析器。

func (ValueResolverFunc) Resolve

func (f ValueResolverFunc) Resolve(key string) (string, bool)

Resolve 实现 ValueResolver 接口。