GoFrame 类型转换-Map转换

​gconv.Map​支持将任意的​map​或​struct/*struct​类型转换为常用的 ​map[string]interface{}​ 类型。当转换参数为​struct/*struct​类型时，支持自动识别​struct​的 ​c/gconv/json​ 标签，并且可以通过​Map​方法的第二个参数​tags​指定自定义的转换标签，以及多个标签解析的优先级。如果转换失败，返回​nil​。

属性标签：当转换​struct/*struct​类型时，支持 ​c/gconv/jso​n 属性标签，也支持 ​-​及​omitempty标签属性。当使用 ​-​ 标签属性时，表示该属性不执行转换；当使用 ​omitempty标签属性时，表示当属性为空时（空指针​nil​, 数字​0​, 字符串​""​, 空数组​[]​等）不执行转换。

常用转换方法：

func Map(value interface{}, tags ...string) map[string]interface{}
func MapDeep(value interface{}, tags ...string) map[string]interface{}

其中，​MapDeep​支持递归转换，即会递归转换属性中的​struct/*struct​对象。

更多的map相关转换方法请参考接口文档：https://pkg.go.dev/github.com/gogf/gf/v2/util/gconv

基本示例

package main

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

func main() {
 type User struct {
  Uid  int    `c:"uid"`
  Name string `c:"name"`
 }
 // 对象
 g.Dump(gconv.Map(User{
  Uid:  1,
  Name: "john",
 }))
 // 对象指针
 g.Dump(gconv.Map(&User{
  Uid:  1,
  Name: "john",
 }))

 // 任意map类型
 g.Dump(gconv.Map(map[int]int{
  100: 10000,
 }))
}

执行后，终端输出：

{
    "name": "john",
    "uid": 1
}

{
    "name": "john",
    "uid": 1
}

{
    "100": 10000
}

属性标签

我们可以通过​c/gconv/json标签来自定义转换后的​map​键名，当多个标签存在时，按照​gconv/c/json​的标签顺序进行优先级识别。

package main

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

func main() {
 type User struct {
  Uid      int
  Name     string `c:"-"`
  NickName string `c:"nickname, omitempty"`
  Pass1    string `c:"password1"`
  Pass2    string `c:"password2"`
 }
 user := User{
  Uid:   100,
  Name:  "john",
  Pass1: "123",
  Pass2: "456",
 }
 g.Dump(gconv.Map(user))
}

执行后，终端输出：

{
    "Uid": 100,
    "password1": "123",
    "password2": "456"
}

自定义标签

此外，我们也可以给​struct​的属性自定义自己的标签名称，并在​map​转换时通过第二个参数指定标签优先级。

package main

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

func main() {
 type User struct {
  Id   int    `c:"uid"`
  Name string `my-tag:"nick-name" c:"name"`
 }
 user := &User{
  Id:   1,
  Name: "john",
 }
 g.Dump(gconv.Map(user, "my-tag"))
}

执行后，输出结果为：

{
 "nick-name": "john",
 "uid": 1
}

递归转换

当参数为​map/struct/*struct​类型时，如果键值/属性为一个对象（或者对象指针）时，并且不是​embedded​结构体且没有任何的别名标签绑定，​Map​方法将会将对象转换为结果的一个键值。我们可以使用​MapDeep​方法递归转换参数的子对象，即把属性也转换为​map​类型。我们来看个例子。

package main

import (
 "fmt"
 "github.com/gogf/gf/v2/frame/g"
 "github.com/gogf/gf/v2/util/gconv"
 "reflect"
)

func main() {
 type Base struct {
  Id   int    `c:"id"`
  Date string `c:"date"`
 }
 type User struct {
  UserBase Base   `c:"base"`
  Passport string `c:"passport"`
  Password string `c:"password"`
  Nickname string `c:"nickname"`
 }
 user := &User{
  UserBase: Base{
   Id:   1,
   Date: "2019-10-01",
  },
  Passport: "john",
  Password: "123456",
  Nickname: "JohnGuo",
 }
 m1 := gconv.Map(user)
 m2 := gconv.MapDeep(user)
 g.Dump(m1, m2)
 fmt.Println(reflect.TypeOf(m1["base"]))
 fmt.Println(reflect.TypeOf(m2["base"]))
}

执行后，终端输出结果为：

{
    "base": {
            "Id": 1,
            "Date": "2019-10-01"
    },
    "nickname": "JohnGuo",
    "passport": "john",
    "password": "123456"
}
{
    "base": {
            "date": "2019-10-01",
            "id": 1
    },
    "nickname": "JohnGuo",
    "passport": "john",
    "password": "123456"
}
main.Base
map[string]interface {}