Go Academy · 课时

钩子与作用域

Q: 「钩子与作用域」这节课中我会学到什么？

自定义查询 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

自定义查询

钩子与作用域 是 CoddyKit 上的免费 Go Academy 课时。这是第 4 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

钩子与作用域

GORM 提供两种自定义工具：钩子会在生命周期事件前后自动运行代码，作用域则封装可复用的查询逻辑。二者结合可以使数据访问保持清晰一致。

什么是钩子

钩子是模型上的方法，GORM 会在操作前后调用它们：BeforeCreate、AfterCreate、BeforeUpdate、BeforeDelete 等。

BeforeCreate 钩子

请在模型上定义具有正确签名的方法。这里我们会在插入记录前设置一个 UUID。

func (u *User) BeforeCreate(tx *gorm.DB) error {
    u.UUID = uuid.NewString()
    return nil
}

在钩子中进行验证

从钩子返回错误即可中止操作。GORM 会回滚外围事务，因此无效数据永远不会到达数据库。

func (u *User) BeforeSave(tx *gorm.DB) error {
    if u.Age < 0 {
        return errors.New("age cannot be negative")
    }
    return nil
}

钩子在事务中运行

tx *gorm.DB 参数就是 GORM 正在使用的事务。如果您在钩子中写入相关数据，请使用这个 tx，这样它就能与主操作一起以原子方式提交或回滚。

什么是 Scopes

作用域是一个接收并返回 *gorm.DB 的函数，用于封装查询片段。您可以通过 db.Scopes(...) 应用它，并在多个查询之间复用。

func ActiveUsers(db *gorm.DB) *gorm.DB {
    return db.Where("active = ?", true)
}

应用 Scopes

将一个或多个作用域传递给 Scopes。它们可以组合使用，因此您可以以声明式方式组合过滤条件，生成最终查询。

db.Scopes(ActiveUsers, Recent).Find(&users)

可运行的钩子与作用域模拟

GORM 需要数据库，因此这个可运行示例使用普通函数模拟 BeforeCreate 钩子和可复用的类似作用域的过滤器。

package main

import (
    "errors"
    "fmt"
)

type User struct {
    Name   string
    Age    int
    Active bool
}

func beforeCreate(u *User) error {
    if u.Age < 0 {
        return errors.New("age cannot be negative")
    }
    if u.Name == "" {
        u.Name = "anonymous"
    }
    return nil
}

func activeOnly(users []User) []User {
    var out []User
    for _, u := range users {
        if u.Active {
            out = append(out, u)
        }
    }
    return out
}

func main() {
    u := User{Age: 30, Active: true}
    if err := beforeCreate(&u); err != nil {
        fmt.Println("error:", err)
        return
    }
    fmt.Println("created:", u.Name)
    all := []User{u, {Name: "Lin", Active: false}}
    fmt.Println("active count:", len(activeOnly(all)))
}

使用 Scopes 实现分页

常见的作用域会根据页码生成分页，将 Offset 和 Limit 封装起来，从而让每个列表接口都以相同方式进行分页。

func Paginate(page, size int) func(*gorm.DB) *gorm.DB {
    return func(db *gorm.DB) *gorm.DB {
        return db.Offset((page - 1) * size).Limit(size)
    }
}

钩子与应用逻辑

钩子集中处理时间戳、短标识和审计字段等横切关注点。请将复杂的业务逻辑放在服务中，而不是钩子中，这样行为会更可预测，也更易于测试。

跳过钩子

对于批量操作，您可以使用 db.Session(&gorm.Session{SkipHooks: true}) 禁用钩子。这样可以加快大量导入，但会跳过您的验证，因此请谨慎使用。

快速检查

测试您对钩子和作用域的掌握情况。

回顾

您学到了钩子和作用域：

钩子会围绕生命周期事件运行；返回错误会中止操作并回滚
钩子通过 tx 参数在事务内部运行
作用域是可复用的 *gorm.DB 函数，通过 Scopes 应用
使用作用域实现过滤和分页
SkipHooks 会在批量操作时绕过钩子

常见问题解答

「钩子与作用域」课时是免费的吗？

是的 — 「钩子与作用域」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「钩子与作用域」这节课中我会学到什么？

自定义查询你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 4 节课，共 4 节。

「钩子与作用域」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy