org.bson.codecs.configuration

Class RootCodecRegistry

java.lang.Object

org.bson.codecs.configuration.RootCodecRegistry

All Implemented Interfaces:

CodecRegistry

public class RootCodecRegistry
extends Object
implements CodecRegistry

A registry of Codec instances searchable by the class that the Codec can encode and decode. This class can handle cycles of Codec dependencies, i.e when the construction of a Codec for class A requires the construction of a Codec for class B, and vice versa.

Since:

3.0

Constructor Summary

Constructors

Constructor and Description
RootCodecRegistry(List<? extends CodecProvider> codecProviders) Construct a new CodecRegistry from the given list if CodecProvider instances.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
<T> Codec<T>	get(Class<T> clazz) Gets a Codec for the given Class.
int	hashCode()
<T> RootCodecRegistry	withCodec(Codec<T> codec) Creates a new registry which is identical to this with the addition of the given codec.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RootCodecRegistry

public RootCodecRegistry(List<? extends CodecProvider> codecProviders)

Construct a new CodecRegistry from the given list if CodecProvider instances. The registry will use the codec providers to find Codec instances, consulting each provider in order, and return the first Codec found. Therefore, care should be taken to order the codec providers to achieve the desired behavior.

Parameters:

codecProviders - the list of codec providers

Method Detail

withCodec

public <T> RootCodecRegistry withCodec(Codec<T> codec)

Creates a new registry which is identical to this with the addition of the given codec. Any codecs added with this method will take precedence over codecs that may be returned from the codec providers.

Type Parameters:

T - the class type of the codec

Parameters:

codec - the codec

Returns:

the new registry

get

public <T> Codec<T> get(Class<T> clazz)

Gets a Codec for the given Class.

Specified by:

get in interface CodecRegistry

Type Parameters:

T - the class type

Parameters:

clazz - the class

Returns:

a codec for the given class

Throws:

CodecConfigurationException - if the registry does not contain a codec for the given class.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object