50 lines
1.7 KiB
Go
50 lines
1.7 KiB
Go
package modular
|
|
|
|
import "reflect"
|
|
|
|
// Service 模块化服务接口，所有的服务均需要实现该接口，在服务的生命周期内发生任何错误均应通过 panic 阻止服务继续运行
|
|
// - 生命周期示例： OnInit -> OnPreload -> OnMount
|
|
//
|
|
// 在 Golang 中，包与包之间互相引用会导致循环依赖，因此在模块化应用程序中，所有的服务均不应该直接引用其他服务。
|
|
//
|
|
// 服务应该在 OnInit 阶段将不依赖其他服务的内容初始化完成，并且如果服务需要暴露给其他服务调用，那么也应该在 OnInit 阶段完成对外暴露。
|
|
// - 暴露方式可参考 modular/example
|
|
//
|
|
// 在 OnPreload 阶段，服务应该完成对其依赖服务的依赖注入，最终在 OnMount 阶段完成对服务功能的定义、路由的声明等。
|
|
type Service interface {
|
|
// OnInit 服务初始化阶段，该阶段不应该依赖其他任何服务
|
|
OnInit()
|
|
|
|
// OnPreload 预加载阶段，在进入该阶段时，所有服务已经初始化完成，可在该阶段注入其他服务的依赖
|
|
OnPreload()
|
|
|
|
// OnMount 挂载阶段，该阶段所有服务本身及依赖的服务都已经初始化完成，可在该阶段进行服务功能的定义
|
|
OnMount()
|
|
}
|
|
|
|
// RegisterServices 注册服务
|
|
func RegisterServices(s ...Service) {
|
|
application.RegisterServices(s...)
|
|
}
|
|
|
|
// RegisterService 注册服务
|
|
func RegisterService[S Service](service S) S {
|
|
application.RegisterServices(service)
|
|
return service
|
|
}
|
|
|
|
func newService(instance Service) *service {
|
|
vof := reflect.ValueOf(instance)
|
|
return &service{
|
|
name: vof.Type().String(),
|
|
instance: instance,
|
|
vof: vof,
|
|
}
|
|
}
|
|
|
|
type service struct {
|
|
name string
|
|
instance Service
|
|
vof reflect.Value
|
|
}
|