mirror of
				https://github.com/superseriousbusiness/gotosocial.git
				synced 2025-10-30 23:22:26 -05:00 
			
		
		
		
	[chore]: Bump github.com/gin-contrib/sessions from 0.0.5 to 1.0.0 (#2782)
This commit is contained in:
		
					parent
					
						
							
								a24936040c
							
						
					
				
			
			
				commit
				
					
						29031d1e27
					
				
			
		
					 93 changed files with 2888 additions and 969 deletions
				
			
		
							
								
								
									
										513
									
								
								vendor/go.mongodb.org/mongo-driver/bson/bsoncodec/registry.go
									
										
									
										generated
									
									
										vendored
									
									
								
							
							
						
						
									
										513
									
								
								vendor/go.mongodb.org/mongo-driver/bson/bsoncodec/registry.go
									
										
									
										generated
									
									
										vendored
									
									
								
							|  | @ -16,12 +16,18 @@ import ( | |||
| ) | ||||
| 
 | ||||
| // ErrNilType is returned when nil is passed to either LookupEncoder or LookupDecoder. | ||||
| // | ||||
| // Deprecated: ErrNilType will not be supported in Go Driver 2.0. | ||||
| var ErrNilType = errors.New("cannot perform a decoder lookup on <nil>") | ||||
| 
 | ||||
| // ErrNotPointer is returned when a non-pointer type is provided to LookupDecoder. | ||||
| // | ||||
| // Deprecated: ErrNotPointer will not be supported in Go Driver 2.0. | ||||
| var ErrNotPointer = errors.New("non-pointer provided to LookupDecoder") | ||||
| 
 | ||||
| // ErrNoEncoder is returned when there wasn't an encoder available for a type. | ||||
| // | ||||
| // Deprecated: ErrNoEncoder will not be supported in Go Driver 2.0. | ||||
| type ErrNoEncoder struct { | ||||
| 	Type reflect.Type | ||||
| } | ||||
|  | @ -34,6 +40,8 @@ func (ene ErrNoEncoder) Error() string { | |||
| } | ||||
| 
 | ||||
| // ErrNoDecoder is returned when there wasn't a decoder available for a type. | ||||
| // | ||||
| // Deprecated: ErrNoDecoder will not be supported in Go Driver 2.0. | ||||
| type ErrNoDecoder struct { | ||||
| 	Type reflect.Type | ||||
| } | ||||
|  | @ -43,6 +51,8 @@ func (end ErrNoDecoder) Error() string { | |||
| } | ||||
| 
 | ||||
| // ErrNoTypeMapEntry is returned when there wasn't a type available for the provided BSON type. | ||||
| // | ||||
| // Deprecated: ErrNoTypeMapEntry will not be supported in Go Driver 2.0. | ||||
| type ErrNoTypeMapEntry struct { | ||||
| 	Type bsontype.Type | ||||
| } | ||||
|  | @ -52,63 +62,30 @@ func (entme ErrNoTypeMapEntry) Error() string { | |||
| } | ||||
| 
 | ||||
| // ErrNotInterface is returned when the provided type is not an interface. | ||||
| // | ||||
| // Deprecated: ErrNotInterface will not be supported in Go Driver 2.0. | ||||
| var ErrNotInterface = errors.New("The provided type is not an interface") | ||||
| 
 | ||||
| // A RegistryBuilder is used to build a Registry. This type is not goroutine | ||||
| // safe. | ||||
| // | ||||
| // Deprecated: Use Registry instead. | ||||
| type RegistryBuilder struct { | ||||
| 	typeEncoders      map[reflect.Type]ValueEncoder | ||||
| 	interfaceEncoders []interfaceValueEncoder | ||||
| 	kindEncoders      map[reflect.Kind]ValueEncoder | ||||
| 
 | ||||
| 	typeDecoders      map[reflect.Type]ValueDecoder | ||||
| 	interfaceDecoders []interfaceValueDecoder | ||||
| 	kindDecoders      map[reflect.Kind]ValueDecoder | ||||
| 
 | ||||
| 	typeMap map[bsontype.Type]reflect.Type | ||||
| } | ||||
| 
 | ||||
| // A Registry is used to store and retrieve codecs for types and interfaces. This type is the main | ||||
| // typed passed around and Encoders and Decoders are constructed from it. | ||||
| type Registry struct { | ||||
| 	typeEncoders map[reflect.Type]ValueEncoder | ||||
| 	typeDecoders map[reflect.Type]ValueDecoder | ||||
| 
 | ||||
| 	interfaceEncoders []interfaceValueEncoder | ||||
| 	interfaceDecoders []interfaceValueDecoder | ||||
| 
 | ||||
| 	kindEncoders map[reflect.Kind]ValueEncoder | ||||
| 	kindDecoders map[reflect.Kind]ValueDecoder | ||||
| 
 | ||||
| 	typeMap map[bsontype.Type]reflect.Type | ||||
| 
 | ||||
| 	mu sync.RWMutex | ||||
| 	registry *Registry | ||||
| } | ||||
| 
 | ||||
| // NewRegistryBuilder creates a new empty RegistryBuilder. | ||||
| // | ||||
| // Deprecated: Use NewRegistry instead. | ||||
| func NewRegistryBuilder() *RegistryBuilder { | ||||
| 	return &RegistryBuilder{ | ||||
| 		typeEncoders: make(map[reflect.Type]ValueEncoder), | ||||
| 		typeDecoders: make(map[reflect.Type]ValueDecoder), | ||||
| 
 | ||||
| 		interfaceEncoders: make([]interfaceValueEncoder, 0), | ||||
| 		interfaceDecoders: make([]interfaceValueDecoder, 0), | ||||
| 
 | ||||
| 		kindEncoders: make(map[reflect.Kind]ValueEncoder), | ||||
| 		kindDecoders: make(map[reflect.Kind]ValueDecoder), | ||||
| 
 | ||||
| 		typeMap: make(map[bsontype.Type]reflect.Type), | ||||
| 		registry: NewRegistry(), | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| func buildDefaultRegistry() *Registry { | ||||
| 	rb := NewRegistryBuilder() | ||||
| 	defaultValueEncoders.RegisterDefaultEncoders(rb) | ||||
| 	defaultValueDecoders.RegisterDefaultDecoders(rb) | ||||
| 	return rb.Build() | ||||
| } | ||||
| 
 | ||||
| // RegisterCodec will register the provided ValueCodec for the provided type. | ||||
| // | ||||
| // Deprecated: Use Registry.RegisterTypeEncoder and Registry.RegisterTypeDecoder instead. | ||||
| func (rb *RegistryBuilder) RegisterCodec(t reflect.Type, codec ValueCodec) *RegistryBuilder { | ||||
| 	rb.RegisterTypeEncoder(t, codec) | ||||
| 	rb.RegisterTypeDecoder(t, codec) | ||||
|  | @ -120,31 +97,22 @@ func (rb *RegistryBuilder) RegisterCodec(t reflect.Type, codec ValueCodec) *Regi | |||
| // The type will be used directly, so an encoder can be registered for a type and a different encoder can be registered | ||||
| // for a pointer to that type. | ||||
| // | ||||
| // If the given type is an interface, the encoder will be called when marshalling a type that is that interface. It | ||||
| // will not be called when marshalling a non-interface type that implements the interface. | ||||
| // If the given type is an interface, the encoder will be called when marshaling a type that is that interface. It | ||||
| // will not be called when marshaling a non-interface type that implements the interface. | ||||
| // | ||||
| // Deprecated: Use Registry.RegisterTypeEncoder instead. | ||||
| func (rb *RegistryBuilder) RegisterTypeEncoder(t reflect.Type, enc ValueEncoder) *RegistryBuilder { | ||||
| 	rb.typeEncoders[t] = enc | ||||
| 	rb.registry.RegisterTypeEncoder(t, enc) | ||||
| 	return rb | ||||
| } | ||||
| 
 | ||||
| // RegisterHookEncoder will register an encoder for the provided interface type t. This encoder will be called when | ||||
| // marshalling a type if the type implements t or a pointer to the type implements t. If the provided type is not | ||||
| // marshaling a type if the type implements t or a pointer to the type implements t. If the provided type is not | ||||
| // an interface (i.e. t.Kind() != reflect.Interface), this method will panic. | ||||
| // | ||||
| // Deprecated: Use Registry.RegisterInterfaceEncoder instead. | ||||
| func (rb *RegistryBuilder) RegisterHookEncoder(t reflect.Type, enc ValueEncoder) *RegistryBuilder { | ||||
| 	if t.Kind() != reflect.Interface { | ||||
| 		panicStr := fmt.Sprintf("RegisterHookEncoder expects a type with kind reflect.Interface, "+ | ||||
| 			"got type %s with kind %s", t, t.Kind()) | ||||
| 		panic(panicStr) | ||||
| 	} | ||||
| 
 | ||||
| 	for idx, encoder := range rb.interfaceEncoders { | ||||
| 		if encoder.i == t { | ||||
| 			rb.interfaceEncoders[idx].ve = enc | ||||
| 			return rb | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	rb.interfaceEncoders = append(rb.interfaceEncoders, interfaceValueEncoder{i: t, ve: enc}) | ||||
| 	rb.registry.RegisterInterfaceEncoder(t, enc) | ||||
| 	return rb | ||||
| } | ||||
| 
 | ||||
|  | @ -153,97 +121,78 @@ func (rb *RegistryBuilder) RegisterHookEncoder(t reflect.Type, enc ValueEncoder) | |||
| // The type will be used directly, so a decoder can be registered for a type and a different decoder can be registered | ||||
| // for a pointer to that type. | ||||
| // | ||||
| // If the given type is an interface, the decoder will be called when unmarshalling into a type that is that interface. | ||||
| // It will not be called when unmarshalling into a non-interface type that implements the interface. | ||||
| // If the given type is an interface, the decoder will be called when unmarshaling into a type that is that interface. | ||||
| // It will not be called when unmarshaling into a non-interface type that implements the interface. | ||||
| // | ||||
| // Deprecated: Use Registry.RegisterTypeDecoder instead. | ||||
| func (rb *RegistryBuilder) RegisterTypeDecoder(t reflect.Type, dec ValueDecoder) *RegistryBuilder { | ||||
| 	rb.typeDecoders[t] = dec | ||||
| 	rb.registry.RegisterTypeDecoder(t, dec) | ||||
| 	return rb | ||||
| } | ||||
| 
 | ||||
| // RegisterHookDecoder will register an decoder for the provided interface type t. This decoder will be called when | ||||
| // unmarshalling into a type if the type implements t or a pointer to the type implements t. If the provided type is not | ||||
| // unmarshaling into a type if the type implements t or a pointer to the type implements t. If the provided type is not | ||||
| // an interface (i.e. t.Kind() != reflect.Interface), this method will panic. | ||||
| // | ||||
| // Deprecated: Use Registry.RegisterInterfaceDecoder instead. | ||||
| func (rb *RegistryBuilder) RegisterHookDecoder(t reflect.Type, dec ValueDecoder) *RegistryBuilder { | ||||
| 	if t.Kind() != reflect.Interface { | ||||
| 		panicStr := fmt.Sprintf("RegisterHookDecoder expects a type with kind reflect.Interface, "+ | ||||
| 			"got type %s with kind %s", t, t.Kind()) | ||||
| 		panic(panicStr) | ||||
| 	} | ||||
| 
 | ||||
| 	for idx, decoder := range rb.interfaceDecoders { | ||||
| 		if decoder.i == t { | ||||
| 			rb.interfaceDecoders[idx].vd = dec | ||||
| 			return rb | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	rb.interfaceDecoders = append(rb.interfaceDecoders, interfaceValueDecoder{i: t, vd: dec}) | ||||
| 	rb.registry.RegisterInterfaceDecoder(t, dec) | ||||
| 	return rb | ||||
| } | ||||
| 
 | ||||
| // RegisterEncoder registers the provided type and encoder pair. | ||||
| // | ||||
| // Deprecated: Use RegisterTypeEncoder or RegisterHookEncoder instead. | ||||
| // Deprecated: Use Registry.RegisterTypeEncoder or Registry.RegisterInterfaceEncoder instead. | ||||
| func (rb *RegistryBuilder) RegisterEncoder(t reflect.Type, enc ValueEncoder) *RegistryBuilder { | ||||
| 	if t == tEmpty { | ||||
| 		rb.typeEncoders[t] = enc | ||||
| 		rb.registry.RegisterTypeEncoder(t, enc) | ||||
| 		return rb | ||||
| 	} | ||||
| 	switch t.Kind() { | ||||
| 	case reflect.Interface: | ||||
| 		for idx, ir := range rb.interfaceEncoders { | ||||
| 			if ir.i == t { | ||||
| 				rb.interfaceEncoders[idx].ve = enc | ||||
| 				return rb | ||||
| 			} | ||||
| 		} | ||||
| 
 | ||||
| 		rb.interfaceEncoders = append(rb.interfaceEncoders, interfaceValueEncoder{i: t, ve: enc}) | ||||
| 		rb.registry.RegisterInterfaceEncoder(t, enc) | ||||
| 	default: | ||||
| 		rb.typeEncoders[t] = enc | ||||
| 		rb.registry.RegisterTypeEncoder(t, enc) | ||||
| 	} | ||||
| 	return rb | ||||
| } | ||||
| 
 | ||||
| // RegisterDecoder registers the provided type and decoder pair. | ||||
| // | ||||
| // Deprecated: Use RegisterTypeDecoder or RegisterHookDecoder instead. | ||||
| // Deprecated: Use Registry.RegisterTypeDecoder or Registry.RegisterInterfaceDecoder instead. | ||||
| func (rb *RegistryBuilder) RegisterDecoder(t reflect.Type, dec ValueDecoder) *RegistryBuilder { | ||||
| 	if t == nil { | ||||
| 		rb.typeDecoders[nil] = dec | ||||
| 		rb.registry.RegisterTypeDecoder(t, dec) | ||||
| 		return rb | ||||
| 	} | ||||
| 	if t == tEmpty { | ||||
| 		rb.typeDecoders[t] = dec | ||||
| 		rb.registry.RegisterTypeDecoder(t, dec) | ||||
| 		return rb | ||||
| 	} | ||||
| 	switch t.Kind() { | ||||
| 	case reflect.Interface: | ||||
| 		for idx, ir := range rb.interfaceDecoders { | ||||
| 			if ir.i == t { | ||||
| 				rb.interfaceDecoders[idx].vd = dec | ||||
| 				return rb | ||||
| 			} | ||||
| 		} | ||||
| 
 | ||||
| 		rb.interfaceDecoders = append(rb.interfaceDecoders, interfaceValueDecoder{i: t, vd: dec}) | ||||
| 		rb.registry.RegisterInterfaceDecoder(t, dec) | ||||
| 	default: | ||||
| 		rb.typeDecoders[t] = dec | ||||
| 		rb.registry.RegisterTypeDecoder(t, dec) | ||||
| 	} | ||||
| 	return rb | ||||
| } | ||||
| 
 | ||||
| // RegisterDefaultEncoder will registr the provided ValueEncoder to the provided | ||||
| // RegisterDefaultEncoder will register the provided ValueEncoder to the provided | ||||
| // kind. | ||||
| // | ||||
| // Deprecated: Use Registry.RegisterKindEncoder instead. | ||||
| func (rb *RegistryBuilder) RegisterDefaultEncoder(kind reflect.Kind, enc ValueEncoder) *RegistryBuilder { | ||||
| 	rb.kindEncoders[kind] = enc | ||||
| 	rb.registry.RegisterKindEncoder(kind, enc) | ||||
| 	return rb | ||||
| } | ||||
| 
 | ||||
| // RegisterDefaultDecoder will register the provided ValueDecoder to the | ||||
| // provided kind. | ||||
| // | ||||
| // Deprecated: Use Registry.RegisterKindDecoder instead. | ||||
| func (rb *RegistryBuilder) RegisterDefaultDecoder(kind reflect.Kind, dec ValueDecoder) *RegistryBuilder { | ||||
| 	rb.kindDecoders[kind] = dec | ||||
| 	rb.registry.RegisterKindDecoder(kind, dec) | ||||
| 	return rb | ||||
| } | ||||
| 
 | ||||
|  | @ -256,120 +205,233 @@ func (rb *RegistryBuilder) RegisterDefaultDecoder(kind reflect.Kind, dec ValueDe | |||
| // to decode to bson.Raw, use the following code: | ||||
| // | ||||
| //	rb.RegisterTypeMapEntry(bsontype.EmbeddedDocument, reflect.TypeOf(bson.Raw{})) | ||||
| // | ||||
| // Deprecated: Use Registry.RegisterTypeMapEntry instead. | ||||
| func (rb *RegistryBuilder) RegisterTypeMapEntry(bt bsontype.Type, rt reflect.Type) *RegistryBuilder { | ||||
| 	rb.typeMap[bt] = rt | ||||
| 	rb.registry.RegisterTypeMapEntry(bt, rt) | ||||
| 	return rb | ||||
| } | ||||
| 
 | ||||
| // Build creates a Registry from the current state of this RegistryBuilder. | ||||
| // | ||||
| // Deprecated: Use NewRegistry instead. | ||||
| func (rb *RegistryBuilder) Build() *Registry { | ||||
| 	registry := new(Registry) | ||||
| 
 | ||||
| 	registry.typeEncoders = make(map[reflect.Type]ValueEncoder) | ||||
| 	for t, enc := range rb.typeEncoders { | ||||
| 		registry.typeEncoders[t] = enc | ||||
| 	r := &Registry{ | ||||
| 		interfaceEncoders: append([]interfaceValueEncoder(nil), rb.registry.interfaceEncoders...), | ||||
| 		interfaceDecoders: append([]interfaceValueDecoder(nil), rb.registry.interfaceDecoders...), | ||||
| 		typeEncoders:      rb.registry.typeEncoders.Clone(), | ||||
| 		typeDecoders:      rb.registry.typeDecoders.Clone(), | ||||
| 		kindEncoders:      rb.registry.kindEncoders.Clone(), | ||||
| 		kindDecoders:      rb.registry.kindDecoders.Clone(), | ||||
| 	} | ||||
| 
 | ||||
| 	registry.typeDecoders = make(map[reflect.Type]ValueDecoder) | ||||
| 	for t, dec := range rb.typeDecoders { | ||||
| 		registry.typeDecoders[t] = dec | ||||
| 	} | ||||
| 
 | ||||
| 	registry.interfaceEncoders = make([]interfaceValueEncoder, len(rb.interfaceEncoders)) | ||||
| 	copy(registry.interfaceEncoders, rb.interfaceEncoders) | ||||
| 
 | ||||
| 	registry.interfaceDecoders = make([]interfaceValueDecoder, len(rb.interfaceDecoders)) | ||||
| 	copy(registry.interfaceDecoders, rb.interfaceDecoders) | ||||
| 
 | ||||
| 	registry.kindEncoders = make(map[reflect.Kind]ValueEncoder) | ||||
| 	for kind, enc := range rb.kindEncoders { | ||||
| 		registry.kindEncoders[kind] = enc | ||||
| 	} | ||||
| 
 | ||||
| 	registry.kindDecoders = make(map[reflect.Kind]ValueDecoder) | ||||
| 	for kind, dec := range rb.kindDecoders { | ||||
| 		registry.kindDecoders[kind] = dec | ||||
| 	} | ||||
| 
 | ||||
| 	registry.typeMap = make(map[bsontype.Type]reflect.Type) | ||||
| 	for bt, rt := range rb.typeMap { | ||||
| 		registry.typeMap[bt] = rt | ||||
| 	} | ||||
| 
 | ||||
| 	return registry | ||||
| 	rb.registry.typeMap.Range(func(k, v interface{}) bool { | ||||
| 		if k != nil && v != nil { | ||||
| 			r.typeMap.Store(k, v) | ||||
| 		} | ||||
| 		return true | ||||
| 	}) | ||||
| 	return r | ||||
| } | ||||
| 
 | ||||
| // LookupEncoder inspects the registry for an encoder for the given type. The lookup precedence works as follows: | ||||
| // A Registry is used to store and retrieve codecs for types and interfaces. This type is the main | ||||
| // typed passed around and Encoders and Decoders are constructed from it. | ||||
| type Registry struct { | ||||
| 	interfaceEncoders []interfaceValueEncoder | ||||
| 	interfaceDecoders []interfaceValueDecoder | ||||
| 	typeEncoders      *typeEncoderCache | ||||
| 	typeDecoders      *typeDecoderCache | ||||
| 	kindEncoders      *kindEncoderCache | ||||
| 	kindDecoders      *kindDecoderCache | ||||
| 	typeMap           sync.Map // map[bsontype.Type]reflect.Type | ||||
| } | ||||
| 
 | ||||
| // NewRegistry creates a new empty Registry. | ||||
| func NewRegistry() *Registry { | ||||
| 	return &Registry{ | ||||
| 		typeEncoders: new(typeEncoderCache), | ||||
| 		typeDecoders: new(typeDecoderCache), | ||||
| 		kindEncoders: new(kindEncoderCache), | ||||
| 		kindDecoders: new(kindDecoderCache), | ||||
| 	} | ||||
| } | ||||
| 
 | ||||
| // RegisterTypeEncoder registers the provided ValueEncoder for the provided type. | ||||
| // | ||||
| // 1. An encoder registered for the exact type. If the given type represents an interface, an encoder registered using | ||||
| // RegisterTypeEncoder for the interface will be selected. | ||||
| // The type will be used as provided, so an encoder can be registered for a type and a different | ||||
| // encoder can be registered for a pointer to that type. | ||||
| // | ||||
| // 2. An encoder registered using RegisterHookEncoder for an interface implemented by the type or by a pointer to the | ||||
| // type. | ||||
| // If the given type is an interface, the encoder will be called when marshaling a type that is | ||||
| // that interface. It will not be called when marshaling a non-interface type that implements the | ||||
| // interface. To get the latter behavior, call RegisterHookEncoder instead. | ||||
| // | ||||
| // 3. An encoder registered for the reflect.Kind of the value. | ||||
| // RegisterTypeEncoder should not be called concurrently with any other Registry method. | ||||
| func (r *Registry) RegisterTypeEncoder(valueType reflect.Type, enc ValueEncoder) { | ||||
| 	r.typeEncoders.Store(valueType, enc) | ||||
| } | ||||
| 
 | ||||
| // RegisterTypeDecoder registers the provided ValueDecoder for the provided type. | ||||
| // | ||||
| // If no encoder is found, an error of type ErrNoEncoder is returned. | ||||
| func (r *Registry) LookupEncoder(t reflect.Type) (ValueEncoder, error) { | ||||
| 	encodererr := ErrNoEncoder{Type: t} | ||||
| 	r.mu.RLock() | ||||
| 	enc, found := r.lookupTypeEncoder(t) | ||||
| 	r.mu.RUnlock() | ||||
| // The type will be used as provided, so a decoder can be registered for a type and a different | ||||
| // decoder can be registered for a pointer to that type. | ||||
| // | ||||
| // If the given type is an interface, the decoder will be called when unmarshaling into a type that | ||||
| // is that interface. It will not be called when unmarshaling into a non-interface type that | ||||
| // implements the interface. To get the latter behavior, call RegisterHookDecoder instead. | ||||
| // | ||||
| // RegisterTypeDecoder should not be called concurrently with any other Registry method. | ||||
| func (r *Registry) RegisterTypeDecoder(valueType reflect.Type, dec ValueDecoder) { | ||||
| 	r.typeDecoders.Store(valueType, dec) | ||||
| } | ||||
| 
 | ||||
| // RegisterKindEncoder registers the provided ValueEncoder for the provided kind. | ||||
| // | ||||
| // Use RegisterKindEncoder to register an encoder for any type with the same underlying kind. For | ||||
| // example, consider the type MyInt defined as | ||||
| // | ||||
| //	type MyInt int32 | ||||
| // | ||||
| // To define an encoder for MyInt and int32, use RegisterKindEncoder like | ||||
| // | ||||
| //	reg.RegisterKindEncoder(reflect.Int32, myEncoder) | ||||
| // | ||||
| // RegisterKindEncoder should not be called concurrently with any other Registry method. | ||||
| func (r *Registry) RegisterKindEncoder(kind reflect.Kind, enc ValueEncoder) { | ||||
| 	r.kindEncoders.Store(kind, enc) | ||||
| } | ||||
| 
 | ||||
| // RegisterKindDecoder registers the provided ValueDecoder for the provided kind. | ||||
| // | ||||
| // Use RegisterKindDecoder to register a decoder for any type with the same underlying kind. For | ||||
| // example, consider the type MyInt defined as | ||||
| // | ||||
| //	type MyInt int32 | ||||
| // | ||||
| // To define an decoder for MyInt and int32, use RegisterKindDecoder like | ||||
| // | ||||
| //	reg.RegisterKindDecoder(reflect.Int32, myDecoder) | ||||
| // | ||||
| // RegisterKindDecoder should not be called concurrently with any other Registry method. | ||||
| func (r *Registry) RegisterKindDecoder(kind reflect.Kind, dec ValueDecoder) { | ||||
| 	r.kindDecoders.Store(kind, dec) | ||||
| } | ||||
| 
 | ||||
| // RegisterInterfaceEncoder registers an encoder for the provided interface type iface. This encoder will | ||||
| // be called when marshaling a type if the type implements iface or a pointer to the type | ||||
| // implements iface. If the provided type is not an interface | ||||
| // (i.e. iface.Kind() != reflect.Interface), this method will panic. | ||||
| // | ||||
| // RegisterInterfaceEncoder should not be called concurrently with any other Registry method. | ||||
| func (r *Registry) RegisterInterfaceEncoder(iface reflect.Type, enc ValueEncoder) { | ||||
| 	if iface.Kind() != reflect.Interface { | ||||
| 		panicStr := fmt.Errorf("RegisterInterfaceEncoder expects a type with kind reflect.Interface, "+ | ||||
| 			"got type %s with kind %s", iface, iface.Kind()) | ||||
| 		panic(panicStr) | ||||
| 	} | ||||
| 
 | ||||
| 	for idx, encoder := range r.interfaceEncoders { | ||||
| 		if encoder.i == iface { | ||||
| 			r.interfaceEncoders[idx].ve = enc | ||||
| 			return | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	r.interfaceEncoders = append(r.interfaceEncoders, interfaceValueEncoder{i: iface, ve: enc}) | ||||
| } | ||||
| 
 | ||||
| // RegisterInterfaceDecoder registers an decoder for the provided interface type iface. This decoder will | ||||
| // be called when unmarshaling into a type if the type implements iface or a pointer to the type | ||||
| // implements iface. If the provided type is not an interface (i.e. iface.Kind() != reflect.Interface), | ||||
| // this method will panic. | ||||
| // | ||||
| // RegisterInterfaceDecoder should not be called concurrently with any other Registry method. | ||||
| func (r *Registry) RegisterInterfaceDecoder(iface reflect.Type, dec ValueDecoder) { | ||||
| 	if iface.Kind() != reflect.Interface { | ||||
| 		panicStr := fmt.Errorf("RegisterInterfaceDecoder expects a type with kind reflect.Interface, "+ | ||||
| 			"got type %s with kind %s", iface, iface.Kind()) | ||||
| 		panic(panicStr) | ||||
| 	} | ||||
| 
 | ||||
| 	for idx, decoder := range r.interfaceDecoders { | ||||
| 		if decoder.i == iface { | ||||
| 			r.interfaceDecoders[idx].vd = dec | ||||
| 			return | ||||
| 		} | ||||
| 	} | ||||
| 
 | ||||
| 	r.interfaceDecoders = append(r.interfaceDecoders, interfaceValueDecoder{i: iface, vd: dec}) | ||||
| } | ||||
| 
 | ||||
| // RegisterTypeMapEntry will register the provided type to the BSON type. The primary usage for this | ||||
| // mapping is decoding situations where an empty interface is used and a default type needs to be | ||||
| // created and decoded into. | ||||
| // | ||||
| // By default, BSON documents will decode into interface{} values as bson.D. To change the default type for BSON | ||||
| // documents, a type map entry for bsontype.EmbeddedDocument should be registered. For example, to force BSON documents | ||||
| // to decode to bson.Raw, use the following code: | ||||
| // | ||||
| //	reg.RegisterTypeMapEntry(bsontype.EmbeddedDocument, reflect.TypeOf(bson.Raw{})) | ||||
| func (r *Registry) RegisterTypeMapEntry(bt bsontype.Type, rt reflect.Type) { | ||||
| 	r.typeMap.Store(bt, rt) | ||||
| } | ||||
| 
 | ||||
| // LookupEncoder returns the first matching encoder in the Registry. It uses the following lookup | ||||
| // order: | ||||
| // | ||||
| // 1. An encoder registered for the exact type. If the given type is an interface, an encoder | ||||
| // registered using RegisterTypeEncoder for that interface will be selected. | ||||
| // | ||||
| // 2. An encoder registered using RegisterInterfaceEncoder for an interface implemented by the type | ||||
| // or by a pointer to the type. | ||||
| // | ||||
| // 3. An encoder registered using RegisterKindEncoder for the kind of value. | ||||
| // | ||||
| // If no encoder is found, an error of type ErrNoEncoder is returned. LookupEncoder is safe for | ||||
| // concurrent use by multiple goroutines after all codecs and encoders are registered. | ||||
| func (r *Registry) LookupEncoder(valueType reflect.Type) (ValueEncoder, error) { | ||||
| 	if valueType == nil { | ||||
| 		return nil, ErrNoEncoder{Type: valueType} | ||||
| 	} | ||||
| 	enc, found := r.lookupTypeEncoder(valueType) | ||||
| 	if found { | ||||
| 		if enc == nil { | ||||
| 			return nil, ErrNoEncoder{Type: t} | ||||
| 			return nil, ErrNoEncoder{Type: valueType} | ||||
| 		} | ||||
| 		return enc, nil | ||||
| 	} | ||||
| 
 | ||||
| 	enc, found = r.lookupInterfaceEncoder(t, true) | ||||
| 	enc, found = r.lookupInterfaceEncoder(valueType, true) | ||||
| 	if found { | ||||
| 		r.mu.Lock() | ||||
| 		r.typeEncoders[t] = enc | ||||
| 		r.mu.Unlock() | ||||
| 		return enc, nil | ||||
| 		return r.typeEncoders.LoadOrStore(valueType, enc), nil | ||||
| 	} | ||||
| 
 | ||||
| 	if t == nil { | ||||
| 		r.mu.Lock() | ||||
| 		r.typeEncoders[t] = nil | ||||
| 		r.mu.Unlock() | ||||
| 		return nil, encodererr | ||||
| 	if v, ok := r.kindEncoders.Load(valueType.Kind()); ok { | ||||
| 		return r.storeTypeEncoder(valueType, v), nil | ||||
| 	} | ||||
| 
 | ||||
| 	enc, found = r.kindEncoders[t.Kind()] | ||||
| 	if !found { | ||||
| 		r.mu.Lock() | ||||
| 		r.typeEncoders[t] = nil | ||||
| 		r.mu.Unlock() | ||||
| 		return nil, encodererr | ||||
| 	} | ||||
| 
 | ||||
| 	r.mu.Lock() | ||||
| 	r.typeEncoders[t] = enc | ||||
| 	r.mu.Unlock() | ||||
| 	return enc, nil | ||||
| 	return nil, ErrNoEncoder{Type: valueType} | ||||
| } | ||||
| 
 | ||||
| func (r *Registry) lookupTypeEncoder(t reflect.Type) (ValueEncoder, bool) { | ||||
| 	enc, found := r.typeEncoders[t] | ||||
| 	return enc, found | ||||
| func (r *Registry) storeTypeEncoder(rt reflect.Type, enc ValueEncoder) ValueEncoder { | ||||
| 	return r.typeEncoders.LoadOrStore(rt, enc) | ||||
| } | ||||
| 
 | ||||
| func (r *Registry) lookupInterfaceEncoder(t reflect.Type, allowAddr bool) (ValueEncoder, bool) { | ||||
| 	if t == nil { | ||||
| func (r *Registry) lookupTypeEncoder(rt reflect.Type) (ValueEncoder, bool) { | ||||
| 	return r.typeEncoders.Load(rt) | ||||
| } | ||||
| 
 | ||||
| func (r *Registry) lookupInterfaceEncoder(valueType reflect.Type, allowAddr bool) (ValueEncoder, bool) { | ||||
| 	if valueType == nil { | ||||
| 		return nil, false | ||||
| 	} | ||||
| 	for _, ienc := range r.interfaceEncoders { | ||||
| 		if t.Implements(ienc.i) { | ||||
| 		if valueType.Implements(ienc.i) { | ||||
| 			return ienc.ve, true | ||||
| 		} | ||||
| 		if allowAddr && t.Kind() != reflect.Ptr && reflect.PtrTo(t).Implements(ienc.i) { | ||||
| 			// if *t implements an interface, this will catch if t implements an interface further ahead | ||||
| 			// in interfaceEncoders | ||||
| 			defaultEnc, found := r.lookupInterfaceEncoder(t, false) | ||||
| 		if allowAddr && valueType.Kind() != reflect.Ptr && reflect.PtrTo(valueType).Implements(ienc.i) { | ||||
| 			// if *t implements an interface, this will catch if t implements an interface further | ||||
| 			// ahead in interfaceEncoders | ||||
| 			defaultEnc, found := r.lookupInterfaceEncoder(valueType, false) | ||||
| 			if !found { | ||||
| 				defaultEnc = r.kindEncoders[t.Kind()] | ||||
| 				defaultEnc, _ = r.kindEncoders.Load(valueType.Kind()) | ||||
| 			} | ||||
| 			return newCondAddrEncoder(ienc.ve, defaultEnc), true | ||||
| 		} | ||||
|  | @ -377,70 +439,61 @@ func (r *Registry) lookupInterfaceEncoder(t reflect.Type, allowAddr bool) (Value | |||
| 	return nil, false | ||||
| } | ||||
| 
 | ||||
| // LookupDecoder inspects the registry for an decoder for the given type. The lookup precedence works as follows: | ||||
| // LookupDecoder returns the first matching decoder in the Registry. It uses the following lookup | ||||
| // order: | ||||
| // | ||||
| // 1. A decoder registered for the exact type. If the given type represents an interface, a decoder registered using | ||||
| // RegisterTypeDecoder for the interface will be selected. | ||||
| // 1. A decoder registered for the exact type. If the given type is an interface, a decoder | ||||
| // registered using RegisterTypeDecoder for that interface will be selected. | ||||
| // | ||||
| // 2. A decoder registered using RegisterHookDecoder for an interface implemented by the type or by a pointer to the | ||||
| // type. | ||||
| // 2. A decoder registered using RegisterInterfaceDecoder for an interface implemented by the type or by | ||||
| // a pointer to the type. | ||||
| // | ||||
| // 3. A decoder registered for the reflect.Kind of the value. | ||||
| // 3. A decoder registered using RegisterKindDecoder for the kind of value. | ||||
| // | ||||
| // If no decoder is found, an error of type ErrNoDecoder is returned. | ||||
| func (r *Registry) LookupDecoder(t reflect.Type) (ValueDecoder, error) { | ||||
| 	if t == nil { | ||||
| // If no decoder is found, an error of type ErrNoDecoder is returned. LookupDecoder is safe for | ||||
| // concurrent use by multiple goroutines after all codecs and decoders are registered. | ||||
| func (r *Registry) LookupDecoder(valueType reflect.Type) (ValueDecoder, error) { | ||||
| 	if valueType == nil { | ||||
| 		return nil, ErrNilType | ||||
| 	} | ||||
| 	decodererr := ErrNoDecoder{Type: t} | ||||
| 	r.mu.RLock() | ||||
| 	dec, found := r.lookupTypeDecoder(t) | ||||
| 	r.mu.RUnlock() | ||||
| 	dec, found := r.lookupTypeDecoder(valueType) | ||||
| 	if found { | ||||
| 		if dec == nil { | ||||
| 			return nil, ErrNoDecoder{Type: t} | ||||
| 			return nil, ErrNoDecoder{Type: valueType} | ||||
| 		} | ||||
| 		return dec, nil | ||||
| 	} | ||||
| 
 | ||||
| 	dec, found = r.lookupInterfaceDecoder(t, true) | ||||
| 	dec, found = r.lookupInterfaceDecoder(valueType, true) | ||||
| 	if found { | ||||
| 		r.mu.Lock() | ||||
| 		r.typeDecoders[t] = dec | ||||
| 		r.mu.Unlock() | ||||
| 		return dec, nil | ||||
| 		return r.storeTypeDecoder(valueType, dec), nil | ||||
| 	} | ||||
| 
 | ||||
| 	dec, found = r.kindDecoders[t.Kind()] | ||||
| 	if !found { | ||||
| 		r.mu.Lock() | ||||
| 		r.typeDecoders[t] = nil | ||||
| 		r.mu.Unlock() | ||||
| 		return nil, decodererr | ||||
| 	if v, ok := r.kindDecoders.Load(valueType.Kind()); ok { | ||||
| 		return r.storeTypeDecoder(valueType, v), nil | ||||
| 	} | ||||
| 
 | ||||
| 	r.mu.Lock() | ||||
| 	r.typeDecoders[t] = dec | ||||
| 	r.mu.Unlock() | ||||
| 	return dec, nil | ||||
| 	return nil, ErrNoDecoder{Type: valueType} | ||||
| } | ||||
| 
 | ||||
| func (r *Registry) lookupTypeDecoder(t reflect.Type) (ValueDecoder, bool) { | ||||
| 	dec, found := r.typeDecoders[t] | ||||
| 	return dec, found | ||||
| func (r *Registry) lookupTypeDecoder(valueType reflect.Type) (ValueDecoder, bool) { | ||||
| 	return r.typeDecoders.Load(valueType) | ||||
| } | ||||
| 
 | ||||
| func (r *Registry) lookupInterfaceDecoder(t reflect.Type, allowAddr bool) (ValueDecoder, bool) { | ||||
| func (r *Registry) storeTypeDecoder(typ reflect.Type, dec ValueDecoder) ValueDecoder { | ||||
| 	return r.typeDecoders.LoadOrStore(typ, dec) | ||||
| } | ||||
| 
 | ||||
| func (r *Registry) lookupInterfaceDecoder(valueType reflect.Type, allowAddr bool) (ValueDecoder, bool) { | ||||
| 	for _, idec := range r.interfaceDecoders { | ||||
| 		if t.Implements(idec.i) { | ||||
| 		if valueType.Implements(idec.i) { | ||||
| 			return idec.vd, true | ||||
| 		} | ||||
| 		if allowAddr && t.Kind() != reflect.Ptr && reflect.PtrTo(t).Implements(idec.i) { | ||||
| 			// if *t implements an interface, this will catch if t implements an interface further ahead | ||||
| 			// in interfaceDecoders | ||||
| 			defaultDec, found := r.lookupInterfaceDecoder(t, false) | ||||
| 		if allowAddr && valueType.Kind() != reflect.Ptr && reflect.PtrTo(valueType).Implements(idec.i) { | ||||
| 			// if *t implements an interface, this will catch if t implements an interface further | ||||
| 			// ahead in interfaceDecoders | ||||
| 			defaultDec, found := r.lookupInterfaceDecoder(valueType, false) | ||||
| 			if !found { | ||||
| 				defaultDec = r.kindDecoders[t.Kind()] | ||||
| 				defaultDec, _ = r.kindDecoders.Load(valueType.Kind()) | ||||
| 			} | ||||
| 			return newCondAddrDecoder(idec.vd, defaultDec), true | ||||
| 		} | ||||
|  | @ -450,12 +503,14 @@ func (r *Registry) lookupInterfaceDecoder(t reflect.Type, allowAddr bool) (Value | |||
| 
 | ||||
| // LookupTypeMapEntry inspects the registry's type map for a Go type for the corresponding BSON | ||||
| // type. If no type is found, ErrNoTypeMapEntry is returned. | ||||
| // | ||||
| // LookupTypeMapEntry should not be called concurrently with any other Registry method. | ||||
| func (r *Registry) LookupTypeMapEntry(bt bsontype.Type) (reflect.Type, error) { | ||||
| 	t, ok := r.typeMap[bt] | ||||
| 	if !ok || t == nil { | ||||
| 	v, ok := r.typeMap.Load(bt) | ||||
| 	if v == nil || !ok { | ||||
| 		return nil, ErrNoTypeMapEntry{Type: bt} | ||||
| 	} | ||||
| 	return t, nil | ||||
| 	return v.(reflect.Type), nil | ||||
| } | ||||
| 
 | ||||
| type interfaceValueEncoder struct { | ||||
|  |  | |||
		Loading…
	
	Add table
		Add a link
		
	
		Reference in a new issue