开箱体验
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
- 其中
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)
tips
参数建议使用?占位符进行输入，避免SQL注入风险。
总结
虽然GoFrame的ORM链式操作非常简单且强大，但是业务中总还是有一些逻辑需要使用原生方法实现，化繁为简。
