org.codehaus.jackson.map.ser
Class BeanSerializer

java.lang.Object
  extended by org.codehaus.jackson.map.JsonSerializer<T>
      extended by org.codehaus.jackson.map.ser.SerializerBase<Object>
          extended by org.codehaus.jackson.map.ser.BeanSerializer
All Implemented Interfaces:
ResolvableSerializer, SchemaAware

public class BeanSerializer
extends SerializerBase<Object>
implements ResolvableSerializer, SchemaAware

Serializer class that can serialize arbitrary bean objects

Implementation note: we will post-process resulting serializer, to figure out actual serializers for final types. This must be done from resolve(org.codehaus.jackson.map.SerializerProvider) method, and NOT from constructor; otherwise we could end up with an infinite loop.

Since 1.7 instances are immutable; this is achieved by using a separate builder during construction process.


Nested Class Summary
 
Nested classes/interfaces inherited from class org.codehaus.jackson.map.JsonSerializer
JsonSerializer.None
 
Field Summary
protected  AnyGetterWriter _anyGetterWriter
          Handler for JsonAnyGetter annotated properties
protected  BeanPropertyWriter[] _filteredProps
          Optional filters used to suppress output of properties that are only to be included in certain views
protected  Object _propertyFilterId
          Id of the bean property filter to use, if any; null if none.
protected  BeanPropertyWriter[] _props
          Writers used for outputting actual property values
protected static BeanPropertyWriter[] NO_PROPS
           
 
Fields inherited from class org.codehaus.jackson.map.ser.SerializerBase
_handledType
 
Constructor Summary
protected BeanSerializer(BeanSerializer src)
          Copy-constructor that is useful for sub-classes that just want to copy all super-class properties without modifications.
  BeanSerializer(Class<?> rawType, BeanPropertyWriter[] properties, BeanPropertyWriter[] filteredProperties, AnyGetterWriter anyGetterWriter, Object filterId)
           
  BeanSerializer(JavaType type, BeanPropertyWriter[] properties, BeanPropertyWriter[] filteredProperties, AnyGetterWriter anyGetterWriter, Object filterId)
           
 
Method Summary
static BeanSerializer createDummy(Class<?> forType)
          Method for constructing dummy bean deserializer; one that never outputs any properties
protected  BeanPropertyFilter findFilter(SerializerProvider provider)
          Helper method used to locate filter that is needed, based on filter id this serializer was constructed with.
 JsonNode getSchema(SerializerProvider provider, Type typeHint)
          Get the representation of the schema to which this serializer will conform.
 void resolve(SerializerProvider provider)
          Method called after SerializerProvider has registered the serializer, but before it has returned it to the caller.
 void serialize(Object bean, JsonGenerator jgen, SerializerProvider provider)
          Main serialization method that will delegate actual output to configured BeanPropertyWriter instances.
protected  void serializeFields(Object bean, JsonGenerator jgen, SerializerProvider provider)
           
protected  void serializeFieldsFiltered(Object bean, JsonGenerator jgen, SerializerProvider provider)
          Alternative serialization method that gets called when there is a BeanPropertyFilter that needs to be called to determine which properties are to be serialized (and possibly how)
 void serializeWithType(Object bean, 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.
 String toString()
           
 
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, wait, wait, wait
 

Field Detail

NO_PROPS

protected static final BeanPropertyWriter[] NO_PROPS

_props

protected final BeanPropertyWriter[] _props
Writers used for outputting actual property values


_filteredProps

protected final BeanPropertyWriter[] _filteredProps
Optional filters used to suppress output of properties that are only to be included in certain views


_anyGetterWriter

protected final AnyGetterWriter _anyGetterWriter
Handler for JsonAnyGetter annotated properties

Since:
1.6

_propertyFilterId

protected final Object _propertyFilterId
Id of the bean property filter to use, if any; null if none.

Constructor Detail

BeanSerializer

public BeanSerializer(JavaType type,
                      BeanPropertyWriter[] properties,
                      BeanPropertyWriter[] filteredProperties,
                      AnyGetterWriter anyGetterWriter,
                      Object filterId)
Parameters:
type - Nominal type of values handled by this serializer
properties - Property writers used for actual serialization

BeanSerializer

public BeanSerializer(Class<?> rawType,
                      BeanPropertyWriter[] properties,
                      BeanPropertyWriter[] filteredProperties,
                      AnyGetterWriter anyGetterWriter,
                      Object filterId)

BeanSerializer

protected BeanSerializer(BeanSerializer src)
Copy-constructor that is useful for sub-classes that just want to copy all super-class properties without modifications.

Since:
1.7
Method Detail

createDummy

public static BeanSerializer createDummy(Class<?> forType)
Method for constructing dummy bean deserializer; one that never outputs any properties


serialize

public final void serialize(Object bean,
                            JsonGenerator jgen,
                            SerializerProvider provider)
                     throws IOException,
                            JsonGenerationException
Main serialization method that will delegate actual output to configured BeanPropertyWriter instances.

Specified by:
serialize in class SerializerBase<Object>
Parameters:
bean - 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 void serializeWithType(Object bean,
                              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<Object>
Parameters:
bean - 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

serializeFields

protected void serializeFields(Object bean,
                               JsonGenerator jgen,
                               SerializerProvider provider)
                        throws IOException,
                               JsonGenerationException
Throws:
IOException
JsonGenerationException

serializeFieldsFiltered

protected void serializeFieldsFiltered(Object bean,
                                       JsonGenerator jgen,
                                       SerializerProvider provider)
                                throws IOException,
                                       JsonGenerationException
Alternative serialization method that gets called when there is a BeanPropertyFilter that needs to be called to determine which properties are to be serialized (and possibly how)

Throws:
IOException
JsonGenerationException
Since:
1.7

findFilter

protected BeanPropertyFilter findFilter(SerializerProvider provider)
                                 throws JsonMappingException
Helper method used to locate filter that is needed, based on filter id this serializer was constructed with.

Throws:
JsonMappingException
Since:
1.7

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<Object>
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
Description copied from interface: ResolvableSerializer
Method called after SerializerProvider has registered the serializer, but before it has returned it to the caller. Called object can then resolve its dependencies to other types, including self-references (direct or indirect).

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

toString

public String toString()
Overrides:
toString in class Object