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

struct对象

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

  1. type User struct {
  2. Id int
  3. Passport string
  4. Password string
  5. NickName string
  6. CreateTime *gtime.Time
  7. }
  8. user := User{}
  9. g.Model("user").Where("id", 1).Scan(&user)

或者

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

前两种方式都是预先初始化对象(提前分配内存),推荐的方式:

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

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

struct数组

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

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

或者

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