Go学习(二十七):反射学习使用

1.介绍

Go语言实现了反射，所谓反射就是动态运行时的状态。我们一般用到的包是reflect包，reflect 实现了运行时的反射能力，能够让程序操作不同类型的对象。反射包中有两对非常重要的函数和类型，两个函数分别是：

方法名	描述
reflect.TypeOf	可以获得任意值的类型对象,返回类型:reflect.Type
reflect.ValueOf	可以获得任意值的值对象,返回类型:reflect.Value

反射包中的所有方法基本都是围绕着 reflect.Type 和 reflect.Value 两个类型设计的。我们通过 reflect.TypeOf、reflect.ValueOf 可以将一个普通的变量转换成反射包中提供的 reflect.Type 和 reflect.Value，随后就可以使用反射包中的方法对它们进行复杂的操作。

2.reflect.Type

类型 reflect.Type 是反射包定义的一个接口，我们可以使用 reflect.TypeOf 函数获取任意变量的类型，reflect.Type 接口中定义了一些方法,常用的如下:

2.1 常用方法列表

方法名	描述
Kind() Kind	返回该变量的的具体分类
Name() string	Name返回该类型在自身包内的类型名，如果是未命名类型会返回””
NumField() int	返回 struct 字段数量，不是 struct 会 panic
Implements(u Type) bool	检查当前类型有没有实现接口 u
Field(i int) StructField	返回struct 类型的第 i 个字段，不是struct 会 panic， i 越界也会panic
Key() Type	返回map 的key 的类型，不是map会panic

2.2 使用示例

package main
import (
	"fmt"
	"reflect"
)
type People interface {
	Eat(str string)
}
type User struct {
	Name string
	Age  int
}
func (u User) Eat(str string) {
	fmt.Println("吃" + str)
}
func main() {
	var user User
	userTypeOf := reflect.TypeOf(user)
	fmt.Printf("typeOf:%T v:%v\n", userTypeOf, userTypeOf)
	// 获取类型分类
	fmt.Printf("kind:%T v:%v\n", userTypeOf.Kind(), userTypeOf.Kind())
	// 获取类型名称
	fmt.Printf("name:%T v:%v\n", userTypeOf.Name(), userTypeOf.Name())
	// 判断类型是否实现接口People
	implements := userTypeOf.Implements(reflect.TypeOf((*People)(nil)).Elem())
	fmt.Printf("变量user是否实现接口People : %t\n", implements)
	// 变量结构体user的字段数量
	fmt.Printf("变量结构体user的字段数量: %d \n", userTypeOf.NumField())
	// 打印结构体字段
	fmt.Printf("打印结构体user第%d个字段: %v \n", 0,userTypeOf.Field(0).Name)
	fmt.Printf("打印结构体user第%d个字段: %v \n", 1,userTypeOf.Field(1).Name)
	map1 := map[string]int {
		"张三": 19,
		"李四": 23,
	}
	fmt.Printf("打印map的key类型: %v \n", reflect.TypeOf(map1).Key())
}

/**输出
typeOf:*reflect.rtype v:main.User
kind:reflect.Kind v:struct
name:string v:User
变量user是否实现接口People : true
变量结构体user的字段数量: 2 
打印结构体user第0个字段: Name 
打印结构体user第1个字段: Age 
打印map的key类型: string 
*/

2.3 Kind类型整理

type Kind uint
const (
    Invalid Kind = iota  // 非法类型
    Bool                 // 布尔型
    Int                  // 有符号整型
    Int8                 // 有符号8位整型
    Int16                // 有符号16位整型
    Int32                // 有符号32位整型
    Int64                // 有符号64位整型
    Uint                 // 无符号整型
    Uint8                // 无符号8位整型
    Uint16               // 无符号16位整型
    Uint32               // 无符号32位整型
    Uint64               // 无符号64位整型
    Uintptr              // 指针
    Float32              // 单精度浮点数
    Float64              // 双精度浮点数
    Complex64            // 64位复数类型
    Complex128           // 128位复数类型
    Array                // 数组
    Chan                 // 通道
    Func                 // 函数
    Interface            // 接口
    Map                  // 映射
    Ptr                  // 指针
    Slice                // 切片
    String               // 字符串
    Struct               // 结构体
    UnsafePointer        // 底层指针
)

3.reflect.Value

反射包中Value的类型与Type不同，它被声明成了结构体。这个结构体没有对外暴露的字段，但是提供了获取或者写入数据的方法。

3.1 常用方法列表

方法名	描述
Call(in []Value) []Value	调用方法,第一个参数是in[0]，第二个是in[1]，以此类推
Field(i int) StructField	返回struct 类型的第 i 个字段的值，不是struct 会 panic， i 越界也会panic。
FieldByName(name string) Value	根据字段名查找值，前提类型是struct
Index(i int) Value	返回第 i 个元素,主要用于遍历,不能越界。 前提类型是Array, Slice, String之一，
IsNil() bool	返回值是否为nil。如果值类型不是通道（channel）、函数、 接口、map、指针或 切片时发生panic，类似于语言层的v== nil操作。常被用于判断指针是否为空。
IsValid() bool	返回v是否持有一个值。如果v是Value零值会返回假， 此时v除了IsValid、String、Kind之外的方法都会导致panic。常被用于判定返回值是否有效
MapIndex(key Value) Value	根据索引获取对应的值,前提类型是map
MapKeys() []Value	返回map中所有的key,返回类型是切片slice
Set(x Value)	通过反射修改值。
Type() Type	获取值的类型

3.2 使用示例

package main
import (
	"fmt"
	"reflect"
)
type User struct {
	Name string
	Age  int
}
func (u User) Eat(str string) {
	fmt.Println("调用函数: 吃" + str)
}
func main() {
	user := User{"张福生", 30}
	userValOf := reflect.ValueOf(user)
	// 调用方法
	param := []reflect.Value{reflect.ValueOf("香蕉")}
	userValOf.MethodByName("Eat").Call(param)
	// 打印结构体的值
	fmt.Printf("打印结构体user第%d个字段值v: %v\n", 0, userValOf.Field(0))
	fmt.Printf("打印结构体user第%d个字段值v: %v\n",1, userValOf.Field(1))
	// 根据属性值打印结构体的值
	fmt.Printf("打印结构体user字段%s的值v: %v\n", "Age",userValOf.FieldByName("Age"))
	// 返回第 i 个元素,主要用于遍历,不能越界。前提类型是Array, Slice, String之一，
	strSlice :=[]string{"你","我","他","!"}
	strSliceValOf := reflect.ValueOf(strSlice)
	fmt.Printf("打印字符串第%d个元素值v: %v\n", 0,strSliceValOf.Index(0))
	fmt.Printf("打印字符串第%d个元素值v: %v\n", 1,strSliceValOf.Index(1))
	fmt.Printf("打印字符串第%d个元素值v: %v\n", 3,strSliceValOf.Index(2))

	// IsNil: 判断是否是nil
	fmt.Printf("变量strSlice的值是否是nil: %t\n",strSliceValOf.IsNil())
	var u []User
	uuOf := reflect.ValueOf(u)
	fmt.Printf("IsNil: 变量u的值是否是nil: %t\n",uuOf.IsNil())
	// IsValid：判断返回值是否有效
	fmt.Printf("存在的方法: %t\n",userValOf.MethodByName("Eat").IsValid())
	fmt.Printf("不存在的方法: %t\n",userValOf.MethodByName("A").IsValid())

	// #############  针对map的操作  #############
	map1 := map[string]string{
		"姓名": "张三",
		"phone": "176666666666",
		"?": "ABC",
	}
	mapValOf := reflect.ValueOf(map1)
	// 根据索引获取对应的值
	fmt.Printf("根据索引获取map值，key=%s,v=%s \n","姓名",mapValOf.MapIndex(reflect.ValueOf("姓名")))
	fmt.Printf("根据索引获取map值，key=%s,v=%s \n","phone",mapValOf.MapIndex(reflect.ValueOf("phone")))
	fmt.Printf("根据索引获取map值，key=%s,v=%s \n","?",mapValOf.MapIndex(reflect.ValueOf("?")))
	// 返回map中所有的key,返回类型是切片slice
	fmt.Printf("返回map中所有的key: %+v 类型:%T \n",mapValOf.MapKeys(),mapValOf.MapKeys())
	// 通过反射修改值
	num := 10
	numValOf := reflect.ValueOf(&num)//注意这里需要传地址
	fmt.Printf("修改前的值: %v \n",num)
	numValOf.Elem().Set(reflect.ValueOf(100))
	fmt.Printf("修改后的值: %v \n",num)
	// 获取值的类型
	fmt.Printf("获取mapValOf值的类型: %v \n",mapValOf.Type())
}

输出:

调用函数: 吃香蕉
打印结构体user第0个字段值v: 张福生
打印结构体user第1个字段值v: 30
打印结构体user字段Age的值v: 30
打印字符串第0个元素值v: 你
打印字符串第1个元素值v: 我
打印字符串第3个元素值v: 他
变量strSlice的值是否是nil: false
IsNil: 变量u的值是否是nil: true
存在的方法: true
不存在的方法: false
根据索引获取map值，key=姓名,v=张三 
根据索引获取map值，key=phone,v=176666666666 
根据索引获取map值，key=?,v=ABC 
返回map中所有的key: [姓名 phone ?] 类型:[]reflect.Value 
修改前的值: 10 
修改后的值: 100 
获取mapValOf值的类型: map[string]string 

4.实践场景

4.1 动态调用结构体方法

使用MethodByName("xx").Call(param)调用函数

/**
 * @Author Mr.LiuQH
 * @Description 反射学习使用
 * @Date 2021/2/2 10:50 上午
 **/
package main
import (
	"fmt"
	"reflect"
)
type People struct {
	Name string
}
func (p People) GetName() string {
	return p.Name
}
func (p People) Tell(toName, context string) string {
	return fmt.Sprintf(p.Name+"告诉%s,%s", toName, context)
}

func main() {
	p := People{"张三"}
	peopleValOf := reflect.ValueOf(p)
	// 通过反射调用方法(无参数)
	call := peopleValOf.MethodByName("GetName").Call(nil)
	fmt.Printf("无参函数调用,返回: %v %T \n", call, call)

	// 通过反射调用方法(有参数)
	param := []reflect.Value{
		reflect.ValueOf("小明"),
		reflect.ValueOf("你通过考试了！"),
	}
	values := peopleValOf.MethodByName("Tell").Call(param)
	fmt.Printf("有参函数调用,返回: %v %T \n", values, values)
}
/**输出
无参函数调用,返回: [张三] []reflect.Value 
有参函数调用,返回: [张三告诉小明,你通过考试了！] []reflect.Value 
*/

4.2 处理错误结果

package main
import (
	"errors"
	"fmt"
	"reflect"
)
type People struct {
	Name string
}
func (p People)ThrowError()error  {
	return errors.New("测试错误抛出")
}
func main() {
	p := People{"张三"}
	peopleValOf := reflect.ValueOf(p)
	ret := peopleValOf.MethodByName("ThrowError").Call(nil)
	// 返回值也是 Value 类型，对于错误，可以转为 interface 之后断言
	fmt.Printf("errValue: %v 类型转换: %T", ret[0], ret[0].Interface().(error))
}

4.3 解析结构体标签

使用field.Tag.Lookup()或field.Tag.Get()查找对应的标签值

package main
import (
	"fmt"
	"reflect"
)
type People struct {
	Name string `json:"name" db:"t_name"`
	Age int `json:"age" db:"t_age"`
}
func main() {
	p := People{"张三",23}
	peopleTypeOf := reflect.TypeOf(p)
	// 获取结构体字段数量
	fieldNum := peopleTypeOf.NumField()
	for i := 0; i < fieldNum; i++ {
		// 获取结构体中，第i个字段的值
		field := peopleTypeOf.Field(i)
		// 获取json标签对应的值(方法一)
		if lookup, ok := field.Tag.Lookup("json");ok {
			fmt.Printf("字段 %v, 对应的json-tag: %s \n" ,field.Name, lookup)
		}
		// 获取db标签对应的值(方法二)
		dbTag := field.Tag.Get("db")
		fmt.Printf("字段 %v, 对应的db-tag: %s \n" ,field.Name, dbTag)
	}
}
/**输出
字段 Name, 对应的json-tag: name 
字段 Name, 对应的db-tag: t_name 
字段 Age, 对应的json-tag: age 
字段 Age, 对应的db-tag: t_age 
*/

4.4 判断是否实现接口

package main
import (
	"fmt"
	"reflect"
)
type People interface {
	Eat(str string)
}
type User struct {}
func (u User) Eat(str string) {
	fmt.Println("吃" + str)
}
func main() {
	user := &User{}
	// 当变量不是传指针时，Eat方法的接收方是指针，则没有实现接口
	userTypeOf := reflect.TypeOf(user)
	// 判断类型是否实现接口People
	implements := userTypeOf.Implements(reflect.TypeOf((*People)(nil)).Elem())
	fmt.Printf("变量user是否实现接口People : %t\n", implements)
}
// 输出: 变量user是否实现接口People : false