GoFrame框架gconv.Scan自动类型转换实战

Scan方法的核心原理

GoFrame的 gconv.Scan 方法是一个通用转换入口，它会根据传入的目标指针（pointer）的类型，自动调用内部对应的转换函数：

• 若目标是 *map，则调用 MapToMap；
• 若目标是 *[]map 或 *[]*map，则调用 MapToMaps；
• 若目标是 *struct 或 **struct，则调用 Struct；
• 若目标是 *[]struct 或 *[]*struct，则调用 Structs。

此外，该方法还支持通过 mapping 参数映射键名差异，处理字段名称不一致的情况。

第1步：自动识别转换单个Struct结构体

目的：将包含字段的Map对象转换为对应的Struct结构体实例。

操作：定义目标Struct，准备源Map数据，调用Scan方法并将结果指针传入。

package main
import (
    "github.com/gogf/gf/frame/g"
    "github.com/gogf/gf/util/gconv"
)

func main() {
    type User struct {
        Uid  int
        Name string
    }
    params := g.Map{
        "uid":  1,
        "name": "王中阳",
    }
    var user *User
    // 关键：传入的是结构体指针的地址 &user
    if err := gconv.Scan(params, &user); err != nil {
        panic(err)
    }
    g.Dump(user)
}

运行结果展示如下：

第2步：自动识别转换Struct指针数组

目的：将多个Map组成的Slice转换为 []*User 指针切片，常用于处理列表数据。

操作：初始化源数据为 g.Slice，目标变量声明为 *[]*User。

package main
import (
    "github.com/gogf/gf/frame/g"
    "github.com/gogf/gf/util/gconv"
)

func main() {
    type User struct {
        Uid  int
        Name string
    }
    params := g.Slice{
        g.Map{
            "uid":  1,
            "name": "优弧",
        },
        g.Map{
            "uid":  2,
            "name": "船长",
        },
    }
    var users []*User
    // 注意：这里需要取地址，即 &users
    if err := gconv.Scan(params, &users); err != nil {
        panic(err)
    }
    g.Dump(users)
}

运行结果展示如下：

第3步：自动识别转换Map对象

目的：将源数据转换为字符串Key类型的Map，适用于动态键值的场景。

操作：定义 map[string]string 类型变量，传入源Map进行转换。

package main
import (
    "github.com/gogf/gf/frame/g"
    "github.com/gogf/gf/util/gconv"
)

func main() {
    var (
        user   map[string]string
        params = g.Map{
            "uid":  1,
            "name": "王中阳",
        }
    )
    // 直接传入 map 的指针
    if err := gconv.Scan(params, &user); err != nil {
        panic(err)
    }
    g.Dump(user)
}

运行结果展示如下：

第4步：自动识别转换Map数组

目的：将多个Map集合转换为 []map[string]string 切片。

操作：类似于Struct数组的处理方式，注意指针传递的正确性。

package main
import (
    "github.com/gogf/gf/frame/g"
    "github.com/gogf/gf/util/gconv"
)

func main() {
    var (
        users  []map[string]string
        params = g.Slice{
            g.Map{
                "uid":  1,
                "name": "优弧",
            },
            g.Map{
                "uid":  2,
                "name": "船长",
            },
        }
    )
    // 直接传入切片的指针
    if err := gconv.Scan(params, &users); err != nil {
        panic(err)
    }
    g.Dump(users)
}

运行结果展示如下：

总结

GoFrame的 gconv.Scan 提供了极大的灵活性，开发者只需关注源数据和目标类型的定义，无需手动编写复杂的转换逻辑。无论是JSON反序列化后的数据处理，还是表单提交参数的结构化，该方法都能高效完成任务。以上就是GoFrame框架Scan类型转换实例的详细内容，更多关于GoFrame框架Scan类型转的资料请关注本站其它相关文章！