一、数据结构

查询结果的数据结构如下:

  1. type Value = *gvar.Var // 返回数据表记录值
  2. type Record map[string]Value // 返回数据表记录键值对
  3. type Result []Record // 返回数据表记录列表
  1. Value/Record/Result用于ORM操作的结果数据类型。
  2. Result表示数据表记录列表,Record表示一条数据表记录,Value表示记录中的一条键值数据。
  3. Value*gvar.Var类型的别名类型,方便于后续的数据类型转换。

二、Record数据记录

接口文档: https://pkg.go.dev/github.com/gogf/gf/v2/database/gdb

gdb为数据表记录操作提供了极高的灵活性和简便性,除了支持以map的形式访问/操作数据表记录以外,也支持将数据表记录转换为struct进行处理。我们以下使用一个简单的示例来演示该特性。

首先,我们的用户表结构是这样的(简单设计的示例表):

  1. CREATE TABLE `user` (
  2. `uid` int(10) unsigned NOT NULL AUTO_INCREMENT,
  3. `name` varchar(30) NOT NULL DEFAULT '' COMMENT '昵称',
  4. `site` varchar(255) NOT NULL DEFAULT '' COMMENT '主页',
  5. PRIMARY KEY (`uid`)
  6. ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

其次,我们的表数据如下:

  1. uid name site
  2. 1 john https://goframe.org

最后,我们的示例程序如下:

  1. package main
  2. import (
  3. "github.com/gogf/gf/v2/frame/g"
  4. "github.com/gogf/gf/v2/os/gctx"
  5. )
  6. type User struct {
  7. Uid int
  8. Name string
  9. }
  10. func main() {
  11. var (
  12. user *User
  13. ctx = gctx.New()
  14. )
  15. err := g.DB().Model("user").Where("uid", 1).Scan(&user)
  16. if err != nil {
  17. g.Log().Header(false).Fatal(ctx, err)
  18. }
  19. if user != nil {
  20. g.Log().Header(false).Print(ctx, user)
  21. }
  22. }

执行后,输出结果为:

  1. {"Uid":1,"Name":"john"}

这里,我们自定义了一个struct,里面只包含了UidName属性,可以看到它的属性并不和数据表的字段一致,这也是ORM灵活的特性之一:支持指定属性获取。

通过gdb.Model.Scan方法可以将查询到的数据记录转换为struct对象或者struct对象数组。由于这里传递的参数为&user**User类型,那么将会转换为一个struct对象,如果传递为[]*User类型的参数,将会转换为数组结果,请查看后续示例。具体方法介绍请查看链式操作章节。

属性字段映射规则:

需要注意的是,map中的键名为uid,name,site,而struct中的属性为Uid,Name,那么他们之间是如何执行映射的呢?主要是以下几点简单的规则:

  1. struct中需要匹配的属性必须为公开属性(首字母大写);
  2. 记录结果中键名会自动按照 不区分大小写忽略-/_/空格符号 的形式与struct属性进行匹配;
  3. 如果匹配成功,那么将键值赋值给属性,如果无法匹配,那么忽略该键值;

以下是几个匹配的示例:

  1. 记录键名 struct属性 是否匹配
  2. name Name match
  3. Email Email match
  4. nickname NickName match
  5. NICKNAME NickName match
  6. Nick-Name NickName match
  7. nick_name NickName match
  8. nick_name Nick_Name match
  9. NickName Nick_Name match
  10. Nick-Name Nick_Name match

由于数据库结果集转struct的底层是依靠gconv.Struct方法实现的,因此如果想要实现自定义的属性转换,以及更详细的映射规则说明,请参考 类型转换-Struct转换 章节。

三、Result数据集合

Result/Record数据类型根据数据结果集操作的需要,往往需要根据记录中特定的字段作为键名进行数据检索,因此它包含多个用于转换Map/List的方法,同时也包含了常用数据结构JSON/XML的转换方法。

接口文档: https://pkg.go.dev/github.com/gogf/gf/v2/database/gdb

由于方法比较简单,这里便不再举例说明。需要注意的是两个方法Record.MapResult.List,这两个方法也是使用比较频繁的方法,用以将ORM查询结果信息转换为可做展示的数据类型。由于结果集字段值底层为[]byte类型,虽然使用了新的Value类型做了封装,并且也提供了数十种常见的类型转换方法(具体请阅读 泛型类型-gvar 章节),但是大多数时候需要直接将结果Result或者Record直接作为json或者xml数据结构返回,就需要做转换才行。

使用示例:

  1. package main
  2. import (
  3. "database/sql"
  4. "github.com/gogf/gf/v2/frame/g"
  5. "github.com/gogf/gf/v2/os/gctx"
  6. )
  7. type User struct {
  8. Uid int
  9. Name string
  10. Site string
  11. }
  12. func main() {
  13. var (
  14. user []*User
  15. ctx = gctx.New()
  16. )
  17. err := g.DB().Model("user").Where("uid", 1).Scan(&user)
  18. if err != nil && err != sql.ErrNoRows {
  19. g.Log().Header(false).Fatal(ctx, err)
  20. }
  21. if user != nil {
  22. g.Log().Header(false).Print(ctx, user)
  23. }
  24. }

执行后,输出结果为:

  1. [{"Uid":1,"Name":"john","Site":"https://goframe.org"}]