org.codehaus.jackson.map.ser
Class ContainerSerializers.AsArraySerializer<T>

java.lang.Object
  extended by org.codehaus.jackson.map.JsonSerializer<T>
      extended by org.codehaus.jackson.map.ser.SerializerBase<T>
          extended by org.codehaus.jackson.map.ser.ContainerSerializerBase<T>
              extended by org.codehaus.jackson.map.ser.ContainerSerializers.AsArraySerializer<T>
All Implemented Interfaces:
ResolvableSerializer, SchemaAware
Direct Known Subclasses:
ContainerSerializers.CollectionSerializer, ContainerSerializers.EnumSetSerializer, ContainerSerializers.IndexedListSerializer, ContainerSerializers.IterableSerializer, ContainerSerializers.IteratorSerializer
Enclosing class:
ContainerSerializers

public abstract static class ContainerSerializers.AsArraySerializer<T>
extends ContainerSerializerBase<T>
implements ResolvableSerializer

Base class for serializers that will output contents as JSON arrays.


Nested Class Summary
 
Nested classes/interfaces inherited from class org.codehaus.jackson.map.JsonSerializer
JsonSerializer.None
 
Field Summary
protected  PropertySerializerMap _dynamicSerializers
          If element type can not be statically determined, mapping from runtime type to serializer is handled using this object
protected  JsonSerializer<Object> _elementSerializer
          Value serializer to use, if it can be statically determined
protected  JavaType _elementType
           
protected  BeanProperty _property
          Collection-valued property being serialized with this instance
protected  boolean _staticTyping
           
protected  TypeSerializer _valueTypeSerializer
          Type serializer used for values, if any.
 
Fields inherited from class org.codehaus.jackson.map.ser.SerializerBase
_handledType
 
Constructor Summary
protected ContainerSerializers.AsArraySerializer(Class<?> cls, JavaType et, boolean staticTyping, TypeSerializer vts, BeanProperty property)
           
 
Method Summary
protected  JsonSerializer<Object> _findAndAddDynamic(PropertySerializerMap map, Class<?> type, SerializerProvider provider)
           
 JsonNode getSchema(SerializerProvider provider, Type typeHint)
          Get the representation of the schema to which this serializer will conform.
 void resolve(SerializerProvider provider)
          Need to get callback to resolve value serializer, if static typing is used (either being forced, or because value type is final)
 void serialize(T value, JsonGenerator jgen, SerializerProvider provider)
          Method that can be called to ask implementation to serialize values of type this serializer handles.
protected abstract  void serializeContents(T value, JsonGenerator jgen, SerializerProvider provider)
           
 void serializeWithType(T value, JsonGenerator jgen, SerializerProvider provider, TypeSerializer typeSer)
          Method that can be called to ask implementation to serialize values of type this serializer handles, using specified type serializer for embedding necessary type information.
 
Methods inherited from class org.codehaus.jackson.map.ser.ContainerSerializerBase
_withValueTypeSerializer, withValueTypeSerializer
 
Methods inherited from class org.codehaus.jackson.map.ser.SerializerBase
createObjectNode, createSchemaNode, createSchemaNode, handledType, isDefaultSerializer, wrapAndThrow, wrapAndThrow, wrapAndThrow, wrapAndThrow
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

_staticTyping

protected final boolean _staticTyping

_elementType

protected final JavaType _elementType

_valueTypeSerializer

protected final TypeSerializer _valueTypeSerializer
Type serializer used for values, if any.


_elementSerializer

protected JsonSerializer<Object> _elementSerializer
Value serializer to use, if it can be statically determined

Since:
1.5

_property

protected final BeanProperty _property
Collection-valued property being serialized with this instance

Since:
1.7

_dynamicSerializers

protected PropertySerializerMap _dynamicSerializers
If element type can not be statically determined, mapping from runtime type to serializer is handled using this object

Since:
1.7
Constructor Detail

ContainerSerializers.AsArraySerializer

protected ContainerSerializers.AsArraySerializer(Class<?> cls,
                                                 JavaType et,
                                                 boolean staticTyping,
                                                 TypeSerializer vts,
                                                 BeanProperty property)
Method Detail

serialize

public final void serialize(T value,
                            JsonGenerator jgen,
                            SerializerProvider provider)
                     throws IOException,
                            JsonGenerationException
Description copied from class: JsonSerializer
Method that can be called to ask implementation to serialize values of type this serializer handles.

Specified by:
serialize in class SerializerBase<T>
Parameters:
value - Value to serialize; can not be null.
jgen - Generator used to output resulting Json content
provider - Provider that can be used to get serializers for serializing Objects value contains, if any.
Throws:
IOException
JsonGenerationException

serializeWithType

public final void serializeWithType(T value,
                                    JsonGenerator jgen,
                                    SerializerProvider provider,
                                    TypeSerializer typeSer)
                             throws IOException,
                                    JsonGenerationException
Description copied from class: JsonSerializer
Method that can be called to ask implementation to serialize values of type this serializer handles, using specified type serializer for embedding necessary type information.

Default implementation will ignore serialization of type information, and just calls JsonSerializer.serialize(T, org.codehaus.jackson.JsonGenerator, org.codehaus.jackson.map.SerializerProvider): serializers that can embed type information should override this to implement actual handling. Most common such handling is done by something like:

  // note: method to call depends on whether this type is serialized as JSON scalar, object or Array!
  typeSer.writeTypePrefixForScalar(value, jgen);
  serialize(value, jgen, provider);
  typeSer.writeTypeSuffixForScalar(value, jgen);

Overrides:
serializeWithType in class JsonSerializer<T>
Parameters:
value - Value to serialize; can not be null.
jgen - Generator used to output resulting Json content
provider - Provider that can be used to get serializers for serializing Objects value contains, if any.
typeSer - Type serializer to use for including type information
Throws:
IOException
JsonGenerationException

serializeContents

protected abstract void serializeContents(T value,
                                          JsonGenerator jgen,
                                          SerializerProvider provider)
                                   throws IOException,
                                          JsonGenerationException
Throws:
IOException
JsonGenerationException

getSchema

public JsonNode getSchema(SerializerProvider provider,
                          Type typeHint)
                   throws JsonMappingException
Description copied from interface: SchemaAware
Get the representation of the schema to which this serializer will conform.

Specified by:
getSchema in interface SchemaAware
Specified by:
getSchema in class SerializerBase<T>
Parameters:
provider - The serializer provider.
typeHint - A hint about the type.
Returns:
Json-schema for this serializer.
Throws:
JsonMappingException

resolve

public void resolve(SerializerProvider provider)
             throws JsonMappingException
Need to get callback to resolve value serializer, if static typing is used (either being forced, or because value type is final)

Specified by:
resolve in interface ResolvableSerializer
Parameters:
provider - Provider that has constructed serializer this method is called on.
Throws:
JsonMappingException

_findAndAddDynamic

protected final JsonSerializer<Object> _findAndAddDynamic(PropertySerializerMap map,
                                                          Class<?> type,
                                                          SerializerProvider provider)
                                                   throws JsonMappingException
Throws:
JsonMappingException
Since:
1.7