GoFrame框架ORM原生方法对象操作开箱体验

2024-04-02 19:04:59 292人浏览独家记忆

摘要

目录前言开箱体验1. ORM对象tips2. 数据写入3. 数据查询(单条)4. 数据查询(列表)5. 数据保存6. 批量操作tips7. 数据更新/删除tips总结前言

前言

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

之前整理过结构体和JSON转换的文章：GoFrame必知必会之Scan：类型转换，今天整理同样比较重要的ORM相关的文章。

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

上一篇文章整理了ORM的原生方法，这篇文章根据整理的原生方法整理对应的开箱体验。

开箱体验

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 &gt; ? 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

其中batch参数用于指定批量操作中分批写入条数数量（默认是10）。
表示批量写入数据时的每批次数量，这个数值跟你数据库服务器配置的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)