GeeORM 第五天:为 ORM 框架实现 Hook 钩子机制(BeforeInsert / AfterQuery / BeforeUpdate / AfterDelete 等 8 个扩展点)

发布时间:2026/11/17 6:09:50

GeeORM 第五天:为 ORM 框架实现 Hook 钩子机制(BeforeInsert / AfterQuery / BeforeUpdate / AfterDelete 等 8 个扩展点) GeeORM 第五天为 ORM 框架实现 Hook 钩子机制BeforeInsert / AfterQuery / BeforeUpdate / AfterDelete 等 8 个扩展点【免费下载链接】7days-golang7 days golang programs from scratch (web framework Gee, distributed cache GeeCache, object relational mapping ORM framework GeeORM, rpc framework GeeRPC etc) 7天用Go动手写/从零实现系列项目地址: https://gitcode.com/gh_mirrors/7d/7days-golang本文是 7 天用 Go 从零实现 ORM 框架 GeeORM 系列的第五篇讲解如何在记录增删查改CRUD前后埋设扩展点通过 Go 反射reflect动态获取并调用结构体绑定的钩子方法并以不到 50 行代码为框架注入「查询后密码脱敏」「插入前主键自增」等横切能力。读完本文你将掌握 Hook 机制的通用设计思想、GeeORM 中 8 个钩子常量的语义与调用约定以及如何基于 day5-hooks 目录的源码与测试用例验证钩子行为。1 Hook 机制在正确的位置埋下扩展点Hook翻译为钩子核心思想是提前在可能增加功能的地方埋好一个扩展点当需要修改或增强该处逻辑时把扩展的类或方法挂载到这个点上即可而无需改动原有代码。钩子的应用在工程实践中非常普遍持续集成GitHub 与 Travis CI 集成后一旦发生git push事件就会触发 Travis 拉取最新代码执行构建IDE 插件按下Ctrl S保存时自动触发代码格式化前端热更新代码文件变更后自动编译打包并通知浏览器刷新页面实现所写即所得。一个 Hook 机制设计得好不好取决于扩展点选得是否合适。例如对于持续集成而言代码没有变更时反复构建毫无意义因此钩子应设计在代码可能发生变更的位置如 MR/PR 合并前后。同理对于 ORM 框架最合适的扩展点显然是记录的增删查改前后操作前置钩子后置钩子典型用途查询FindBeforeQueryAfterQuery查询后对敏感字段脱敏、组装业务字段插入InsertBeforeInsertAfterInsert插入前生成主键、填充创建时间更新UpdateBeforeUpdateAfterUpdate更新前校验字段、自动刷新UpdatedAt删除DeleteBeforeDeleteAfterDelete删除前软删除标记、级联清理以密码脱敏为例假设Account结构体包含隐私字段Password那么每次查询后都需要对结果做脱敏处理才能继续使用。如果提供了AfterQuery钩子查询后自动将Password置为******就能省去调用方大量重复代码——这正是本文实现的动机。2 GeeORM 钩子 API8 个常量与统一调用约定GeeORM 的钩子与结构体绑定即每个结构体需要自行实现各自的钩子方法。钩子相关代码全部集中在 hooks.go 中首先定义 8 个钩子常量// Hooks constants const ( BeforeQuery BeforeQuery AfterQuery AfterQuery BeforeUpdate BeforeUpdate AfterUpdate AfterUpdate BeforeDelete BeforeDelete AfterDelete AfterDelete BeforeInsert BeforeInsert AfterInsert AfterInsert )这 8 个常量同时充当两层身份一是钩子名称的字符串标识二是约定结构体上需要实现的方法名。即用户若想为Account注册查询后钩子只需实现方法func (account *Account) AfterQuery(s *Session) errorGeeORM 会在查询流程中自动调用。钩子签名约定每个钩子的入参均为*Session当前会话这样钩子内部可以继续访问数据库执行额外操作如级联更新返回值为error非 nil 时 GeeORM 会通过日志输出错误见下文CallMethod中对返回值的第一项进行类型断言。3 核心实现基于反射的 CallMethod钩子机制与 GeeORM 整体的对象 ↔ 表结构映射一样都是靠反射实现的。核心调用入口是 hooks.go 中的CallMethod// CallMethod calls the registered hooks func (s *Session) CallMethod(method string, value interface{}) { fm : reflect.ValueOf(s.RefTable().Model).MethodByName(method) if value ! nil { fm reflect.ValueOf(value).MethodByName(method) } param : []reflect.Value{reflect.ValueOf(s)} if fm.IsValid() { if v : fm.Call(param); len(v) 0 { if err, ok : v[0].Interface().(error); ok { log.Error(err) } } } return }逐行拆解其工作原理获取当前操作对象s.RefTable()返回当前会话的表结构描述对象*schema.Schema见 schema.gos.RefTable().Model即此前通过Model(Account{})绑定的模型指针反射定位方法reflect.ValueOf(...).MethodByName(method)通过方法名字符串如AfterQuery在对象上查找对应方法。若方法不存在返回的Value是无效值IsValid()为 falseCall不会执行因此未实现钩子的结构体完全不受影响——这是钩子机制优雅退化的关键对象优先级当value ! nil时如Find中逐行扫描出的记录指针改用value反射其方法从而让AfterQuery能操作每一行具体的记录构造入参并调用param : []reflect.Value{reflect.ValueOf(s)}将*Session包装为反射参数随后fm.Call(param)完成动态调用错误处理若方法返回了值则断言第一项是否为error接口类型是则通过 log 输出错误日志log.Error(err)。注意这里只记录日志、不中断流程属于设计取舍。从源码结构可以推断钩子的触发条件非常宽松——结构体实现了对应方法就调用没实现就静默跳过调用方无需关心目标类型是否注册过钩子。4 接入 CRUD在 Insert / Find / Update / Delete 内部埋点CallMethod本身只是扳机真正让钩子生效的是把它嵌入到四个 CRUD 方法中。这部分改动全部发生在 record.go。4.1 Insert插入前改值插入后收尾func (s *Session) Insert(values ...interface{}) (int64, error) { recordValues : make([]interface{}, 0) for _, value : range values { s.CallMethod(BeforeInsert, value) table : s.Model(value).RefTable() s.clause.Set(clause.INSERT, table.Name, table.FieldNames) recordValues append(recordValues, table.RecordValues(value)) } // ... 构建 INSERT 语句并执行 s.CallMethod(AfterInsert, nil) return result.RowsAffected() }注意Insert支持一次插入多条记录可变参数values ...interface{}因此BeforeInsert在每条记录上都会触发一次且传入的是该条记录的指针钩子可以修改它的字段值例如测试用例中的account.ID 1000而AfterInsert在整个插入完成后触发一次传入nil。4.2 Find查询前后分别埋点AfterQuery 逐行生效func (s *Session) Find(values interface{}) error { s.CallMethod(BeforeQuery, nil) // ... 构建 SELECT 语句并执行 for rows.Next() { dest : reflect.New(destType).Elem() // ... 将每行数据 Scan 进 dest s.CallMethod(AfterQuery, dest.Addr().Interface()) destSlice.Set(reflect.Append(destSlice, dest)) } return rows.Close() }与BeforeQuery不同AfterQuery在rows.Next()循环体内、对每一行扫描完成的记录指针调用一次对应源码 record.go因此它天然支持逐行脱敏、逐行填充衍生字段等场景。First方法内部正是复用Finds.Limit(1).Find(...)来获取首行记录所以AfterQuery钩子对First同样生效。4.3 Update 与 Delete前置校验、后置清理func (s *Session) Update(kv ...interface{}) (int64, error) { s.CallMethod(BeforeUpdate, nil) // ... 构建 UPDATE 语句并执行 s.CallMethod(AfterUpdate, nil) return result.RowsAffected() } func (s *Session) Delete() (int64, error) { s.CallMethod(BeforeDelete, nil) // ... 构建 DELETE 语句并执行 s.CallMethod(AfterDelete, nil) return result.RowsAffected() }Update与Delete均以前置钩子 — 执行 SQL — 后置钩子的对称结构埋点。需要说明的是record.go 中这两个方法的前置钩子均传入nil即作用于当前Session绑定的模型对象s.RefTable().Model而非具体记录——这意味着更新/删除钩子更适合做基于*Session的全局性处理如记录操作日志若要针对单条记录做精细控制可从CallMethod的参数扩展入手。至此全部 8 个钩子都已在框架内接入整个钩子特性仅新增约 50 行代码含常量定义与CallMethod实现延续了 GeeORM 每天少量代码 完整单测的搭积木式演进风格。5 测试验证BeforeInsert 自增主键 AfterQuery 密码脱敏GeeORM 每个特性都配有可独立运行的单元测试。钩子的测试用例位于 hooks_test.go核心代码如下type Account struct { ID int geeorm:PRIMARY KEY Password string } func (account *Account) BeforeInsert(s *Session) error { log.Info(before inert, account) account.ID 1000 return nil } func (account *Account) AfterQuery(s *Session) error { log.Info(after query, account) account.Password ****** return nil } func TestSession_CallMethod(t *testing.T) { s : NewSession().Model(Account{}) _ s.DropTable() _ s.CreateTable() _, _ s.Insert(Account{1, 123456}, Account{2, qwerty}) u : Account{} err : s.First(u) if err ! nil || u.ID ! 1001 || u.Password ! ****** { t.Fatal(Failed to call hooks after query, got, u) } }该用例覆盖了两个钩子的完整闭环BeforeInsert修改入库数据插入两条记录{1, 123456}与{2, qwerty}钩子将每条记录的ID加 1000实际入库主键变为 1001 和 1002AfterQuery实现脱敏通过First查询出第一条记录AfterQuery钩子把Password置为 6 个*断言校验u.ID 1001 u.Password ******同时验证了插入前改值生效与查询后脱敏生效两条链路。测试执行前置条件测试使用NewSession()见 raw.go与 SQLite 内存数据库驱动DropTable/CreateTable见 table.go保证测试环境干净可重复。运行测试在仓库根目录下执行cd gee-orm/day5-hooks go test ./... -run TestSession_CallMethod -v该模块的go.mod依赖github.com/mattn/go-sqlite3需保证 Go 环境与 CGO 可用。运行日志中会依次输出before inert与after query两条钩子日志直观展示触发时序。6 小结钩子为 GeeORM 注入的可扩展性通过第五天的实现GeeORM 获得了与 gorm、xorm 等主流框架对齐的钩子能力零侵入扩展结构体按约定实现BeforeXxx/AfterXxx方法即自动生效不实现则静默跳过统一反射调用CallMethod一处实现四处复用Insert / Find / Update / Delete新增钩子类型只需扩展常量表逐行与全局两级粒度AfterQuery/BeforeInsert可精确到单条记录传入记录指针其余钩子作用于整个会话。这也是系列后续功能的地基之一第六天的事务Transaction会在会话上引入Begin/Commit/Rollback第七天的数据库迁移Migrate则会借助反射自动比对并变更表结构——钩子机制所依赖的反射与 Session 抽象将在其中继续发挥核心作用。【免费下载链接】7days-golang7 days golang programs from scratch (web framework Gee, distributed cache GeeCache, object relational mapping ORM framework GeeORM, rpc framework GeeRPC etc) 7天用Go动手写/从零实现系列项目地址: https://gitcode.com/gh_mirrors/7d/7days-golang创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/17 6:08:32

江苏的特种工延期流程通过率揭秘:外省证转过来怎么做?

江苏的特种工延期流程通过率揭秘:外省证转过来怎么做? 之前考的证在外省能不能转过来?这个问题困扰了太多人,特别是那些在江苏从事特种作业却拿着外地证书的小伙伴。别急,今天就来聊聊【江苏的特种工延期流程】,并揭秘一下这个流程的通过率到底是多少,…

2026/11/17 6:08:32

装弱电要电工证吗?真实经历告诉你别怕考不过白交培训费

装弱电要电工证吗?真实经历告诉你别怕考不过白交培训费 怕考不过白交培训费?我认识的几个同学,就是因为没搞清楚【装弱电要电工证吗】这个问题,结果花了冤枉钱还白忙活。今天就从洛阳涧西区一个应届工程类毕业生的真实经历出发,详细说说怎么考、怎么避坑…

2026/11/17 6:08:32

六安考低压电工证在哪考?学历不高也能报名

六安考低压电工证在哪考?学历不高也能报名 你是不是也觉得, 学历不高怕报不上名 ?想考低压电工证,却不知道 在哪考 ?别急,这篇文章是专为你准备的。咱们用最真实、最接地气的方式,从济源培训机构学员的角度出发,告诉你六安考低压电工证的全流程、…

2026/11/17 6:08:32

吴江低压电工证报名门槛低吗?学历不高怕报不上名的良心建议

吴江低压电工证报名门槛低吗?学历不高怕报不上名的良心建议 你是不是也担心自己学历不高,连吴江低压电工证都报不了?别急,今天我就从一个在漯河劳务班组混了五年的老电工角度,给你讲讲吴江低压电工证的真相。很多人以为这个证只有高学历的人才能考,其实…

2026/11/17 6:08:32

灌云电工证在哪里培训 上岗必须要这个证吗 怎么报名才靠谱

灌云电工证在哪里培训 上岗必须要这个证吗 怎么报名才靠谱 你是不是也遇到过这样的情况:想找电工证培训,网上一搜信息五花八门,不知道哪个靠谱?怕被中介坑?别急,今天就带你一步步搞清楚【灌云电工证在哪里培训】,以及怎么报名才不会被坑,还能顺利拿…

2026/11/16 7:29:52

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/16 5:30:20

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/17 0:02:41

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期 证书过期了不知道怎么复审延期,这种情况在电工圈里太常见了。我有个同事,去年刚把低压电工证给弄丢了,直到单位查岗才发现证书已经过期,差点被停工处理。今天就用我真实经历给你讲讲电工证操作…

2026/11/17 0:02:41

机修需不需要电工证 在哪考最靠谱 这些细节必须知道

机修需不需要电工证 在哪考最靠谱 这些细节必须知道 之前考的证在外省能不能转过来?这个问题几乎每个特种作业从业者都问过。特别是像你这样,之前在外省考了证,现在想在本地扎根,或者想换证、换岗的机修人员,最关心的就是【机修需不需要电工证】和【在…

2026/11/17 0:02:41

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么 工地太忙根本没时间复习考试,我理解你。作为一名刚从焦作工程类院校毕业的学生,我也经历过这种困扰。电工证年检步骤是什么,听起来简单,但实际操作中,很多人因为流程不清楚、资料准备不…

2026/11/17 0:49:41

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/16 3:17:47

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑