GO: reflect包

在 reflect 包中,主要通过两个函数 TypeOf() 和 ValueOf() 实现反射,TypeOf() 获取到的结果是 reflect.Type 类型,ValueOf() 获取到的结果是 reflect.Value 类型,这两种类型都有很多方法可以进一步获取相关的反射信息。

这里有一个函数,可以获取指定对象的所有字段和方法:

// 获取一个对象的字段和方法
package main

import (
    "fmt"
    "reflect"
)

// 获取一个对象的字段和方法
func GetMembers(i interface{}) {
    // 获取 i 的类型信息
    t := reflect.TypeOf(i)

    for {
        // 进一步获取 i 的类别信息
        if t.Kind() == reflect.Struct {
            // 只有结构体可以获取其字段信息
            fmt.Printf("\n%-8v %v 个字段:\n", t, t.NumField())
            // 进一步获取 i 的字段信息
            for i := 0; i < t.NumField(); i++ {
                fmt.Println(t.Field(i).Name)
            }
        }
        // 任何类型都可以获取其方法信息
        fmt.Printf("\n%-8v %v 个方法:\n", t, t.NumMethod())
        // 进一步获取 i 的方法信息
        for i := 0; i < t.NumMethod(); i++ {
            fmt.Println(t.Method(i).Name)
        }
        if t.Kind() == reflect.Ptr {
            // 如果是指针,则获取其所指向的元素
            t = t.Elem()
        } else {
            // 否则上面已经处理过了,直接退出循环
            break
        }
    }
}

// 定义一个结构体用来进行测试
type sr struct {
    string
}

// 接收器为实际类型
func (s sr) Read() {
}

// 接收器为指针类型
func (s *sr) Write() {
}

func main() {
    // 测试
    GetMembers(&sr{})
}

/* 测试结果(可以读取私有字段):
*main.sr 2 个方法:
Read
Write

main.sr  1 个字段:
string

main.sr  1 个方法:
Read
*/

我们可以通过下面的代码获取 reflect.Type 的所有方法,以便进行学习:

// 通用

// 获取 t 类型的字符串描述,不要通过 String 来判断两种类型是否一致。
func (t *rtype) String() string

// 获取 t 类型在其包中定义的名称,未命名类型则返回空字符串。
func (t *rtype) Name() string

// 获取 t 类型所在包的名称,未命名类型则返回空字符串。
func (t *rtype) PkgPath() string

// 获取 t 类型的类别。
func (t *rtype) Kind() reflect.Kind

// 获取 t 类型的值在分配内存时的大小,功能和 unsafe.SizeOf 一样。
func (t *rtype) Size() uintptr

// 获取 t 类型的值在分配内存时的字节对齐值。
func (t *rtype) Align() int

// 获取 t 类型的值作为结构体字段时的字节对齐值。
func (t *rtype) FieldAlign() int

// 获取 t 类型的方法数量。
func (t *rtype) NumMethod() int

// 根据索引获取 t 类型的方法,如果方法不存在,则 panic。
// 如果 t 是一个实际的类型,则返回值的 Type 和 Func 字段会列出接收者。
// 如果 t 只是一个接口,则返回值的 Type 不列出接收者,Func 为空值。
func (t *rtype) Method() reflect.Method

// 根据名称获取 t 类型的方法。
func (t *rtype) MethodByName(string) (reflect.Method, bool)

// 判断 t 类型是否实现了 u 接口。
func (t *rtype) Implements(u reflect.Type) bool

// 判断 t 类型的值可否转换为 u 类型。
func (t *rtype) ConvertibleTo(u reflect.Type) bool

// 判断 t 类型的值可否赋值给 u 类型。
func (t *rtype) AssignableTo(u reflect.Type) bool

// 判断 t 类型的值可否进行比较操作
func (t *rtype) Comparable() bool
// 示例
type inf interface {
    Method1()
    Method2()
}

type ss struct {
    a func()
}

func (i ss) Method1() {}
func (i ss) Method2() {}

func main() {
    s := reflect.TypeOf(ss{})
    i := reflect.TypeOf(new(inf)).Elem()

    Test(s)
    Test(i)
}

func Test(t reflect.Type) {
    if t.NumMethod() > 0 {
        fmt.Printf("\n--- %s ---\n", t)
        fmt.Println(t.Method(0).Type)
        fmt.Println(t.Method(0).Func.String())
    }
}

// 输出结果:
// --- main.ss ---
// func(main.ss)
// 
//
// --- main.inf ---
// func()
// 
// 数值

// 获取数值类型的位宽,t 必须是整型、浮点型、复数型
func (t *rtype) Bits() int
// 数组

// 获取数组的元素个数
func (t *rtype) Len() int
// 映射

// 获取映射的键类型
func (t *rtype) Key() reflect.Type
// 通道

// 获取通道的方向
func (t *rtype) ChanDir() reflect.ChanDir
// 结构体

// 获取字段数量
func (t *rtype) NumField() int

// 根据索引获取字段
func (t *rtype) Field(int) reflect.StructField

// 根据名称获取字段
func (t *rtype) FieldByName(string) (reflect.StructField, bool)

// 根据指定的匹配函数 math 获取字段
func (t *rtype) FieldByNameFunc(match func(string) bool) (reflect.StructField, bool)

// 根据索引链获取嵌套字段
func (t *rtype) FieldByIndex(index []int) reflect.StructField
// 函数

// 获取函数的参数数量
func (t *rtype) NumIn() int

// 根据索引获取函数的参数信息
func (t *rtype) In(int) reflect.Type

// 获取函数的返回值数量
func (t *rtype) NumOut() int

// 根据索引获取函数的返回值信息
func (t *rtype) Out(int) reflect.Type

// 判断函数是否具有可变参数。
// 如果有可变参数,则 t.In(t.NumIn()-1) 将返回一个切片。
func (t *rtype) IsVariadic() bool
// 数组、切片、映射、通道、指针、接口

// 获取元素类型、获取指针所指对象类型,获取接口的动态类型
func (t *rtype) Elem() reflect.Type

下面的代码用到了所有这些方法:

// 获取各种类型的相关信息
package main

import (
    "fmt"
    "reflect"
    "unsafe"
)

// 嵌套结构体
type ss struct {
    a struct {
        int
        string
    }
    int
    string
    bool
    float64
}

func (s ss) Method1(i int) string  { return "结构体方法1" }
func (s *ss) Method2(i int) string { return "结构体方法2" }

var (
    intValue   = int(0)
    int8Value  = int8(8)
    int16Value = int16(16)
    int32Value = int32(32)
    int64Value = int64(64)

    uIntValue   = uint(0)
    uInt8Value  = uint8(8)
    uInt16Value = uint16(16)
    uInt32Value = uint32(32)
    uInt64Value = uint64(64)

    byteValue    = byte(0)
    runeValue    = rune(0)
    uintptrValue = uintptr(0)

    boolValue   = false
    stringValue = ""

    float32Value = float32(32)
    float64Value = float64(64)

    complex64Value  = complex64(64)
    complex128Value = complex128(128)

    arrayValue  = [5]string{}           // 数组
    sliceValue  = []byte{0, 0, 0, 0, 0} // 切片
    mapValue    = map[string]int{}      // 映射
    chanValue   = make(chan int, 2)     // 通道
    structValue = ss{                   // 结构体
        struct {
            int
            string
        }{10, "子结构体"},
        20,
        "结构体",
        false,
        64.0,
    }

    func1Value = func(a, b, c int) string { // 函数(固定参数)
        return fmt.Sprintf("固定参数:%v %v %v", a, b, c)
    }

    func2Value = func(a, b int, c ...int) string { // 函数(动态参数)
        return fmt.Sprintf("动态参数:%v %v %v", a, b, c)
    }

    unsafePointer     = unsafe.Pointer(&structValue)    // 通用指针
    reflectType       = reflect.TypeOf(0)               // 反射类型
    reflectValue      = reflect.ValueOf(0)              // 反射值
    reflectArrayValue = reflect.ValueOf([]int{1, 2, 3}) // 切片反射值
    // 反射接口类型
    interfaceType = reflect.TypeOf(new(interface{})).Elem()
)

// 简单类型
var simpleTypes = []interface{}{
    intValue, &intValue, // int
    int8Value, &int8Value, // int8
    int16Value, &int16Value, // int16
    int32Value, &int32Value, // int32
    int64Value, &int64Value, // int64
    uIntValue, &uIntValue, // uint
    uInt8Value, &uInt8Value, // uint8
    uInt16Value, &uInt16Value, // uint16
    uInt32Value, &uInt32Value, // uint32
    uInt64Value, &uInt64Value, // uint64
    byteValue, &byteValue, // byte
    runeValue, &runeValue, // rune
    uintptrValue, &uintptrValue, // uintptr
    boolValue, &boolValue, // bool
    stringValue, &stringValue, // string
    float32Value, &float32Value, // float32
    float64Value, &float64Value, // float64
    complex64Value, &complex64Value, // complex64
    complex128Value, &complex128Value, // complex128
}

// 复杂类型
var complexTypes = []interface{}{
    arrayValue, &arrayValue, // 数组
    sliceValue, &sliceValue, // 切片
    mapValue, &mapValue, // 映射
    chanValue, &chanValue, // 通道
    structValue, &structValue, // 结构体
    func1Value, &func1Value, // 定参函数
    func2Value, &func2Value, // 动参函数
    structValue.Method1, structValue.Method2, // 方法
    unsafePointer, &unsafePointer, // 指针
    reflectType, &reflectType, // 反射类型
    reflectValue, &reflectValue, // 反射值
    interfaceType, &interfaceType, // 接口反射类型
}

// 空值
var unsafeP unsafe.Pointer

// 空接口
var nilInterfece interface{}

func main() {
    // 测试简单类型
    for i := 0; i < len(simpleTypes); i++ {
        PrintInfo(simpleTypes[i])
    }
    // 测试复杂类型
    for i := 0; i < len(complexTypes); i++ {
        PrintInfo(complexTypes[i])
    }
    // 测试单个对象
    PrintInfo(unsafeP)
    PrintInfo(&unsafeP)
    PrintInfo(nilInterfece)
    PrintInfo(&nilInterfece)
}

func PrintInfo(i interface{}) {
    if i == nil {
        fmt.Println("--------------------")
        fmt.Printf("无效接口值:%v\n", i)
        return
    }
    t := reflect.TypeOf(i)
    PrintType(t)
}

func PrintType(t reflect.Type) {
    fmt.Println("--------------------")
    // ----- 通用方法 -----
    fmt.Println("String             :", t.String())     // 类型字符串
    fmt.Println("Name               :", t.Name())       // 类型名称
    fmt.Println("PkgPath            :", t.PkgPath())    // 所在包名称
    fmt.Println("Kind               :", t.Kind())       // 所属分类
    fmt.Println("Size               :", t.Size())       // 内存大小
    fmt.Println("Align              :", t.Align())      // 字节对齐
    fmt.Println("FieldAlign         :", t.FieldAlign()) // 字段对齐
    fmt.Println("NumMethod          :", t.NumMethod())  // 方法数量
    if t.NumMethod() > 0 {
        i := 0
        for ; i < t.NumMethod()-1; i++ {
            fmt.Println("    ┣", t.Method(i).Name) // 通过索引定位方法
        }
        fmt.Println("    ┗", t.Method(i).Name) // 通过索引定位方法
    }
    if sm, ok := t.MethodByName("String"); ok { // 通过名称定位方法
        fmt.Println("MethodByName       :", sm.Index, sm.Name)
    }
    fmt.Println("Implements(i{})    :", t.Implements(interfaceType))  // 是否实现了指定接口
    fmt.Println("ConvertibleTo(int) :", t.ConvertibleTo(reflectType)) // 是否可转换为指定类型
    fmt.Println("AssignableTo(int)  :", t.AssignableTo(reflectType))  // 是否可赋值给指定类型的变量
    fmt.Println("Comparable         :", t.Comparable())               // 是否可进行比较操作
    // ----- 特殊类型 -----
    switch t.Kind() {
    // 指针型:
    case reflect.Ptr:
        fmt.Println("=== 指针型 ===")
        // 获取指针所指对象
        t = t.Elem()
        fmt.Printf("转换到指针所指对象 : %v\n", t.String())
        // 递归处理指针所指对象
        PrintType(t)
        return
    // 自由指针型:
    case reflect.UnsafePointer:
        fmt.Println("=== 自由指针 ===")
        // ...
    // 接口型:
    case reflect.Interface:
        fmt.Println("=== 接口型 ===")
        // ...
    }
    // ----- 简单类型 -----
    // 数值型:
    if reflect.Int <= t.Kind() && t.Kind() <= reflect.Complex128 {
        fmt.Println("=== 数值型 ===")
        fmt.Println("Bits               :", t.Bits()) // 位宽
    }
    // ----- 复杂类型 -----
    switch t.Kind() {
    // 数组型:
    case reflect.Array:
        fmt.Println("=== 数组型 ===")
        fmt.Println("Len                :", t.Len())  // 数组长度
        fmt.Println("Elem               :", t.Elem()) // 数组元素类型
    // 切片型:
    case reflect.Slice:
        fmt.Println("=== 切片型 ===")
        fmt.Println("Elem               :", t.Elem()) // 切片元素类型
    // 映射型:
    case reflect.Map:
        fmt.Println("=== 映射型 ===")
        fmt.Println("Key                :", t.Key())  // 映射键
        fmt.Println("Elem               :", t.Elem()) // 映射值类型
    // 通道型:
    case reflect.Chan:
        fmt.Println("=== 通道型 ===")
        fmt.Println("ChanDir            :", t.ChanDir()) // 通道方向
        fmt.Println("Elem               :", t.Elem())    // 通道元素类型
    // 结构体:
    case reflect.Struct:
        fmt.Println("=== 结构体 ===")
        fmt.Println("NumField           :", t.NumField()) // 字段数量
        if t.NumField() > 0 {
            var i, j int
            // 遍历结构体字段
            for i = 0; i < t.NumField()-1; i++ {
                field := t.Field(i) // 获取结构体字段
                fmt.Printf("    ├ %v\n", field.Name)
                // 遍历嵌套结构体字段
                if field.Type.Kind() == reflect.Struct && field.Type.NumField() > 0 {
                    for j = 0; j < field.Type.NumField()-1; j++ {
                        subfield := t.FieldByIndex([]int{i, j}) // 获取嵌套结构体字段
                        fmt.Printf("    │    ├ %v\n", subfield.Name)
                    }
                    subfield := t.FieldByIndex([]int{i, j}) // 获取嵌套结构体字段
                    fmt.Printf("    │    └ %%v\n", subfield.Name)
                }
            }
            field := t.Field(i) // 获取结构体字段
            fmt.Printf("    └ %v\n", field.Name)
            // 通过名称查找字段
            if field, ok := t.FieldByName("ptr"); ok {
                fmt.Println("FieldByName(ptr)   :", field.Name)
            }
            // 通过函数查找字段
            if field, ok := t.FieldByNameFunc(func(s string) bool { return len(s) > 3 }); ok {
                fmt.Println("FieldByNameFunc    :", field.Name)
            }
        }
    // 函数型:
    case reflect.Func:
        fmt.Println("=== 函数型 ===")
        fmt.Println("IsVariadic         :", t.IsVariadic()) // 是否具有变长参数
        fmt.Println("NumIn              :", t.NumIn())      // 参数数量
        if t.NumIn() > 0 {
            i := 0
            for ; i < t.NumIn()-1; i++ {
                fmt.Println("    ┣", t.In(i)) // 获取参数类型
            }
            fmt.Println("    ┗", t.In(i)) // 获取参数类型
        }
        fmt.Println("NumOut             :", t.NumOut()) // 返回值数量
        if t.NumOut() > 0 {
            i := 0
            for ; i < t.NumOut()-1; i++ {
                fmt.Println("    ┣", t.Out(i)) // 获取返回值类型
            }
            fmt.Println("    ┗", t.Out(i)) // 获取返回值类型
        }
    }
}

接下来学习 reflect.Value 的所有方法,还是进行分类学习,这里的很多操作(比如取地址、取切片、修改映射、通道进出、取值、赋值、函数调用等)和平时的操作都一样,只不过在这里需要用各种方法来操作,而平时只需要用一些符号来操作。

注意:下面描述的 v 值是指 reflect.Value 所代表的实际值,而不是 reflect.Value 本身。

// 特殊

// 判断 v 值是否可寻址
// 1、指针的 Elem() 可寻址
// 2、切片的元素可寻址
// 3、可寻址数组的元素可寻址
// 4、可寻址结构体的字段可寻址,方法不可寻址
// 也就是说,如果 v 值是指向数组的指针“&数组”,通过 v.Elem() 获取该指针指向的数组,那么
// 该数组就是可寻址的,同时该数组的元素也是可寻址的,如果 v 就是一个普通数组,不是通过解引
// 用得到的数组,那么该数组就不可寻址,其元素也不可寻址。结构体亦然。
func (v Value) CanAddr() bool

// 获取 v 值的地址,相当于 & 取地址操作。v 值必须可寻址。
func (v Value) Addr() reflect.Value

// 判断 v 值是否可以被修改。只有可寻址的 v 值可被修改。
// 结构体中的非导出字段(通过 Field() 等方法获取的)不能修改,所有方法不能修改。
func (v Value) CanSet() bool

// 判断 v 值是否可以转换为接口类型
// 结构体中的非导出字段(通过 Field() 等方法获取的)不能转换为接口类型
func (v Value) CanInterface() bool

// 将 v 值转换为空接口类型。v 值必须可转换为接口类型。
func (v Value) Interface() interface{}

// 使用一对 uintptr 返回接口的数据
func (v Value) InterfaceData() [2]uintptr
// 示例:
type ss struct {
    A int
    a int
}

func (s ss) Method1(i int) string  { return "结构体方法1" }
func (s *ss) Method2(i int) string { return "结构体方法2" }

func main() {
    v1 := reflect.ValueOf(ss{})                   // 结构体
    v2 := reflect.ValueOf(&ss{})                  // 结构体指针
    v3 := reflect.ValueOf(&ss{}).Elem()           // 可寻址结构体
    v4 := reflect.ValueOf(&ss{}).Elem().Field(0)  // 可寻址结构体的共有字段
    v5 := reflect.ValueOf(&ss{}).Elem().Field(1)  // 可寻址结构体的私有字段
    v6 := reflect.ValueOf(&ss{}).Method(0)        // 结构体指针的方法
    v7 := reflect.ValueOf(&ss{}).Elem().Method(0) // 结构体的方法

    fmt.Println(v1.CanAddr()) // false
    fmt.Println(v2.CanAddr()) // false
    fmt.Println(v3.CanAddr()) // true
    fmt.Println(v4.CanAddr()) // true
    fmt.Println(v5.CanAddr()) // true
    fmt.Println(v6.CanAddr()) // false
    fmt.Println(v7.CanAddr()) // false
    fmt.Println("----------")
    fmt.Println(v1.CanSet()) // false
    fmt.Println(v2.CanSet()) // false
    fmt.Println(v3.CanSet()) // true
    fmt.Println(v4.CanSet()) // true
    fmt.Println(v5.CanSet()) // false
    fmt.Println(v6.CanSet()) // false
    fmt.Println(v6.CanSet()) // false
    fmt.Println("----------")
    fmt.Println(v1.CanInterface()) // true
    fmt.Println(v2.CanInterface()) // true
    fmt.Println(v3.CanInterface()) // true
    fmt.Println(v4.CanInterface()) // true
    fmt.Println(v5.CanInterface()) // false
    fmt.Println(v6.CanInterface()) // true
    fmt.Println(v7.CanInterface()) // true
}
// 指针

// 将 v 值转换为 uintptr 类型,v 值必须是切片、映射、通道、函数、指针、自由指针。
func (v Value) Pointer() uintptr

// 获取 v 值的地址。v 值必须是可寻址类型(CanAddr)。
func (v Value) UnsafeAddr() uintptr

// 将 UnsafePointer 类别的 v 值修改为 x,v 值必须是 UnsafePointer 类别,必须可修改。
func (v Value) SetPointer(x unsafe.Pointer)

// 判断 v 值是否为 nil,v 值必须是切片、映射、通道、函数、接口、指针。
// IsNil 并不总等价于 Go 的潜在比较规则,比如对于 var i interface{},i == nil 将返回
// true,但是 reflect.ValueOf(i).IsNil() 将 panic。
func (v Value) IsNil() bool

// 获取“指针所指的对象”或“接口所包含的对象”
func (v Value) Elem() reflect.Value
// 接口

// 获取“指针所指的对象”或“接口所包含的对象”
func (v Value) Elem() reflect.Value
// 通用

// 获取 v 值的字符串描述
func (v Value) String() string

// 获取 v 值的类型
func (v Value) Type() reflect.Type

// 返回 v 值的类别,如果 v 是空值,则返回 reflect.Invalid。
func (v Value) Kind() reflect.Kind

// 获取 v 的方法数量
func (v Value) NumMethod() int

// 根据索引获取 v 值的方法,方法必须存在,否则 panic
// 使用 Call 调用方法的时候不用传入接收者,Go 会自动把 v 作为接收者传入。
func (v Value) Method(int) reflect.Value

// 根据名称获取 v 值的方法,如果该方法不存在,则返回空值(reflect.Invalid)。
func (v Value) MethodByName(string) reflect.Value

// 判断 v 本身(不是 v 值)是否为零值。
// 如果 v 本身是零值,则除了 String 之外的其它所有方法都会 panic。
func (v Value) IsValid() bool

// 将 v 值转换为 t 类型,v 值必须可转换为 t 类型,否则 panic。
func (v Value) Convert(t Type) reflect.Value
// 示例
func main() {
    var v reflect.Value      // 未包含任何数据
    fmt.Println(v.IsValid()) // false

    var i *int
    v = reflect.ValueOf(i)   // 包含一个指针
    fmt.Println(v.IsValid()) // true

    v = reflect.ValueOf(nil) // 包含一个 nil 指针
    fmt.Println(v.IsValid()) // false

    v = reflect.ValueOf(0)   // 包含一个 int 数据
    fmt.Println(v.IsValid()) // true
}

// 获取

// 获取 v 值的内容,如果 v 值不是有符号整型,则 panic。
func (v Value) Int() int64

// 获取 v 值的内容,如果 v 值不是无符号整型(包括 uintptr),则 panic。
func (v Value) Uint() uint64

// 获取 v 值的内容,如果 v 值不是浮点型,则 panic。
func (v Value) Float() float64

// 获取 v 值的内容,如果 v 值不是复数型,则 panic。
func (v Value) Complex() complex128

// 获取 v 值的内容,如果 v 值不是布尔型,则 panic。
func (v Value) Bool() bool

// 获取 v 值的长度,v 值必须是字符串、数组、切片、映射、通道。
func (v Value) Len() int

// 获取 v 值的容量,v 值必须是数值、切片、通道。
func (v Value) Cap() int

// 获取 v 值的第 i 个元素,v 值必须是字符串、数组、切片,i 不能超出范围。
func (v Value) Index(i int) reflect.Value

// 获取 v 值的内容,如果 v 值不是字节切片,则 panic。
func (v Value) Bytes() []byte

// 获取 v 值的切片,切片长度 = j - i,切片容量 = v.Cap() - i。
// v 必须是字符串、数值、切片,如果是数组则必须可寻址。i 不能超出范围。
func (v Value) Slice(i, j int) reflect.Value

// 获取 v 值的切片,切片长度 = j - i,切片容量 = k - i。
// i、j、k 不能超出 v 的容量。i <= j <= k。
// v 必须是字符串、数值、切片,如果是数组则必须可寻址。i 不能超出范围。
func (v Value) Slice3(i, j, k int) reflect.Value

// 根据 key 键获取 v 值的内容,v 值必须是映射。
// 如果指定的元素不存在,或 v 值是未初始化的映射,则返回零值(reflect.ValueOf(nil))
func (v Value) MapIndex(key Value) reflect.Value

// 获取 v 值的所有键的无序列表,v 值必须是映射。
// 如果 v 值是未初始化的映射,则返回空列表。
func (v Value) MapKeys() []reflect.Value

// 判断 x 是否超出 v 值的取值范围,v 值必须是有符号整型。
func (v Value) OverflowInt(x int64) bool

// 判断 x 是否超出 v 值的取值范围,v 值必须是无符号整型。
func (v Value) OverflowUint(x uint64) bool

// 判断 x 是否超出 v 值的取值范围,v 值必须是浮点型。
func (v Value) OverflowFloat(x float64) bool

// 判断 x 是否超出 v 值的取值范围,v 值必须是复数型。
func (v Value) OverflowComplex(x complex128) bool
// 设置(这些方法要求 v 值必须可修改)

// 设置 v 值的内容,v 值必须是有符号整型。
func (v Value) SetInt(x int64)

// 设置 v 值的内容,v 值必须是无符号整型。
func (v Value) SetUint(x uint64)

// 设置 v 值的内容,v 值必须是浮点型。
func (v Value) SetFloat(x float64)

// 设置 v 值的内容,v 值必须是复数型。
func (v Value) SetComplex(x complex128)

// 设置 v 值的内容,v 值必须是布尔型。
func (v Value) SetBool(x bool)

// 设置 v 值的内容,v 值必须是字符串。
func (v Value) SetString(x string)

// 设置 v 值的长度,v 值必须是切片,n 不能超出范围,不能为负数。
func (v Value) SetLen(n int)

// 设置 v 值的内容,v 值必须是切片,n 不能超出范围,不能小于 Len。
func (v Value) SetCap(n int)

// 设置 v 值的内容,v 值必须是字节切片。x 可以超出 v 值容量。
func (v Value) SetBytes(x []byte)

// 设置 v 值的键和值,如果键存在,则修改其值,如果键不存在,则添加键和值。
// 如果将 val 设置为零值(reflect.ValueOf(nil)),则删除该键。
// 如果 v 值是一个未初始化的 map,则 panic。
func (v Value) SetMapIndex(key, val reflect.Value)

// 设置 v 值的内容,v 值必须可修改,x 必须可以赋值给 v 值。
func (v Value) Set(x reflect.Value)

// 结构体

// 获取 v 值的字段数量,v 值必须是结构体。
func (v Value) NumField() int

// 根据索引获取 v 值的字段,v 值必须是结构体。如果字段不存在则 panic。
func (v Value) Field(i int) reflect.Value

// 根据索引链获取 v 值的嵌套字段,v 值必须是结构体。
func (v Value) FieldByIndex(index []int) reflect.Value

// 根据名称获取 v 值的字段,v 值必须是结构体。
// 如果指定的字段不存在,则返回零值(reflect.ValueOf(nil))
func (v Value) FieldByName(string) reflect.Value

// 根据匹配函数 match 获取 v 值的字段,v 值必须是结构体。
// 如果没有匹配的字段,则返回零值(reflect.ValueOf(nil))
func (v Value) FieldByNameFunc(match func(string) bool) Value
// 示例
type ss struct {
    s struct {
        B int
        b int
    }
    A int
    a int
}

func main() {
    var v = reflect.ValueOf(ss{})
    for i := 0; i < v.NumField(); i++ {
        field := v.Field(i)
        fmt.Println("字段:", field.Type().String())
        if field.Type().Kind() == reflect.Struct {
            for j := 0; j < field.NumField(); j++ {
                subfield := field.Field(j)
                fmt.Println("    嵌套字段:", subfield.Type().String())
            }
        }
    }
}

// 输出结果:
// 字段: struct { B int; b int }
//     嵌套字段: int
//     嵌套字段: int
// 字段: int
// 字段: int
// 通道

// 发送数据(会阻塞),v 值必须是可写通道。
func (v Value) Send(x reflect.Value)

// 接收数据(会阻塞),v 值必须是可读通道。
func (v Value) Recv() (x reflect.Value, ok bool)

// 尝试发送数据(不会阻塞),v 值必须是可写通道。
func (v Value) TrySend(x reflect.Value) bool

// 尝试接收数据(不会阻塞),v 值必须是可读通道。
func (v Value) TryRecv() (x reflect.Value, ok bool)

// 关闭通道,v 值必须是通道。
func (v Value) Close()
// 示例
func main() {
    ch := make(chan int, 2)
    v := reflect.ValueOf(ch)

    a := reflect.ValueOf(1)
    b := reflect.ValueOf(2)

    v.Send(a)
    if ok := v.TrySend(b); ok {
        fmt.Println("尝试发送成功!") // 尝试发送成功!
    }
    if i, ok := v.Recv(); ok {
        fmt.Println("接收成功:", i) // 接收成功: 1
    }
    if i, ok := v.TryRecv(); ok {
        fmt.Println("尝试接收成功:", i) // 尝试接收成功: 2
    }
}
// 函数

// 通过参数列表 in 调用 v 值所代表的函数(或方法)。函数的返回值存入 r 中返回。
// 要传入多少参数就在 in 中存入多少元素。
// Call 即可以调用定参函数(参数数量固定),也可以调用变参函数(参数数量可变)。
func (v Value) Call(in []Value) (r []Value)

// 通过参数列表 in 调用 v 值所代表的函数(或方法)。函数的返回值存入 r 中返回。
// 函数指定了多少参数就在 in 中存入多少元素,变参作为一个单独的参数提供。
// CallSlice 只能调用变参函数。
func (v Value) CallSlice(in []Value) []Value
// 示例
var f1 = func(a int, b []int) { fmt.Println(a, b) }
var f2 = func(a int, b ...int) { fmt.Println(a, b) }

func main() {
    v1 := reflect.ValueOf(f1)
    v2 := reflect.ValueOf(f2)

    a := reflect.ValueOf(1)
    b := reflect.ValueOf([]int{1, 2, 3})

    v1.Call([]reflect.Value{a, b})
    v2.Call([]reflect.Value{a, a, a, a, a, a})

    //v1.CallSlice([]reflect.Value{a, b}) // 非变参函数,不能用 CallSlice。
    v2.CallSlice([]reflect.Value{a, b})
}

下面的代码用到了所有这些方法:

// 获取各种值的相关信息
package main

import (
    "fmt"
    "reflect"
    "unsafe"
)

// 嵌套结构体
type ss struct {
    a struct {
        int
        string
    }
    int
    string
    bool
    float64
}

func (s ss) Method1(i int) string  { return "结构体方法1" }
func (s *ss) Method2(i int) string { return "结构体方法2" }

var (
    intValue   = int(0)
    int8Value  = int8(8)
    int16Value = int16(16)
    int32Value = int32(32)
    int64Value = int64(64)

    uIntValue   = uint(0)
    uInt8Value  = uint8(8)
    uInt16Value = uint16(16)
    uInt32Value = uint32(32)
    uInt64Value = uint64(64)

    byteValue    = byte(0)
    runeValue    = rune(0)
    uintptrValue = uintptr(0)

    boolValue   = false
    stringValue = "stringValue"

    float32Value = float32(32)
    float64Value = float64(64)

    complex64Value  = complex64(64)
    complex128Value = complex128(128)

    arrayValue  = [5]string{}           // 数组
    sliceValue  = []byte{0, 0, 0, 0, 0} // 切片
    mapValue    = map[string]int{}      // 映射
    chanValue   = make(chan int, 2)     // 通道
    structValue = ss{                   // 结构体
        struct {
            int
            string
        }{10, "子结构体"},
        20,
        "结构体",
        false,
        64.0,
    }

    func1Value = func(i int) string { // 函数(固定参数)
        return fmt.Sprintf("固定参数:%v", i)
    }

    func2Value = func(i ...int) string { // 函数(动态参数)
        return fmt.Sprintf("动态参数:%v", i)
    }

    unsafePointer     = unsafe.Pointer(&structValue)    // 通用指针
    reflectType       = reflect.TypeOf(0)               // 反射类型
    reflectValue      = reflect.ValueOf(0)              // 反射值
    reflectArrayValue = reflect.ValueOf([]int{1, 2, 3}) // 切片反射值
    // 反射接口类型
    interfaceType = reflect.TypeOf(new(interface{})).Elem()
)

// 简单类型
var simpleTypes = []interface{}{
    intValue, &intValue, // int
    int8Value, &int8Value, // int8
    int16Value, &int16Value, // int16
    int32Value, &int32Value, // int32
    int64Value, &int64Value, // int64
    uIntValue, &uIntValue, // uint
    uInt8Value, &uInt8Value, // uint8
    uInt16Value, &uInt16Value, // uint16
    uInt32Value, &uInt32Value, // uint32
    uInt64Value, &uInt64Value, // uint64
    byteValue, &byteValue, // byte
    runeValue, &runeValue, // rune
    uintptrValue, &uintptrValue, // uintptr
    boolValue, &boolValue, // bool
    stringValue, &stringValue, // string
    float32Value, &float32Value, // float32
    float64Value, &float64Value, // float64
    complex64Value, &complex64Value, // complex64
    complex128Value, &complex128Value, // complex128
}

// 复杂类型
var complexTypes = []interface{}{
    arrayValue, &arrayValue, // 数组
    sliceValue, &sliceValue, // 切片
    mapValue, &mapValue, // 映射
    chanValue, &chanValue, // 通道
    structValue, &structValue, // 结构体
    func1Value, &func1Value, // 定参函数
    func2Value, &func2Value, // 动参函数
    structValue.Method1, structValue.Method2, // 方法
    unsafePointer, &unsafePointer, // 指针
    reflectType, &reflectType, // 反射类型
    reflectValue, &reflectValue, // 反射值
    interfaceType, &interfaceType, // 接口反射类型
}

// 空值
var unsafeP unsafe.Pointer

// 空接口
var nilInterfece interface{}

func main() {
    // 测试简单类型
    for i := 0; i < len(simpleTypes); i++ {
        PrintInfo(simpleTypes[i])
    }
    // 测试复杂类型
    for i := 0; i < len(complexTypes); i++ {
        PrintInfo(complexTypes[i])
    }
    // 测试单个对象
    PrintInfo(&unsafeP)
    PrintInfo(nilInterfece)
    // PrintInfo(&nilInterfece) // 会引发 panic
}

func PrintInfo(i interface{}) {
    if i == nil {
        fmt.Println("--------------------")
        fmt.Printf("无效接口值:%v\n", i)
        fmt.Println("--------------------")
        return
    }
    v := reflect.ValueOf(i)
    PrintValue(v)
}

func PrintValue(v reflect.Value) {
    fmt.Println("--------------------")
    // ----- 通用方法 -----
    fmt.Println("String             :", v.String())  // 反射值的字符串形式
    fmt.Println("Type               :", v.Type())    // 反射值的类型
    fmt.Println("Kind               :", v.Kind())    // 反射值的类别
    fmt.Println("CanAddr            :", v.CanAddr()) // 是否可以获取地址
    fmt.Println("CanSet             :", v.CanSet())  // 是否可以修改
    if v.CanAddr() {
        fmt.Println("Addr               :", v.Addr())       // 获取地址
        fmt.Println("UnsafeAddr         :", v.UnsafeAddr()) // 获取自由地址
    }
    // 是否可转换为接口对象
    fmt.Println("CanInterface       :", v.CanInterface())
    if v.CanInterface() {
        fmt.Println("Interface          :", v.Interface()) // 转换为接口对象
    }
    // 获取方法数量
    fmt.Println("NumMethod          :", v.NumMethod())
    if v.NumMethod() > 0 {
        // 遍历方法
        i := 0
        for ; i < v.NumMethod()-1; i++ {
            fmt.Printf("    ┣ %v\n", v.Method(i).String())
            //          if i >= 4 { // 只列举 5 个
            //              fmt.Println("    ┗ ...")
            //              break
            //          }
        }
        fmt.Printf("    ┗ %v\n", v.Method(i).String())
        // 通过名称获取方法
        fmt.Println("MethodByName       :", v.MethodByName("String").String())
    }
    // ----- 可获取指针的类型 -----
    switch v.Kind() {
    case reflect.Slice, reflect.Map, reflect.Chan, reflect.Func,
        reflect.Ptr, reflect.UnsafePointer:
        fmt.Println("Pointer            :", v.Pointer())
    }
    // ----- 特殊类型 -----
    switch v.Kind() {
    // 指针:
    case reflect.Ptr:
        fmt.Println("=== 指针 ===")
        // 获取指针地址
        if !v.IsNil() {
            // 获取指针所指对象
            v = v.Elem() // 只有指针和接口类型可以使用 Elem()
            fmt.Printf("转换到指针所指对象 : %v\n", v.Type())
            // 递归处理指针所指对象
            PrintValue(v)
            return
        }
    // 自由指针:
    case reflect.UnsafePointer:
        fmt.Println("=== 自由指针 ===")
        if v.Pointer() == 0 {
            v.SetPointer(unsafePointer)
            fmt.Println("重新指向新对象     :", v.Pointer())
        }
        // 将自由指针转换为 *ss 指针(因为定义 unsafePointer 时已经确定了类型)
        s := (*ss)(v.Interface().(unsafe.Pointer))
        // 获取反射值
        v = reflect.ValueOf(s)
        if !v.IsNil() {
            // 获取指针所指对象
            v = v.Elem() // 只有指针和接口类型可以使用 Elem()
            fmt.Printf("转换到指针所指对象 : %v\n", v.Type())
            // 递归处理指针所指对象
            PrintValue(v)
            return
        }
    // 接口:
    case reflect.Interface:
        fmt.Println("=== 接口 ===")
        // 获取接口数据
        fmt.Println("InterfaceData      :", v.InterfaceData())
        // 获取接口所包含的对象
        v = v.Elem() // 只有指针和接口类型可以使用 Elem()
        fmt.Printf("转换到接口所含对象 : %v\n", v.Type())
        // 递归处理接口的动态对象
        PrintValue(v)
        return
    }
    // ----- 简单类型 -----
    // 有符号整型:
    if reflect.Int <= v.Kind() && v.Kind() <= reflect.Int64 {
        fmt.Println("=== 有符号整型 ===")
        fmt.Println("Int                :", v.Int()) // 获取值
        if v.CanSet() {
            v.SetInt(10)                                 // 设置值
            fmt.Println("Int                :", v.Int()) // 获取值
            v.Set(reflect.ValueOf(20).Convert(v.Type())) // 设置值
        }
        fmt.Println("Int                :", v.Int())           // 获取值
        fmt.Println("OverflowInt        :", v.OverflowInt(10)) // 是否溢出
    }
    // 无符号整型:
    if reflect.Uint <= v.Kind() && v.Kind() <= reflect.Uint64 {
        fmt.Println("=== 无符号整型 ===")
        fmt.Println("Uint               :", v.Uint()) // 获取值
        if v.CanSet() {
            v.SetUint(10)                                 // 设置值
            fmt.Println("Uint               :", v.Uint()) // 获取值
            v.Set(reflect.ValueOf(20).Convert(v.Type()))  // 设置值
        }
        fmt.Println("Uint               :", v.Uint())           // 获取值
        fmt.Println("OverflowUint       :", v.OverflowUint(10)) // 是否溢出
    }
    switch v.Kind() {
    // 浮点数:
    case reflect.Float32, reflect.Float64:
        fmt.Println("=== 浮点数 ===")
        fmt.Println("Float              :", v.Float()) // 获取值
        if v.CanSet() {
            v.SetFloat(10)                                 // 设置值
            fmt.Println("Float              :", v.Float()) // 获取值
            v.Set(reflect.ValueOf(20).Convert(v.Type()))   // 设置值
        }
        fmt.Println("Float              :", v.Float())           // 获取值
        fmt.Println("OverflowFloat      :", v.OverflowFloat(10)) // 是否溢出
    // 复数:
    case reflect.Complex64, reflect.Complex128:
        fmt.Println("=== 复数 ===")
        fmt.Println("Complex            :", v.Complex()) // 获取值
        if v.CanSet() {
            v.SetComplex(10)                                   // 设置值
            fmt.Println("Complex            :", v.Complex())   // 获取值
            v.Set(reflect.ValueOf(20 + 20i).Convert(v.Type())) // 设置值
        }
        fmt.Println("Complex            :", v.Complex())           // 获取值
        fmt.Println("OverflowComplex    :", v.OverflowComplex(10)) // 是否溢出
    // 布尔型:
    case reflect.Bool:
        fmt.Println("=== 布尔型 ===")
        fmt.Println("Bool               :", v.Bool()) // 获取值
        if v.CanSet() {
            v.SetBool(true)                               // 设置值
            fmt.Println("Bool               :", v.Bool()) // 获取值
            v.Set(reflect.ValueOf(false))                 // 设置值
        }
        fmt.Println("Bool               :", v.Bool()) // 获取值
    // 字符串:
    case reflect.String:
        fmt.Println("=== 字符串 ===")
        fmt.Println("String             :", v.String()) // 获取值
        if v.CanSet() {
            v.SetString("abc")                              // 设置值
            fmt.Println("String             :", v.String()) // 获取值
            v.Set(reflect.ValueOf("def"))                   // 设置值
        }
        fmt.Println("String             :", v.String()) // 获取值
    // ----- 复杂类型 -----
    // 切片型:
    case reflect.Slice:
        fmt.Println("=== 切片型 ===")
        fmt.Println("Len                :", v.Len()) // 获取长度
        fmt.Println("Cap                :", v.Cap()) // 获取容量
        if v.CanSet() {
            v.SetLen(4) // 不能大于 cap
            v.SetCap(4) // 不能小于 len,只能缩,不能扩
            fmt.Println("SetLen, SetCap     :", v.Len(), v.Cap())
            // 重新指定字节内容
            if v.Type().Elem().Kind() == reflect.Uint8 {
                v.SetBytes([]byte{1, 2, 3, 4, 5, 6, 7, 8, 9, 0})
            }
            fmt.Println("SetByte            :", []byte{1, 2, 3, 4, 5, 6, 7, 8, 9, 0})
        }
        // 获取字节内容
        if v.Type().Elem().Kind() == reflect.Uint8 {
            fmt.Println("Bytes              :", v.Bytes())
        }
        // 根据索引获取元素
        if v.Len() > 0 {
            for i := 0; i < v.Len(); i++ {
                fmt.Println("Index              :", v.Index(i))
            }
        }
        // 获取一个指定范围的切片
        // 参数:起始下标,结束下标
        // 长度 = 结束下标 - 起始下标
        s1 := v.Slice(1, 2)
        fmt.Println("Slice              :", s1)
        fmt.Println("Len                :", s1.Len()) // 获取长度
        fmt.Println("Cap                :", s1.Cap()) // 获取容量
        // 获取一个指定范围和容量的切片
        // 参数:起始下标,结束下标,容量下标
        // 长度 = 结束下标 - 起始下标
        // 容量 = 容量下标 - 起始下标
        s2 := v.Slice3(1, 2, 4)
        fmt.Println("Slice              :", s2)
        fmt.Println("Len                :", s2.Len()) // 获取长度
        fmt.Println("Cap                :", s2.Cap()) // 获取容量
    // 映射型:
    case reflect.Map:
        fmt.Println("=== 映射型 ===")
        // 设置键值,不需要检测 CanSet
        v.SetMapIndex(reflect.ValueOf("a"), reflect.ValueOf(1))
        v.SetMapIndex(reflect.ValueOf("b"), reflect.ValueOf(2))
        v.SetMapIndex(reflect.ValueOf("c"), reflect.ValueOf(3))
        // 获取键列表
        fmt.Println("MapKeys            :", v.MapKeys())
        for _, idx := range v.MapKeys() {
            // 根据键获取值
            fmt.Println("MapIndex           :", v.MapIndex(idx))
        }
    // 结构体:
    case reflect.Struct:
        fmt.Println("=== 结构体 ===")
        // 获取字段个数
        fmt.Println("NumField           :", v.NumField())
        if v.NumField() > 0 {
            var i, j int
            // 遍历结构体字段
            for i = 0; i < v.NumField()-1; i++ {
                field := v.Field(i) // 获取结构体字段
                fmt.Printf("    ├ %-8v %v\n", field.Type(), field.String())
                // 遍历嵌套结构体字段
                if field.Kind() == reflect.Struct && field.NumField() > 0 {
                    for j = 0; j < field.NumField()-1; j++ {
                        subfield := v.FieldByIndex([]int{i, j}) // 获取嵌套结构体字段
                        fmt.Printf("    │    ├ %-8v %v\n", subfield.Type(), subfield.String())
                        // if i >= 4 { // 只列举 5 个
                        //  fmt.Println("        ┗ ...")
                        //  break
                        // }
                    }
                    subfield := v.FieldByIndex([]int{i, j}) // 获取嵌套结构体字段
                    fmt.Printf("    │    └ %-8v %v\n", subfield.Type(), subfield.String())
                }
                // if i >= 4 { // 只列举 5 个
                //  fmt.Println("    ┗ ...")
                //  break
                // }
            }
            field := v.Field(i) // 获取结构体字段
            fmt.Printf("    └ %-8v %v\n", field.Type(), field.String())
            // 通过名称查找字段
            if v := v.FieldByName("ptr"); v.IsValid() {
                fmt.Println("FieldByName(ptr)   :", v.Type().Name())
            }
            // 通过函数查找字段
            v := v.FieldByNameFunc(func(s string) bool { return len(s) > 3 })
            if v.IsValid() {
                fmt.Println("FieldByNameFunc    :", v.Type().Name())
            }
        }
    // 通道型:
    case reflect.Chan:
        fmt.Println("=== 通道型 ===")
        // 发送数据(会阻塞)
        v.Send(reflectValue)
        // 尝试发送数据(不会阻塞)
        fmt.Println("TrySend            :", v.TrySend(reflectValue))
        // 接收数据(会阻塞)
        if x, ok := v.Recv(); ok {
            fmt.Println("Recv               :", x) //
        }
        // 尝试接收数据(不会阻塞)
        if x, ok := v.TryRecv(); ok {
            fmt.Println("TryRecv            :", x) //
        }
        // 因为要执行两次,通道和通道指针各执行一次,关闭后第二次就无法执行了。
        // v.Close()
    // 函数型:
    case reflect.Func:
        fmt.Println("=== 函数型 ===")
        // 判断函数是否具有变长参数
        if v.Type().IsVariadic() {
            // 与可变参数对应的实参必须是切片类型的反射值(reflectArrayValue)。
            fmt.Println("CallSlice          :", v.CallSlice([]reflect.Value{reflectArrayValue})) //
            // 也可以用 v.Call 调用变长参数的函数,只需传入 reflectValue 即可。
        } else {
            // 根据函数定义的参数数量,传入相应数量的反射值(reflectValue)。
            fmt.Println("Call               :", v.Call([]reflect.Value{reflectValue})) //
        }
    }
}

你可能感兴趣的:(GO: reflect包)