全局对象

Maltose 提供了 frame/m 包作为核心组件的统一入口。它负责获取默认实例或具名实例，减少手动初始化样板代码。

使用方式

import "github.com/graingo/maltose/frame/m"

常用对象

m.Server()

s := m.Server()
s.GET("/", func(r *mhttp.Request) {
    r.String(200, "hello")
})
s.Run()

m.Config()

ctx := context.Background()

appName, _ := m.Config().Get(ctx, "app.name")
fmt.Println(appName.String())

m.Log()

ctx := context.Background()

m.Log().Infof(ctx, "user %s login", "alice")
m.Log().Infow(ctx, "user login", mlog.String("user", "alice"))

m.DB()

ctx := context.Background()

var user User
err := m.DB().WithContext(ctx).
    Where("name = ?", "maltose").
    First(&user).
    Error

m.DBContext()

ctx := context.Background()

var user User
err := m.DBContext(ctx).
    Where("id = ?", 1).
    First(&user).
    Error

m.Redis()

ctx := context.Background()

if err := m.Redis().SetEX(ctx, "mykey", "myvalue", time.Minute); err != nil {
    panic(err)
}

val, err := m.Redis().Get(ctx, "mykey")
if err != nil {
    panic(err)
}
if val != nil {
    fmt.Println(val.String())
}

具名实例

Server、Config、Log、DB、Redis 都支持具名实例。

cache := m.Redis("cache")
accessLogger := m.Log("access")
reportDB := m.DB("report")

关于 mcache

mcache 不通过 m 包暴露默认实例，而是直接提供包级方法：

mcache.Set(ctx, "my-key", "my-value", time.Minute)
val, _ := mcache.Get(ctx, "my-key")

使用建议

• 中小型项目里，直接使用全局对象通常已经足够。
• 如果你在做高强度单元测试或复杂依赖替换，建议把全局对象包在自己的 service 层里，减少直接耦合。