对象信息-gstructs

基本介绍

gstructs组件用于方便获取结构体的相关信息。

这是一个偏底层组件，一般业务上很少会用到，在框架、基础库、中间件编写中用到。

使用方式：

import "github.com/gogf/gf/v2/os/gstructs"

接口文档：

https://pkg.go.dev/github.com/gogf/gf/v2/os/gstructs

常用方法

Fields

• 说明：Fields 将输入参数in的 Pointer 属性的字段以Field切片的形式返回。

• 格式：

Fields(in FieldsInput) ([]Field, error)

• 示例：

func main() {
    type User struct {
        Id   int
        Name string `params:"name"`
        Pass string `my-tag1:"pass1" my-tag2:"pass2" params:"pass"`
    }
    var user *User
    fields, _ := gstructs.Fields(gstructs.FieldsInput{
        Pointer:         user,
        RecursiveOption: 0,
    })

    g.Dump(fields)
}

// Output:
[
    {
        Value:    "<int Value>",
        Field:    {
            Name:      "Id",
            PkgPath:   "",
            Type:      "int",
            Tag:       "",
            Offset:    0,
            Index:     [
                0,
            ],
            Anonymous: false,
        },
        TagValue: "",
    },
    {
        Value:    {},
        Field:    {
            Name:      "Name",
            PkgPath:   "",
            Type:      "string",
            Tag:       "params:\"name\"",
            Offset:    8,
            Index:     [
                1,
            ],
            Anonymous: false,
        },
        TagValue: "",
    },
    {
        Value:    {},
        Field:    {
            Name:      "Pass",
            PkgPath:   "",
            Type:      "string",
            Tag:       "my-tag1:\"pass1\" my-tag2:\"pass2\" params:\"pass\"",
            Offset:    24,
            Index:     [
                2,
            ],
            Anonymous: false,
        },
        TagValue: "",
    },
]

TagMapName

• 说明：TagMapName从参数pointer中检索tag，并以map[string]string的形式返回。

• 注意：

  • 参数pointer的类型应该是 struct/*struct。
  • 只会返回可导出的字段(首字母大写的字段)。
  • 格式：

TagMapName(pointer interface{}, priority []string) (map[string]string, error)

• 示例：

func main() {
    type User struct {
        Id   int
        Name string `params:"name"`
        Pass string `my-tag1:"pass1" my-tag2:"pass2" params:"pass"`
    }
    var user User
    m, _ := gstructs.TagMapName(user, []string{"params"})

    g.Dump(m)
}

// Output:
{
    "name": "Name",
    "pass": "Pass",
}