Module tools.jackson.databind

Package tools.jackson.databind.ser.jdk

Class CollectionSerializer

java.lang.Object

tools.jackson.databind.ValueSerializer<T>

tools.jackson.databind.ser.std.StdSerializer<T>

tools.jackson.databind.ser.std.StdContainerSerializer<T>

tools.jackson.databind.ser.std.AsArraySerializerBase<Collection<?>>

tools.jackson.databind.ser.jdk.CollectionSerializer

All Implemented Interfaces:

JsonFormatVisitable

public class CollectionSerializer
extends AsArraySerializerBase<Collection<?>>

Fallback serializer for cases where Collection is not known to be of type for which more specializer serializer exists (such as index-accessible List). If so, we will just construct an Iterator to iterate over elements.

Nested Class Summary

Nested classes/interfaces inherited from class tools.jackson.databind.ValueSerializer

ValueSerializer.None

Field Summary

Fields inherited from class tools.jackson.databind.ser.std.AsArraySerializerBase

_elementSerializer, _elementType, _staticTyping, _unwrapSingle, _valueTypeSerializer

Fields inherited from class tools.jackson.databind.ser.std.StdContainerSerializer

_dynamicValueSerializers, _property

Fields inherited from class tools.jackson.databind.ser.std.StdSerializer

_handledType

Constructor Summary

Constructors

Modifier	Constructor	Description
	CollectionSerializer(JavaType elemType, boolean staticTyping, TypeSerializer vts, ValueSerializer<Object> valueSerializer)
protected	CollectionSerializer(CollectionSerializer src, TypeSerializer vts, ValueSerializer<?> valueSerializer, Boolean unwrapSingle, BeanProperty property)

Method Summary

Modifier and Type	Method	Description
protected StdContainerSerializer<?>	_withValueTypeSerializer(TypeSerializer vts)	Method that needs to be implemented to allow construction of a new serializer object with given TypeSerializer, used when addition type information is to be embedded.
boolean	hasSingleElement(Collection<?> value)	Method called to determine if the given value (of type handled by this serializer) contains exactly one element.
boolean	isEmpty(SerializationContext prov, Collection<?> value)	Method called to check whether given serializable value is considered "empty" value (for purposes of suppressing serialization of empty values).
final void	serialize(Collection<?> value, JsonGenerator g, SerializationContext provider)	Method that can be called to ask implementation to serialize values of type this serializer handles.
void	serializeContents(Collection<?> value, JsonGenerator g, SerializationContext ctxt)
void	serializeContentsUsing(Collection<?> value, JsonGenerator g, SerializationContext provider, ValueSerializer<Object> ser)
protected CollectionSerializer	withResolved(BeanProperty property, TypeSerializer vts, ValueSerializer<?> elementSerializer, Boolean unwrapSingle)

Methods inherited from class tools.jackson.databind.ser.std.AsArraySerializerBase

acceptJsonFormatVisitor, createContextual, getContentSerializer, getContentType, serializeWithType

Methods inherited from class tools.jackson.databind.ser.std.StdContainerSerializer

_findAndAddDynamic, _findAndAddDynamic, withValueTypeSerializer

Methods inherited from class tools.jackson.databind.ser.std.StdSerializer

_neitherNull, _nonEmpty, _wrapIOFailure, acceptJsonFormatVisitorForBinary, createSchemaNode, createSchemaNode, findAnnotatedContentSerializer, findContextualConvertingSerializer, findFormatFeature, findFormatOverrides, findIncludeOverrides, findPropertyFilter, handledType, isDefaultSerializer, visitArrayFormat, visitArrayFormat, visitFloatFormat, visitIntFormat, visitIntFormat, visitStringFormat, visitStringFormat, wrapAndThrow, wrapAndThrow

Methods inherited from class tools.jackson.databind.ValueSerializer

getDelegatee, isUnwrappingSerializer, properties, replaceDelegatee, resolve, unwrappingSerializer, usesObjectId, withFilterId, withFormatOverrides, withIgnoredProperties

Methods inherited from class java.lang.Object

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

Constructor Details

CollectionSerializer

public CollectionSerializer(JavaType elemType,
 boolean staticTyping,
 TypeSerializer vts,
 ValueSerializer<Object> valueSerializer)

CollectionSerializer

protected CollectionSerializer(CollectionSerializer src,
 TypeSerializer vts,
 ValueSerializer<?> valueSerializer,
 Boolean unwrapSingle,
 BeanProperty property)

Method Details

_withValueTypeSerializer

protected StdContainerSerializer<?> _withValueTypeSerializer(TypeSerializer vts)

Description copied from class: StdContainerSerializer

Method that needs to be implemented to allow construction of a new serializer object with given TypeSerializer, used when addition type information is to be embedded.

Specified by:

_withValueTypeSerializer in class StdContainerSerializer<Collection<?>>

withResolved

protected CollectionSerializer withResolved(BeanProperty property,
 TypeSerializer vts,
 ValueSerializer<?> elementSerializer,
 Boolean unwrapSingle)

Specified by:

withResolved in class AsArraySerializerBase<Collection<?>>

isEmpty

public boolean isEmpty(SerializationContext prov,
 Collection<?> value)

Description copied from class: ValueSerializer

Method called to check whether given serializable value is considered "empty" value (for purposes of suppressing serialization of empty values).

Default implementation will consider only null values to be empty.

Specified by:

isEmpty in class StdContainerSerializer<Collection<?>>

hasSingleElement

public boolean hasSingleElement(Collection<?> value)

Description copied from class: StdContainerSerializer

Method called to determine if the given value (of type handled by this serializer) contains exactly one element.

Note: although it might seem sensible to instead define something like "getElementCount()" method, this would not work well for containers that do not keep track of size (like linked lists may not).

Note, too, that this method is only called by serializer itself; and specifically is not used for non-array/collection types like Map or Map.Entry instances.

Specified by:

hasSingleElement in class StdContainerSerializer<Collection<?>>

serialize

public final void serialize(Collection<?> value,
 JsonGenerator g,
 SerializationContext provider)
                     throws JacksonException

Description copied from class: ValueSerializer

Method that can be called to ask implementation to serialize values of type this serializer handles.

Specified by:

serialize in class StdSerializer<Collection<?>>

Parameters:

value - Value to serialize; can not be null.

g - Generator used to output resulting Json content

provider - Context that can be used to get serializers for serializing Objects value contains, if any.

Throws:

JacksonException

serializeContents

public void serializeContents(Collection<?> value,
 JsonGenerator g,
 SerializationContext ctxt)
                       throws JacksonException

Specified by:

serializeContents in class AsArraySerializerBase<Collection<?>>

Throws:

JacksonException

serializeContentsUsing

public void serializeContentsUsing(Collection<?> value,
 JsonGenerator g,
 SerializationContext provider,
 ValueSerializer<Object> ser)
                            throws JacksonException

Throws:

JacksonException