Gone框架介绍9 - 如何优雅使用内置Goners?

本文主要是介绍Gone框架介绍9 - 如何优雅使用内置Goners?，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

文章目录

- 内置Goners
- `Priest`函数
- 如何使用
- 内置Goner的GoneId

我从头到尾实现了一个Golang的依赖注入框架，并且集成了gin、xorm、redis、cron、消息中间件等功能；自己觉得还挺好用的，推荐给你！
github地址：https://github.com/gone-io/gone
文档地址：https://goner.fun/
如果可能，请帮忙在github上点个 ⭐️ ；万分感谢！！

内置Goners

为了降低Gone的使用门槛，我们开发了一些内置Goners，用于提供一些基础的功能。

`Priest`函数

在gone框架内定义了Priest函数，在该函数里可以批量的埋葬用到的Goner；另外Priest函数可以嵌套，即A可以调用B，B可以调用C。那么，在我们开完一组功能后，可以提供一个Priest函数，将用到所有Goner批量埋葬。

实际上，在开发框架内置Goners，我们就采用这样的方式；另外为了方便调用，还在goner/priest.go中定义了一些快捷方式，代码如下：

package gonerimport ("github.com/gone-io/gone""github.com/gone-io/gone/goner/config""github.com/gone-io/gone/goner/gin""github.com/gone-io/gone/goner/logrus""github.com/gone-io/gone/goner/redis""github.com/gone-io/gone/goner/schedule""github.com/gone-io/gone/goner/tracer""github.com/gone-io/gone/goner/urllib""github.com/gone-io/gone/goner/xorm"
)func BasePriest(cemetery gone.Cemetery) error {_ = tracer.Priest(cemetery)_ = logrus.Priest(cemetery)_ = config.Priest(cemetery)return nil
}func GinPriest(cemetery gone.Cemetery) error {_ = gin.Priest(cemetery)return nil
}func XormPriest(cemetery gone.Cemetery) error {_ = xorm.Priest(cemetery)return nil
}func RedisPriest(cemetery gone.Cemetery) error {_ = redis.Priest(cemetery)return nil
}func SchedulePriest(cemetery gone.Cemetery) error {_ = schedule.Priest(cemetery)return nil
}func UrllibPriest(cemetery gone.Cemetery) error {return urllib.Priest(cemetery)
}

如何使用

这样，我们如果要使用基本的日志、trace、配置功能，我们只需要：

在主Priest函数中增加gone.BasePriest(cemetery):

func MasterPriest(cemetery gone.Cemetery) error {// 埋葬与日志、trace和配置相关的Goners_ = goner.BasePriest(cemetery)//调用其他 Priest_ = Priest(cemetery)return nil
}

如果需要打印日志，在需要的Goner上注入

package demoimport ("github.com/gone-io/gone""github.com/gone-io/gone/goner/gin""github.com/gone-io/gone/goner/logrus""web-app/internal/interface/domain"
)//go:gone
func NewDemoService() gone.Goner {return &demoService{}
}type demoService struct {gone.Flaglogrus.Logger `gone:"gone-logger"` //具名注入到 嵌套的匿名属性上log logrus.Logger `gone:"gone-logger"` //具名注入到 嵌套的log属性上
}func (svc *demoService) Echo(input string) (string, error) {//使用继承的方法svc.Infof("input content is %s", input)//使用属性上的方法svc.log.Infof("input content is %s", input)return input, nil
}

::: tip
注入内置组件，应该使用具名注入
:::

内置Goner的GoneId

内置Goner的GonerId，集中定义在https://github.com/gone-io/gone/blob/main/ids.go:

package gone// Gone框架中的内置组件ID
const (// IdGoneHeaven 天堂组件的ID，代码了程序本身，Gone程序启动时默认注入IdGoneHeaven = "gone-heaven"// IdGoneCemetery 坟墓组件的ID，是完成依赖注入的关键组件，Gone程序启动时默认注入IdGoneCemetery = "gone-cemetery"//IdGoneTestKit 测试箱，调用 gone.Test 或者 gone.TestAt 时，会将测试箱注入到程序；非测试代码中不应该注入该组件IdGoneTestKit = "gone-test-kit"// 配置、日志、Tracer 一起构成Gone框架的基础Goner，可以使用 [goner.BasePriest](goner#BasePriest) 牧师函数批量安葬//IdConfig 配置 Goner 的ID，提过能配置能力IdConfig = "config"//IdGoneConfigure 配置器 Goner 的IDIdGoneConfigure = "gone-configure"// IdGoneTracer Tracer Goner 的ID，提供日志追踪能力IdGoneTracer = "gone-tracer"// IdGoneLogger 日志 Goner 的ID，用于日志打印IdGoneLogger = "gone-logger"//IdGoneCumx [cmux Goner](/goner/cmux#Server) IDIdGoneCumx = "gone-cumx"//IdGoneGin Gin相关的组件ID，可以使用 [goner.GinPriest](goner#GinPriest) 牧师函数批量安葬IdGoneGin          = "gone-gin"IdGoneGinRouter    = "gone-gin-router"IdGoneGinProcessor = "gone-gin-processor"IdGoneGinProxy     = "gone-gin-proxy"IdGoneGinResponser = "gone-gin-responser"//IdGoneXorm Xorm Goner 的ID，封装了xorm，用于操作数据库；使用 [goner.XormPriest](goner#XormPriest) 牧师函数安葬IdGoneXorm = "gone-xorm"//IdGoneRedisPool redis pool goner; redis 相关 Goner，使用 [goner.RedisPriest](goner#RedisPriest) 牧师函数安葬IdGoneRedisPool     = "gone-redis-pool"IdGoneRedisCache    = "gone-redis-cache"IdGoneRedisKey      = "gone-redis-key"IdGoneRedisLocker   = "gone-redis-locker"IdGoneRedisProvider = "gone-redis-provider"// IdGoneSchedule 定时器Goner；使用 [goner.SchedulePriest](goner#SchedulePriest) 牧师函数安葬IdGoneSchedule = "gone-schedule"IdGoneReq = "gone-urllib"
)