Gone支持的依赖注入方式

为了区分结构体属性是否需要依赖注入,我们引入一个标签------gone,拥有gone标签的属性将在Gone启动过程中被注入需要的依赖。

支持的属性类型

值类型

结构体的属性为某个机构体的值类型,如下面代码中的Boss.Seller

go 复制代码
type Worker struct {
	gone.Flag
	Name      string
}

type Boss struct {
    gone.Flag
    Seller  Worker `gone:"*"`  //值类型
}

::: warning 注意:不推荐使用值类型做注入 "值类型 的赋值和传参都是传递的拷贝",这意味着我们如果使用 值类型 注入时,实际上产生了一个新的"对象",新分配了一块内存,并且新旧对象只有在"传递那一刻"是相等,他们在内存中是独立的;这可能导致一些不符合"直觉"的结果,举个例子:

go 复制代码
type BGoner struct {
	gone.Flag

	a1 AGoner  `gone:"A1"` // 值注入
	a2 AGoner  `gone:"A1"` // 值注入
}

func (g *BGoner) AfterRevive() gone.AfterReviveError {
	g.a1.Name = "dapeng"
	g.a2.Name = "wang"

	fmt.Printf("a1 is eq a2: %v", g.a1 == g.a2)

	return nil
}

在上面的代码中,打印的结果会是 false。 :::

指针类型

接收注入的结构体属性是另一个结构体的指针,如下面代码的Boss.Seller的类型为 *Worker:

go 复制代码
type Worker struct {
	gone.Flag
	Name      string
}

type Boss struct {
    gone.Flag
    Seller  *Worker `gone:"*"`  //指针类型
}

接口类型

接收注入的结构体属性是一个接口,如下面代码的Boss.Seller的类型为 Seller,Gone会从注册的Goners中查找实现了Seller接口的Goner赋值给Boss.Seller

go 复制代码
type Seller interface {
    Sell() error
}

type Boss struct {
    gone.Flag
    Seller Seller `gone:"*"`  //接口类型
}

slice 类型

接收注入的结构体属性还可以是 slice 类型,slice 的元素类型允许为 值类型(由于值拷贝,不推荐使用)、指针类型 和 接口类型,如下代码中的Boss.SellersBoss.WorkersBoss.Persons,Gone会尝试间类型兼容的所有goners添加到slice中。

go 复制代码
type Worker struct {
	gone.Flag
	Name      string
}

type Seller interface {
    Sell() error
}

type Boss struct {
    gone.Flag
    Sellers []Seller  `gone:"*"`  //Slice 类型,元素为接口类型
    Workers []*Worker `gone:"*"`   //Slice 类型,元素为指针类型
    Persons []Worker  `gone:"*"`   //Slice 类型,元素为值类型
}

map 类型

接收注入的结构体属性还可以是 map 类型,map 的元素类型允许为 值类型(由于值拷贝,不推荐使用)、指针类型 和 接口类型。map 的 key 只能被定义为string类型,被注入后map key 的值为 GonerId(后面介绍什么是GonerId)。

举个例子

go 复制代码
type Worker struct {
	gone.Flag
	Name      string
}

type Seller interface {
    Sell() error
}

type Boss struct {
    gone.Flag
    Sellers map[string]Seller  `gone:"*"`  //Map 类型,元素为接口类型
    Workers map[string]*Worker `gone:"*"`   //Map 类型,元素为指针类型
    Persons map[string]Worker  `gone:"*"`   //Map 类型,元素为值类型
}

GonerId 和 具名注入

GonerId

Goner注册到Gone框架,支持传递一个可选参数GonerId,如果不传也会随机生成一个,如下:

go 复制代码
type Worker struct {
	gone.Flag
	Name      string
}

type Seller interface {
    Sell() error
}

type Boss struct {
    gone.Flag
    Sellers map[string]Seller  `gone:"*"`  //Map 类型,元素为接口类型
    Workers map[string]*Worker `gone:"*"`   //Map 类型,元素为指针类型
    Persons map[string]Worker  `gone:"*"`   //Map 类型,元素为值类型
}


func Priest(cemetery gone.Cemetery) error {
	cemetery.
		Bury(&Worker{}, gone.GonerId("worker-01")). //注册;使用worker-01做GonerId
		Bury(&Worker{}, gone.GonerId("worker-02")). //注册;使用worker-02做GonerId
		Bury(&Boss{}) //匿名注册,不关心GonerId是什么
	return nil
}

具名注入

前面的例子中,依赖注入标记gone的值都是*,意思让Gone自动寻找或者构建兼容的类型完成注入,我们称之为 匿名注入 。另外,Gone支持在gone标签赋予一个值作为GonerId,要求Gone查找特定GonerId的Goner完成依赖注入,也就是 具名注入

如下面代码中,Boss.Manager的注入,Gone会自动寻找GonerId为worker-01的Goner,完成注入。

go 复制代码
type Boss struct {
	gone.Flag
	Manager *Worker `gone:"worker-01"` //具名注入
}

私有属性注入

前面的例子中,所有的属性都是 共有属性 (又称Exported,是大写字母打头的,在包外部可以访问的);Gone实际是支持在私有属性上完成依赖注入的,如下:

go 复制代码
type Boss struct {
	gone.Flag
	manager *Worker `gone:"worker-01"` //manager为私有属性也是可以的
}

我们推荐使用私有属性注入,因为被依赖注入的"对象"一般仅限于内部使用,使用私有属性注入,可以减少代码的耦合度,提高代码的可维护性。

其他注入方式

函数参数注入

Gone还支持对函数的参数进行依赖注入,函数参数注入

配置参数注入

配置参数的注入,是用内置组件goner/config实现的。

HTTP请求参数注入

HTTP请求参数的注入,是指在处理HTTP请求时,将请求的相关参数注入到处理函数的参数上,这部分功能由内置组件goner/gin实现。

相关推荐
白鲸开源10 小时前
Ubuntu 22 下 DolphinScheduler 3.x 伪集群部署实录
java·ubuntu·开源
算家计算10 小时前
模糊高清修复真王炸!ComfyUI-SeedVR2-Kontext(画质修复+P图)本地部署教程
人工智能·开源·aigc
weiwenhao11 小时前
关于 nature 编程语言
人工智能·后端·开源
影灵衣丶18 小时前
Go 1.25 实战解读:绿茶 GC 与容器核心数感知(工程影响与落地)
后端·go
一直_在路上18 小时前
突发高流量应对之道:Go语言限流、熔断、降级三板斧
面试·go
NocoBase19 小时前
GitHub 上 Star 数量前 10 的开源项目管理工具
开源·github·资讯
程序员爱钓鱼19 小时前
Go语言100个实战案例-项目实战篇:股票行情数据爬虫
后端·go·trae
算家计算1 天前
7B参数拿下30个世界第一!Hunyuan-MT-7B本地部署教程:腾讯混元开源业界首个翻译集成模型
人工智能·开源
FIT2CLOUD飞致云1 天前
SQLBot开源智能问数系统成功进入GitHub趋势榜主榜,Star数突破2,000个!
开源
scilwb2 天前
Isaac Sim机械臂教程 - 阶段1:基础环境搭建与机械臂加载
人工智能·开源