使用xorm配合wire做依赖注入,核心做法是将数据库引擎实例作为接口或具体类型传入构造函数,由wire生成初始化代码并管理生命周期。你需要定义一个包含`*xorm.engine`的结构体,并在wire的provider中通过工厂函数创建该结构体,从而在业务逻辑层实现无侵入式的数据库访问。

如何定义XORM引擎的Provider
在Wire中,我们需要提供一个能够返回`*xorm.Engine`的函数。通常建议封装一个`NewEngine`函数,它接收数据库连接字符串等配置参数,并返回引擎实例及可能的错误。这个Provider是依赖注入链路的起点,确保整个应用共享同一个引擎实例。

package main
import (
"fmt"
"log"
"github.com/go-sql-driver/mysql"
"github.com/google/wire"
"github.com/xormplus/xorm"
)
type Config struct {
DSN string
}
// NewEngine 是一个Provider,负责创建和返回XORM引擎
func NewEngine(cfg Config) (*xorm.Engine, error) {
engine, err := xorm.NewEngine("mysql", cfg.DSN)
if err != nil {
return nil, fmt.Errorf("create engine: %w", err)
}
// 设置日志级别等基础配置
engine.SetLogLevel(2)
return engine, nil
}
// ProviderSet 声明了所有可用的Provider
var ProviderSet = wire.NewSet(NewEngine)
上述代码定义了`NewEngine`函数,它接受`Config`结构体并返回`*xorm.Engine`。在`ProviderSet`中注册该函数后,Wire就能识别出如何构建引擎。开发者只需在`main.go`中调用`wire.Build`即可自动生成初始化代码。
如何将引擎注入到Service层
定义好引擎Provider后,下一步是在业务服务(Service)中注入该引擎。我们创建一个`UserService`结构体,其构造函数接收`*xorm.Engine`。Wire会自动解析依赖关系,将引擎实例传递给Service,从而实现解耦。

package service
import (
"github.com/xormplus/xorm"
)
type User struct {
ID int64 `xorm:"pk autoincr"`
Name string `xorm:"varchar(50) notnull"`
}
type UserService struct {
engine *xorm.Engine
}
// NewUserService 构造函数,依赖注入XORM引擎
func NewUserService(engine *xorm.Engine) *UserService {
return &UserService{engine: engine}
}
// GetUserByID 示例方法
func (s *UserService) GetUserByID(id int64) (*User, error) {
user := new(User)
has, err := s.engine.ID(id).Get(user)
if err != nil {
return nil, err
}
if !has {
return nil, nil
}
return user, nil
}
在`UserService`中,`NewUserService`函数接收`*xorm.Engine`作为参数。Wire生成的代码会确保在创建`UserService`时,已经成功初始化了引擎。这种模式使得测试变得容易,因为你可以轻松替换为Mock引擎进行单元测试。
当引擎初始化失败时Wire如何处理
如果`NewEngine`函数返回非nil错误,Wire生成的初始化代码也会返回该错误。在`main`函数中,你需要检查`InitApp`的返回值。如果引擎创建失败(如连接串错误、权限不足),程序应直接退出或记录日志,而不是继续运行,以避免后续空指针异常。


















