Module tools.jackson.databind

Package tools.jackson.databind.module

Class SimpleSerializers

java.lang.Object

tools.jackson.databind.ser.Serializers.Base

tools.jackson.databind.module.SimpleSerializers

All Implemented Interfaces:

Serializable, Serializers

public class SimpleSerializers
extends Serializers.Base
implements Serializable

Simple implementation Serializers which allows registration of serializers based on raw (type erased class). It can work well for basic bean and scalar type serializers, but is not a good fit for handling generic types (like Maps and Collections).

Type registrations are assumed to be general; meaning that registration of serializer for a super type will also be used for handling subtypes, unless an exact match is found first. As an example, handler for CharSequence would also be used serializing StringBuilder instances, unless a direct mapping was found.

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface tools.jackson.databind.ser.Serializers

Serializers.Base

Field Summary

Fields

Modifier and Type	Field	Description
protected HashMap<ClassKey,ValueSerializer<?>>	_classMappings	Class-based mappings that are used both for exact and sub-class matches.
protected boolean	_hasEnumSerializer	Flag to help find "generic" enum serializer, if one has been registered.
protected HashMap<ClassKey,ValueSerializer<?>>	_interfaceMappings	Interface-based matches.

Constructor Summary

Constructors

Constructor	Description
SimpleSerializers()
SimpleSerializers(List<ValueSerializer<?>> sers)

Method Summary

Modifier and Type	Method	Description
protected void	_addSerializer(Class<?> cls, ValueSerializer<?> ser)
protected ValueSerializer<?>	_findInterfaceMapping(Class<?> cls, ClassKey key)
<T> SimpleSerializers	addSerializer(Class<? extends T> type, ValueSerializer<T> ser)
SimpleSerializers	addSerializer(ValueSerializer<?> ser)	Method for adding given serializer for type that ValueSerializer.handledType() specifies (which MUST return a non-null class; and can NOT be Object, as a sanity check).
SimpleSerializers	addSerializers(List<ValueSerializer<?>> sers)
ValueSerializer<?>	findArraySerializer(SerializationConfig config, ArrayType type, BeanDescription beanDesc, JsonFormat.Value formatOverrides, TypeSerializer elementTypeSerializer, ValueSerializer<Object> elementValueSerializer)	Method called by serialization framework first time a serializer is needed for specified array type.
ValueSerializer<?>	findCollectionLikeSerializer(SerializationConfig config, CollectionLikeType type, BeanDescription beanDesc, JsonFormat.Value formatOverrides, TypeSerializer elementTypeSerializer, ValueSerializer<Object> elementValueSerializer)	Method called by serialization framework first time a serializer is needed for specified "Collection-like" type (type that acts like Collection, but does not implement it).
ValueSerializer<?>	findCollectionSerializer(SerializationConfig config, CollectionType type, BeanDescription beanDesc, JsonFormat.Value formatOverrides, TypeSerializer elementTypeSerializer, ValueSerializer<Object> elementValueSerializer)	Method called by serialization framework first time a serializer is needed for specified Collection type.
ValueSerializer<?>	findMapLikeSerializer(SerializationConfig config, MapLikeType type, BeanDescription beanDesc, JsonFormat.Value formatOverrides, ValueSerializer<Object> keySerializer, TypeSerializer elementTypeSerializer, ValueSerializer<Object> elementValueSerializer)	Method called by serialization framework first time a serializer is needed for specified "Map-like" type (type that acts like Map, but does not implement it).
ValueSerializer<?>	findMapSerializer(SerializationConfig config, MapType type, BeanDescription beanDesc, JsonFormat.Value formatOverrides, ValueSerializer<Object> keySerializer, TypeSerializer elementTypeSerializer, ValueSerializer<Object> elementValueSerializer)	Method called by serialization framework first time a serializer is needed for specified Map type.
ValueSerializer<?>	findSerializer(SerializationConfig config, JavaType type, BeanDescription beanDesc, JsonFormat.Value formatOverrides)	Method called by serialization framework first time a serializer is needed for specified type, which is not of a container or reference type (for which other methods are called).

Methods inherited from class tools.jackson.databind.ser.Serializers.Base

calculateEffectiveFormat, findExplicitPOJOSerializer, findReferenceSerializer

Methods inherited from class java.lang.Object

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

Field Details

_classMappings

protected HashMap<ClassKey,ValueSerializer<?>> _classMappings

Class-based mappings that are used both for exact and sub-class matches.

_interfaceMappings

protected HashMap<ClassKey,ValueSerializer<?>> _interfaceMappings

Interface-based matches.

_hasEnumSerializer

protected boolean _hasEnumSerializer

Flag to help find "generic" enum serializer, if one has been registered.

Constructor Details

SimpleSerializers

public SimpleSerializers()

SimpleSerializers

public SimpleSerializers(List<ValueSerializer<?>> sers)

Method Details

addSerializer

public SimpleSerializers addSerializer(ValueSerializer<?> ser)

Method for adding given serializer for type that ValueSerializer.handledType() specifies (which MUST return a non-null class; and can NOT be Object, as a sanity check). For serializers that do not declare handled type, use the variant that takes two arguments.

Parameters:

ser -

addSerializer

public <T> SimpleSerializers addSerializer(Class<? extends T> type,
 ValueSerializer<T> ser)

addSerializers

public SimpleSerializers addSerializers(List<ValueSerializer<?>> sers)

findSerializer

public ValueSerializer<?> findSerializer(SerializationConfig config,
 JavaType type,
 BeanDescription beanDesc,
 JsonFormat.Value formatOverrides)

Description copied from interface: Serializers

Method called by serialization framework first time a serializer is needed for specified type, which is not of a container or reference type (for which other methods are called).

Specified by:

findSerializer in interface Serializers

Overrides:

findSerializer in class Serializers.Base

Parameters:

config - Serialization configuration in use

type - Fully resolved type of instances to serialize

beanDesc - Additional information about type

formatOverrides - (nullable) Optional format overrides (usually from property definition), to change definitions that beanDesc may have (and which are NOT included). Usually combined calling Serializers.Base#calculateEffectiveFormat.

Returns:

Configured serializer to use for the type; or null if implementation does not recognize or support type

findArraySerializer

public ValueSerializer<?> findArraySerializer(SerializationConfig config,
 ArrayType type,
 BeanDescription beanDesc,
 JsonFormat.Value formatOverrides,
 TypeSerializer elementTypeSerializer,
 ValueSerializer<Object> elementValueSerializer)

Description copied from interface: Serializers

Method called by serialization framework first time a serializer is needed for specified array type. Implementation should return a serializer instance if it supports specified type; or null if it does not.

Specified by:

findArraySerializer in interface Serializers

Overrides:

findArraySerializer in class Serializers.Base

formatOverrides - (nullable) Optional format overrides (usually from property definition), to change definitions that beanDesc may have (and which are NOT included). Usually combined calling Serializers.Base#calculateEffectiveFormat.

findCollectionSerializer

public ValueSerializer<?> findCollectionSerializer(SerializationConfig config,
 CollectionType type,
 BeanDescription beanDesc,
 JsonFormat.Value formatOverrides,
 TypeSerializer elementTypeSerializer,
 ValueSerializer<Object> elementValueSerializer)

Description copied from interface: Serializers

Method called by serialization framework first time a serializer is needed for specified Collection type. Implementation should return a serializer instance if it supports specified type; or null if it does not.

Specified by:

findCollectionSerializer in interface Serializers

Overrides:

findCollectionSerializer in class Serializers.Base

formatOverrides - (nullable) Optional format overrides (usually from property definition), to change definitions that beanDesc may have (and which are NOT included). Usually combined calling Serializers.Base#calculateEffectiveFormat.

findCollectionLikeSerializer

public ValueSerializer<?> findCollectionLikeSerializer(SerializationConfig config,
 CollectionLikeType type,
 BeanDescription beanDesc,
 JsonFormat.Value formatOverrides,
 TypeSerializer elementTypeSerializer,
 ValueSerializer<Object> elementValueSerializer)

Description copied from interface: Serializers

Method called by serialization framework first time a serializer is needed for specified "Collection-like" type (type that acts like Collection, but does not implement it). Implementation should return a serializer instance if it supports specified type; or null if it does not.

Specified by:

findCollectionLikeSerializer in interface Serializers

Overrides:

findCollectionLikeSerializer in class Serializers.Base

formatOverrides - (nullable) Optional format overrides (usually from property definition), to change definitions that beanDesc may have (and which are NOT included). Usually combined calling Serializers.Base#calculateEffectiveFormat.

findMapSerializer

public ValueSerializer<?> findMapSerializer(SerializationConfig config,
 MapType type,
 BeanDescription beanDesc,
 JsonFormat.Value formatOverrides,
 ValueSerializer<Object> keySerializer,
 TypeSerializer elementTypeSerializer,
 ValueSerializer<Object> elementValueSerializer)

Description copied from interface: Serializers

Method called by serialization framework first time a serializer is needed for specified Map type. Implementation should return a serializer instance if it supports specified type; or null if it does not.

Specified by:

findMapSerializer in interface Serializers

Overrides:

findMapSerializer in class Serializers.Base

formatOverrides - (nullable) Optional format overrides (usually from property definition), to change definitions that beanDesc may have (and which are NOT included). Usually combined calling Serializers.Base#calculateEffectiveFormat.

findMapLikeSerializer

public ValueSerializer<?> findMapLikeSerializer(SerializationConfig config,
 MapLikeType type,
 BeanDescription beanDesc,
 JsonFormat.Value formatOverrides,
 ValueSerializer<Object> keySerializer,
 TypeSerializer elementTypeSerializer,
 ValueSerializer<Object> elementValueSerializer)

Description copied from interface: Serializers

Method called by serialization framework first time a serializer is needed for specified "Map-like" type (type that acts like Map, but does not implement it). Implementation should return a serializer instance if it supports specified type; or null if it does not.

Specified by:

findMapLikeSerializer in interface Serializers

Overrides:

findMapLikeSerializer in class Serializers.Base

formatOverrides - (nullable) Optional format overrides (usually from property definition), to change definitions that beanDesc may have (and which are NOT included). Usually combined calling Serializers.Base#calculateEffectiveFormat.

_findInterfaceMapping

protected ValueSerializer<?> _findInterfaceMapping(Class<?> cls,
 ClassKey key)

_addSerializer

protected void _addSerializer(Class<?> cls,
 ValueSerializer<?> ser)