Convert any struct into a map and vice versa.
This library can recursively convert a struct to a map of type map[string]interface{} where the keys are the struct field names and the values are the field values.
Similarly, the library can set the fields of a struct using a map.
A mapping function can be used to convert keys or values before they are set.
- Handles composed structs
- Handles nested structs
- Handles reference cycles
- Supports unexported fields
- Supports field mapping or conversion
Not all types are tested or supported yet eg. interface, function, channel
go get -u github.com/jschoedt/go-structmapper
// convert struct to map
s := &SomeStruct{Name: "John"}
mapper := mapper.New()
m, err := mapper.StructToMap(s) // m["Name"] == "John"
// convert map to struct
s = &SomeStruct{}
err := mapper.MapToStruct(m, s) // s.Name == "John"A MapFunc can be used to map a key or value to some other key or value. Returning the MappingType mapper.Ignore will ignore that field. The MapFunc will be called on every field that is encountered in the struct
s := &SomeStruct{Name: "John"}
mapper := mapper.New()
mapper.MapFunc = func(inKey string, inVal interface{}) (mt MappingType, outKey string, outVal interface{}) {
return mapper.Default, strings.ToLower(inKey), "Deere"
}
m, err := mapper.StructToMap(s) // m["name"] == "Deere"
// convert map to struct
s = &SomeStruct{}
mapper.CaseSensitive = false // now 'name' will match 'Name'
err := mapper.MapToStruct(m, s) // s.Name == "Deere"