5 "github.com/modern-go/reflect2"
13 var typeDecoders = map[string]ValDecoder{}
14 var fieldDecoders = map[string]ValDecoder{}
15 var typeEncoders = map[string]ValEncoder{}
16 var fieldEncoders = map[string]ValEncoder{}
17 var extensions = []Extension{}
19 // StructDescriptor describe how should we encode/decode the struct
20 type StructDescriptor struct {
25 // GetField get one field from the descriptor by its name.
26 // Can not use map here to keep field orders.
27 func (structDescriptor *StructDescriptor) GetField(fieldName string) *Binding {
28 for _, binding := range structDescriptor.Fields {
29 if binding.Field.Name() == fieldName {
36 // Binding describe how should we encode/decode the struct field
39 Field reflect2.StructField
46 // Extension the one for all SPI. Customize encoding/decoding by specifying alternate encoder/decoder.
47 // Can also rename fields by UpdateStructDescriptor.
48 type Extension interface {
49 UpdateStructDescriptor(structDescriptor *StructDescriptor)
50 CreateMapKeyDecoder(typ reflect2.Type) ValDecoder
51 CreateMapKeyEncoder(typ reflect2.Type) ValEncoder
52 CreateDecoder(typ reflect2.Type) ValDecoder
53 CreateEncoder(typ reflect2.Type) ValEncoder
54 DecorateDecoder(typ reflect2.Type, decoder ValDecoder) ValDecoder
55 DecorateEncoder(typ reflect2.Type, encoder ValEncoder) ValEncoder
58 // DummyExtension embed this type get dummy implementation for all methods of Extension
59 type DummyExtension struct {
62 // UpdateStructDescriptor No-op
63 func (extension *DummyExtension) UpdateStructDescriptor(structDescriptor *StructDescriptor) {
66 // CreateMapKeyDecoder No-op
67 func (extension *DummyExtension) CreateMapKeyDecoder(typ reflect2.Type) ValDecoder {
71 // CreateMapKeyEncoder No-op
72 func (extension *DummyExtension) CreateMapKeyEncoder(typ reflect2.Type) ValEncoder {
76 // CreateDecoder No-op
77 func (extension *DummyExtension) CreateDecoder(typ reflect2.Type) ValDecoder {
81 // CreateEncoder No-op
82 func (extension *DummyExtension) CreateEncoder(typ reflect2.Type) ValEncoder {
86 // DecorateDecoder No-op
87 func (extension *DummyExtension) DecorateDecoder(typ reflect2.Type, decoder ValDecoder) ValDecoder {
91 // DecorateEncoder No-op
92 func (extension *DummyExtension) DecorateEncoder(typ reflect2.Type, encoder ValEncoder) ValEncoder {
96 type EncoderExtension map[reflect2.Type]ValEncoder
98 // UpdateStructDescriptor No-op
99 func (extension EncoderExtension) UpdateStructDescriptor(structDescriptor *StructDescriptor) {
102 // CreateDecoder No-op
103 func (extension EncoderExtension) CreateDecoder(typ reflect2.Type) ValDecoder {
107 // CreateEncoder get encoder from map
108 func (extension EncoderExtension) CreateEncoder(typ reflect2.Type) ValEncoder {
109 return extension[typ]
112 // CreateMapKeyDecoder No-op
113 func (extension EncoderExtension) CreateMapKeyDecoder(typ reflect2.Type) ValDecoder {
117 // CreateMapKeyEncoder No-op
118 func (extension EncoderExtension) CreateMapKeyEncoder(typ reflect2.Type) ValEncoder {
122 // DecorateDecoder No-op
123 func (extension EncoderExtension) DecorateDecoder(typ reflect2.Type, decoder ValDecoder) ValDecoder {
127 // DecorateEncoder No-op
128 func (extension EncoderExtension) DecorateEncoder(typ reflect2.Type, encoder ValEncoder) ValEncoder {
132 type DecoderExtension map[reflect2.Type]ValDecoder
134 // UpdateStructDescriptor No-op
135 func (extension DecoderExtension) UpdateStructDescriptor(structDescriptor *StructDescriptor) {
138 // CreateMapKeyDecoder No-op
139 func (extension DecoderExtension) CreateMapKeyDecoder(typ reflect2.Type) ValDecoder {
143 // CreateMapKeyEncoder No-op
144 func (extension DecoderExtension) CreateMapKeyEncoder(typ reflect2.Type) ValEncoder {
148 // CreateDecoder get decoder from map
149 func (extension DecoderExtension) CreateDecoder(typ reflect2.Type) ValDecoder {
150 return extension[typ]
153 // CreateEncoder No-op
154 func (extension DecoderExtension) CreateEncoder(typ reflect2.Type) ValEncoder {
158 // DecorateDecoder No-op
159 func (extension DecoderExtension) DecorateDecoder(typ reflect2.Type, decoder ValDecoder) ValDecoder {
163 // DecorateEncoder No-op
164 func (extension DecoderExtension) DecorateEncoder(typ reflect2.Type, encoder ValEncoder) ValEncoder {
168 type funcDecoder struct {
172 func (decoder *funcDecoder) Decode(ptr unsafe.Pointer, iter *Iterator) {
173 decoder.fun(ptr, iter)
176 type funcEncoder struct {
178 isEmptyFunc func(ptr unsafe.Pointer) bool
181 func (encoder *funcEncoder) Encode(ptr unsafe.Pointer, stream *Stream) {
182 encoder.fun(ptr, stream)
185 func (encoder *funcEncoder) IsEmpty(ptr unsafe.Pointer) bool {
186 if encoder.isEmptyFunc == nil {
189 return encoder.isEmptyFunc(ptr)
192 // DecoderFunc the function form of TypeDecoder
193 type DecoderFunc func(ptr unsafe.Pointer, iter *Iterator)
195 // EncoderFunc the function form of TypeEncoder
196 type EncoderFunc func(ptr unsafe.Pointer, stream *Stream)
198 // RegisterTypeDecoderFunc register TypeDecoder for a type with function
199 func RegisterTypeDecoderFunc(typ string, fun DecoderFunc) {
200 typeDecoders[typ] = &funcDecoder{fun}
203 // RegisterTypeDecoder register TypeDecoder for a typ
204 func RegisterTypeDecoder(typ string, decoder ValDecoder) {
205 typeDecoders[typ] = decoder
208 // RegisterFieldDecoderFunc register TypeDecoder for a struct field with function
209 func RegisterFieldDecoderFunc(typ string, field string, fun DecoderFunc) {
210 RegisterFieldDecoder(typ, field, &funcDecoder{fun})
213 // RegisterFieldDecoder register TypeDecoder for a struct field
214 func RegisterFieldDecoder(typ string, field string, decoder ValDecoder) {
215 fieldDecoders[fmt.Sprintf("%s/%s", typ, field)] = decoder
218 // RegisterTypeEncoderFunc register TypeEncoder for a type with encode/isEmpty function
219 func RegisterTypeEncoderFunc(typ string, fun EncoderFunc, isEmptyFunc func(unsafe.Pointer) bool) {
220 typeEncoders[typ] = &funcEncoder{fun, isEmptyFunc}
223 // RegisterTypeEncoder register TypeEncoder for a type
224 func RegisterTypeEncoder(typ string, encoder ValEncoder) {
225 typeEncoders[typ] = encoder
228 // RegisterFieldEncoderFunc register TypeEncoder for a struct field with encode/isEmpty function
229 func RegisterFieldEncoderFunc(typ string, field string, fun EncoderFunc, isEmptyFunc func(unsafe.Pointer) bool) {
230 RegisterFieldEncoder(typ, field, &funcEncoder{fun, isEmptyFunc})
233 // RegisterFieldEncoder register TypeEncoder for a struct field
234 func RegisterFieldEncoder(typ string, field string, encoder ValEncoder) {
235 fieldEncoders[fmt.Sprintf("%s/%s", typ, field)] = encoder
238 // RegisterExtension register extension
239 func RegisterExtension(extension Extension) {
240 extensions = append(extensions, extension)
243 func getTypeDecoderFromExtension(ctx *ctx, typ reflect2.Type) ValDecoder {
244 decoder := _getTypeDecoderFromExtension(ctx, typ)
246 for _, extension := range extensions {
247 decoder = extension.DecorateDecoder(typ, decoder)
249 decoder = ctx.decoderExtension.DecorateDecoder(typ, decoder)
250 for _, extension := range ctx.extraExtensions {
251 decoder = extension.DecorateDecoder(typ, decoder)
256 func _getTypeDecoderFromExtension(ctx *ctx, typ reflect2.Type) ValDecoder {
257 for _, extension := range extensions {
258 decoder := extension.CreateDecoder(typ)
263 decoder := ctx.decoderExtension.CreateDecoder(typ)
267 for _, extension := range ctx.extraExtensions {
268 decoder := extension.CreateDecoder(typ)
273 typeName := typ.String()
274 decoder = typeDecoders[typeName]
278 if typ.Kind() == reflect.Ptr {
279 ptrType := typ.(*reflect2.UnsafePtrType)
280 decoder := typeDecoders[ptrType.Elem().String()]
282 return &OptionalDecoder{ptrType.Elem(), decoder}
288 func getTypeEncoderFromExtension(ctx *ctx, typ reflect2.Type) ValEncoder {
289 encoder := _getTypeEncoderFromExtension(ctx, typ)
291 for _, extension := range extensions {
292 encoder = extension.DecorateEncoder(typ, encoder)
294 encoder = ctx.encoderExtension.DecorateEncoder(typ, encoder)
295 for _, extension := range ctx.extraExtensions {
296 encoder = extension.DecorateEncoder(typ, encoder)
302 func _getTypeEncoderFromExtension(ctx *ctx, typ reflect2.Type) ValEncoder {
303 for _, extension := range extensions {
304 encoder := extension.CreateEncoder(typ)
309 encoder := ctx.encoderExtension.CreateEncoder(typ)
313 for _, extension := range ctx.extraExtensions {
314 encoder := extension.CreateEncoder(typ)
319 typeName := typ.String()
320 encoder = typeEncoders[typeName]
324 if typ.Kind() == reflect.Ptr {
325 typePtr := typ.(*reflect2.UnsafePtrType)
326 encoder := typeEncoders[typePtr.Elem().String()]
328 return &OptionalEncoder{encoder}
334 func describeStruct(ctx *ctx, typ reflect2.Type) *StructDescriptor {
335 structType := typ.(*reflect2.UnsafeStructType)
336 embeddedBindings := []*Binding{}
337 bindings := []*Binding{}
338 for i := 0; i < structType.NumField(); i++ {
339 field := structType.Field(i)
340 tag, hastag := field.Tag().Lookup(ctx.getTagKey())
341 if ctx.onlyTaggedField && !hastag && !field.Anonymous() {
344 tagParts := strings.Split(tag, ",")
348 if field.Anonymous() && (tag == "" || tagParts[0] == "") {
349 if field.Type().Kind() == reflect.Struct {
350 structDescriptor := describeStruct(ctx, field.Type())
351 for _, binding := range structDescriptor.Fields {
352 binding.levels = append([]int{i}, binding.levels...)
353 omitempty := binding.Encoder.(*structFieldEncoder).omitempty
354 binding.Encoder = &structFieldEncoder{field, binding.Encoder, omitempty}
355 binding.Decoder = &structFieldDecoder{field, binding.Decoder}
356 embeddedBindings = append(embeddedBindings, binding)
359 } else if field.Type().Kind() == reflect.Ptr {
360 ptrType := field.Type().(*reflect2.UnsafePtrType)
361 if ptrType.Elem().Kind() == reflect.Struct {
362 structDescriptor := describeStruct(ctx, ptrType.Elem())
363 for _, binding := range structDescriptor.Fields {
364 binding.levels = append([]int{i}, binding.levels...)
365 omitempty := binding.Encoder.(*structFieldEncoder).omitempty
366 binding.Encoder = &dereferenceEncoder{binding.Encoder}
367 binding.Encoder = &structFieldEncoder{field, binding.Encoder, omitempty}
368 binding.Decoder = &dereferenceDecoder{ptrType.Elem(), binding.Decoder}
369 binding.Decoder = &structFieldDecoder{field, binding.Decoder}
370 embeddedBindings = append(embeddedBindings, binding)
376 fieldNames := calcFieldNames(field.Name(), tagParts[0], tag)
377 fieldCacheKey := fmt.Sprintf("%s/%s", typ.String(), field.Name())
378 decoder := fieldDecoders[fieldCacheKey]
380 decoder = decoderOfType(ctx.append(field.Name()), field.Type())
382 encoder := fieldEncoders[fieldCacheKey]
384 encoder = encoderOfType(ctx.append(field.Name()), field.Type())
388 FromNames: fieldNames,
393 binding.levels = []int{i}
394 bindings = append(bindings, binding)
396 return createStructDescriptor(ctx, typ, bindings, embeddedBindings)
398 func createStructDescriptor(ctx *ctx, typ reflect2.Type, bindings []*Binding, embeddedBindings []*Binding) *StructDescriptor {
399 structDescriptor := &StructDescriptor{
403 for _, extension := range extensions {
404 extension.UpdateStructDescriptor(structDescriptor)
406 ctx.encoderExtension.UpdateStructDescriptor(structDescriptor)
407 ctx.decoderExtension.UpdateStructDescriptor(structDescriptor)
408 for _, extension := range ctx.extraExtensions {
409 extension.UpdateStructDescriptor(structDescriptor)
411 processTags(structDescriptor, ctx.frozenConfig)
412 // merge normal & embedded bindings & sort with original order
413 allBindings := sortableBindings(append(embeddedBindings, structDescriptor.Fields...))
414 sort.Sort(allBindings)
415 structDescriptor.Fields = allBindings
416 return structDescriptor
419 type sortableBindings []*Binding
421 func (bindings sortableBindings) Len() int {
425 func (bindings sortableBindings) Less(i, j int) bool {
426 left := bindings[i].levels
427 right := bindings[j].levels
430 if left[k] < right[k] {
432 } else if left[k] > right[k] {
439 func (bindings sortableBindings) Swap(i, j int) {
440 bindings[i], bindings[j] = bindings[j], bindings[i]
443 func processTags(structDescriptor *StructDescriptor, cfg *frozenConfig) {
444 for _, binding := range structDescriptor.Fields {
445 shouldOmitEmpty := false
446 tagParts := strings.Split(binding.Field.Tag().Get(cfg.getTagKey()), ",")
447 for _, tagPart := range tagParts[1:] {
448 if tagPart == "omitempty" {
449 shouldOmitEmpty = true
450 } else if tagPart == "string" {
451 if binding.Field.Type().Kind() == reflect.String {
452 binding.Decoder = &stringModeStringDecoder{binding.Decoder, cfg}
453 binding.Encoder = &stringModeStringEncoder{binding.Encoder, cfg}
455 binding.Decoder = &stringModeNumberDecoder{binding.Decoder}
456 binding.Encoder = &stringModeNumberEncoder{binding.Encoder}
460 binding.Decoder = &structFieldDecoder{binding.Field, binding.Decoder}
461 binding.Encoder = &structFieldEncoder{binding.Field, binding.Encoder, shouldOmitEmpty}
465 func calcFieldNames(originalFieldName string, tagProvidedFieldName string, wholeTag string) []string {
471 var fieldNames []string
472 if tagProvidedFieldName == "" {
473 fieldNames = []string{originalFieldName}
475 fieldNames = []string{tagProvidedFieldName}
478 isNotExported := unicode.IsLower(rune(originalFieldName[0]))
480 fieldNames = []string{}