一个简单的, 易用的反射工具库.
主要支持如下特性:
-
设置结构体字段值, 支持通过路径比如
A.B.C
设置嵌套结构体字段的值 -
获取结构体字段的值, 类型, Tag 等.
-
遍历结构体所有字段, 支持
select
模式和range
模式, 如果使用深度遍历方法比如FieldsDeep
将遍历所有嵌套结构. -
函数调用, 方法调用, 支持可变参数.
-
新建实例, 判断接口实现等等.
安装命令 go get github.com/morrisxyang/xreflect
.
文档见 https://pkg.go.dev/github.com/morrisxyang/xreflect
设置嵌套结构体字段值
person := &Person{
Name: "John",
Age: 20,
Country: Country{
ID: 0,
Name: "Perk",
},
}
_ = SetEmbedField(person, "Country.ID", 1)
// Perk's ID: 1
fmt.Printf("Perk's ID: %d \n", person.Country.ID)
获取 json tag
type Person struct {
Name string `json:"name" xml:"_name"`
}
p := &Person{}
// json:"name" xml:"_name"
fmt.Println(StructFieldTag(p, "Name"))
// name <nil>
fmt.Println(StructFieldTagValue(p, "Name", "json"))
// _name <nil>
fmt.Println(StructFieldTagValue(p, "Name", "xml"))
筛选实例字段(深度遍历)
type Person struct {
id string
Age int `json:"int"`
Name string `json:"name"`
Home struct {
Address string `json:"address"`
}
}
p := &Person{}
fields, _ := SelectFieldsDeep(p, func(s string, field reflect.StructField, value reflect.Value) bool {
return field.Tag.Get("json") != ""
})
// key: Age type: int
// key: Name type: string
// key: Home.Address type: string
for k, v := range fields {
fmt.Printf("key: %s type: %v\n", k, v.Type())
}
调用函数
var addFunc = func(nums ...int) int {
var sum int
for _, num := range nums {
sum += num
}
return sum
}
res, _ := CallFunc(addFunc, 1, 2, 3)
// 6
fmt.Println(res[0].Interface())
- func Field(obj interface{}, fieldName string) (reflect.Value, error)
- func FieldValue(obj interface{}, fieldName string) (interface{}, error)
- func EmbedField(obj interface{}, fieldPath string) (reflect.Value, error)
- func EmbedFieldValue(obj interface{}, fieldPath string) (interface{}, error)
- func Fields(obj interface{}) (map[string]reflect.Value, error)
- func FieldsDeep(obj interface{}) (map[string]reflect.Value, error)
- func RangeFields(obj interface{}, f func(string, reflect.StructField, reflect.Value) bool) error
- func SelectFields(obj interface{}, f func(string, reflect.StructField, reflect.Value) bool) (map[string]reflect.Value, error)
- etc.
-
func SetEmbedField(obj interface{}, fieldPath string, fieldValue interface{}) error
-
func SetField(obj interface{}, fieldName string, fieldValue interface{}) error
-
func SetPrivateField(obj interface{}, fieldName string, fieldValue interface{}) error
-
etc.
-
func StructField(obj interface{}, fieldName string) (reflect.StructField, error)
-
func StructFieldTagValue(obj interface{}, fieldName, tagKey string) (string, error)
-
func EmbedStructField(obj interface{}, fieldPath string) (reflect.StructField, error)
-
func StructFields(obj interface{}) ([]reflect.StructField, error)
-
func StructFieldsFlatten(obj interface{}) ([]reflect.StructField, error)
-
func RangeStructFields(obj interface{}, f func(int, reflect.StructField) bool) error
-
etc.
-
func CallFunc(fn interface{}, args ...interface{}) ([]reflect.Value, error)
-
func CallMethod(obj interface{}, method string, params ...interface{}) ([]reflect.Value, error)
-
etc.
- func NewInstance(obj interface{}) interface{}
- func Type(obj interface{}) reflect.Type
- func TypePenetrateElem(obj interface{}) reflect.Type
- func Value(obj interface{}) reflect.Value
- func ValuePenetrateElem(obj interface{}) reflect.Value
- etc.
Field
返回 reflect.Value, StrcutField
返回 reflect.StrcutField.