aboutsummaryrefslogtreecommitdiff
path: root/vendor/github.com/jmoiron/sqlx/reflectx/README.md
blob: f01d3d1f084aaa4e70218a4157d1c656b50ba3bd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# reflectx

The sqlx package has special reflect needs.  In particular, it needs to:

* be able to map a name to a field
* understand embedded structs
* understand mapping names to fields by a particular tag
* user specified name -> field mapping functions

These behaviors mimic the behaviors by the standard library marshallers and also the
behavior of standard Go accessors.

The first two are amply taken care of by `Reflect.Value.FieldByName`, and the third is
addressed by `Reflect.Value.FieldByNameFunc`, but these don't quite understand struct
tags in the ways that are vital to most marshallers, and they are slow.

This reflectx package extends reflect to achieve these goals.