前言

最近一直在用GoFrame（下文简称gf）来开发项目，在熟悉业务逻辑之后就是马不停蹄的撸代码了。

gf是支持ORM原生操作的，在ORM链式操作执行不了太过于复杂的SQL操作时，可以交给方法操作来处理。

开箱体验

1. ORM对象

// 获取默认配置的数据库对象(配置名称为"default")
db := g.DB()

// 获取配置分组名称为"user"的数据库对象
db := g.DB("user")

// 使用原生单例管理方法获取数据库对象单例
db, err := gdb.Instance()
db, err := gdb.Instance("user")

tips

不用的时候不需要使用Close方法关闭数据库连接，数据库引擎底层采用了链接池设计，当链接不再使用时会自动关闭

2. 数据写入

r, err := db.Insert(ctx, "user", gdb.Map {
    "name": "王中阳",
})

3. 数据查询(单条)

虽然limit 10，但是因为我们使用的是GetOne,仍然只会返回单条数据

one, err := db.GetOne(ctx, "select * from user limit 10")
one, err := db.GetOne(ctx, "select * from user where id=100")
one, err := db.GetOne(ctx, "select * from user where id=?", 100)
one, err := db.GetOne(ctx, "select * from user where id=?", g.Slice{100})

4. 数据查询(列表)

list, err := db.GetAll(ctx, "select * from user limit 10")
list, err := db.GetAll(ctx, "select * from user where age > ? and name like ?", g.Slice{20, "%金%"})
list, err := db.GetAll(ctx, "select * from user where status=?", g.Slice{1})

5. 数据保存

数据保存是Save，插入数据是insert，区别是是否指定主键

r, err := db.Save(ctx, "user", gdb.Map {
    "id"  :  1,
    "name" : "王中阳",
})

6. 批量操作

batch := 10
_, err := db.Insert(ctx, "user", gdb.List {
    {"name": "小明"},
    {"name": "小华"},
    {"name": "小军"},
    {"name": "小高"},
}, batch)

tips

1. 其中batch参数用于指定批量操作中分批写入条数数量（默认是10）。

2. 表示批量写入数据时的每批次数量，这个数值跟你数据库服务器配置的SQL BufferSize数值有关。

7. 数据更新/删除

// db.Update/db.Delete 同理
// UPDATE `user` SET `name`='王中阳' WHERE `id`=10000
r, err := db.Update(ctx, "user", gdb.Map {"name": "王中阳"}, "id=?", 10000)
// UPDATE `user` SET `name`='王中阳' WHERE `id`=10000
r, err := db.Update(ctx, "user", "name='王中阳'", "id=10000")
// UPDATE `user` SET `name`='王中阳' WHERE `id`=10000
r, err := db.Update(ctx, "user", "name=?", "id=?", "王中阳", 10000)

tips

参数建议使用?占位符进行输入，避免SQL注入风险。

总结

虽然GoFrame的ORM链式操作非常简单且强大，但是业务中总还是有一些逻辑需要使用原生方法实现，化繁为简。

最后

感谢阅读，欢迎大家三连：点赞、收藏、投币（关注）！！！