Scan方法支持将查询结果转换为结构体或者结构体数组，Scan方法将会根据给定的参数类型自动识别执行的转换类型。

struct对象

Scan支持将查询结果转换为一个struct对象，查询结果应当是特定的一条记录，并且pointer参数应当为struct对象的指针地址（*struct或者**struct），使用方式例如：

type User struct {
    Id         int
    Passport   string
    Password   string
    NickName   string
    CreateTime *gtime.Time
}
user := User{}
g.Model("user").Where("id", 1).Scan(&user)

或者

var user = User{}
g.Model("user").Where("id", 1).Scan(&user)

前两种方式都是预先初始化对象（提前分配内存），推荐的方式：

var user *User
g.Model("user").Where("id", 1).Scan(&user)

这种方式只有在查询到数据的时候才会执行初始化及内存分配。注意在用法上的区别，特别是传递参数类型的差别（前两种方式传递的参数类型是*User，这里传递的参数类型其实是**User）。

struct数组

Scan支持将多条查询结果集转换为一个[]struct/[]*struct数组，查询结果应当是多条记录组成的结果集，并且pointer应当为数组的指针地址，使用方式例如：

var users []User
g.Model("user").Scan(&users)

或者

var users []*User
g.Model("user").Scan(&users)






















Content Menu

  • No labels

3 Comments

  1. 王一飞

    可不可以增加一个参数或者是函数来让Scan方法自动初始化切片？

    例如：

    type Response struct {
	Users []User `json:"users"`
}

type User struct {
	Id       uint   `json:"id"`
	Username string `json:"username"`
	Name     string `json:"name"`
}

var resp Response
dao.XXX.Ctx(ctx).AutoMakeSlice(0, 0).Scan(&resp.Users) // AutoMakeSlice的两个参数对应make函数的第二、第三参数

g.Dump(resp)
// output:
// {
//   "users": []
// }


    1. 郭强

      当没有数据的时候不会自动初始化的，若有问题请提issue。

      1. sudden3

        切片\数组不初始化的话转换json后是null而不是空数组