Gone框架介绍13 - Gone的Hook函数

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

什么是Hook函数

在Gone的启停过程中，支持注册4种类型的函数，这个些函数会在特定时机被执行，被称为Hook函数。

• BeforeStart Hook函数，在Gone启动前执行，通过BeforeStart注册
• AfterStart Hook函数，在Gone启动后执行，通过AfterStart注册
• BeforeStop Hook函数，在Gone停止前执行，通过BeforeStop注册
• AfterStop Hook函数，在Gone停止后执行，通过AfterStop注册

看一段代码

package main

import "github.com/gone-io/gone"

type Worker struct {
	gone.Flag
	Name string
}

type Boss struct {
	gone.Flag

	Name string
}

func main() {
	gone.
		Prepare(func(cemetery gone.Cemetery) error {
			cemetery.Bury(&Boss{Name: "Jim"}, "boss-jim")
			cemetery.Bury(&Worker{Name: "Bob"}, "worker-bob")
			return nil
		}).
		BeforeStart(func() {
			println("第1个 BeforeStart 函数")

		}).
		BeforeStart(func(in struct {
			worker Worker `gone:"worker-bob"`
			boss   Boss   `gone:"*"`
		}) {
			println("第2个 BeforeStart 函数")
			println("boss:", in.boss.Name)
			println("worker:", in.worker.Name)
		}).
		BeforeStart(func() error {
			println("第3个 BeforeStart 函数")

			return nil
		}).
		Run()
}

上面代码代码的执行结果如下：

第3个 BeforeStart 函数
第2个 BeforeStart 函数
boss: Jim
worker: Bob
第1个 BeforeStart 函数

Hook函数遵循以下规则

1. 同一种类型的Hook函数可以多次注册；
2. BeforeStart 和 BeforeStop Hook 函数，先注册的后执行；
3. AfterStart 和 AfterStop Hook 函数，先注册的先执行；
4. 通过gone.Prepare(priest)返回的Preparer对象注册Hook 函数，支持链式调用；
5. Preparer对象注册Hook 函数，函数支持多种类型：
   • 入参
     • 无参数
     • 匿名结构体参数，属性设置gone标签会被自动注入响应的值
   • 出参
     • 无出参
     • error参数，如果error参数不为nil，程序执行到该Hook时会抛出panic,终止运行

Gone的启动流程

1. 复活所有埋葬的Goners
2. 执行所有先知Goners的AfterRevive方法
3. 将天使的Start方法注册为BeforeStart Hook函数；将天使的Stop方法注册为BeforeStop Hook 函数；
4. 业务代码注册 Hook 函数
5. 按顺序执行 BeforeStart Hook 函数
6. 按顺序执行 AfterStart Hook 函数
7. 等待程序结束
8. 按顺序执行BeforeStop Hook 函数
9. 按顺序执行AfterStop Hook 函数

求赞助

如果觉得还可以，请帮忙在github上点个 ⭐️吧：
github地址：https://github.com/gone-io/gone

福利：🔥添加交流群，赠送 Golang 多套 学习资料，夯实基础👍🏻👍🏻

上一篇：Gone框架介绍12 - 通过内置Goners支持数据库操作
下一篇：Gone框架介绍14 -日志输出