Class BeanSerializerFactory
- java.lang.Object
-
- org.codehaus.jackson.map.SerializerFactory
-
- org.codehaus.jackson.map.ser.BasicSerializerFactory
-
- org.codehaus.jackson.map.ser.BeanSerializerFactory
-
- Direct Known Subclasses:
CustomSerializerFactory
public class BeanSerializerFactory extends BasicSerializerFactory
Factory class that can provide serializers for any regular Java beans (as defined by "having at least one get method recognizable as bean accessor" -- whereObject.getClass()
does not count); as well as for "standard" JDK types. Latter is achieved by delegating calls toBasicSerializerFactory
to find serializers both for "standard" JDK types (and in some cases, sub-classes as is the case for collection classes likeList
s andMap
s) and bean (value) classes.Note about delegating calls to
BasicSerializerFactory
: although it would be nicer to use linear delegation for construction (to essentially dispatch all calls first to the underlyingBasicSerializerFactory
; or alternatively after failing to provide bean-based serializer}, there is a problem: priority levels for detecting standard types are mixed. That is, we want to check if a type is a bean after some of "standard" JDK types, but before the rest. As a result, "mixed" delegation used, and calls are NOT done using regularSerializerFactory
interface but rather via direct calls toBasicSerializerFactory
.Finally, since all caching is handled by the serializer provider (not factory) and there is no configurability, this factory is stateless. This means that a global singleton instance can be used.
Notes for version 1.7 (and above): the new module registration system required addition of
withConfig(org.codehaus.jackson.map.SerializerFactory.Config)
, which has to be redefined by sub-classes so that they can work properly with pluggable additional serializer providing components.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
BeanSerializerFactory.ConfigImpl
Configuration settings container class for bean serializer factory-
Nested classes/interfaces inherited from class org.codehaus.jackson.map.SerializerFactory
SerializerFactory.Config
-
-
Field Summary
Fields Modifier and Type Field Description protected SerializerFactory.Config
_factoryConfig
Configuration settings for this factory; immutable instance (just like this factory), new version created via copy-constructor (fluent-style)static BeanSerializerFactory
instance
LikeBasicSerializerFactory
, this factory is stateless, and thus a single shared global (== singleton) instance can be used without thread-safety issues.-
Fields inherited from class org.codehaus.jackson.map.ser.BasicSerializerFactory
_arraySerializers, _concrete, _concreteLazy, optionalHandlers
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
BeanSerializerFactory(SerializerFactory.Config config)
Constructor for creating instances with specified configuration.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description protected BeanPropertyWriter
_constructWriter(SerializationConfig config, TypeBindings typeContext, PropertyBuilder pb, boolean staticTyping, String name, AnnotatedMember accessor)
Secondary helper method for constructingBeanPropertyWriter
for given member (field or method).protected JsonSerializer<Object>
constructBeanSerializer(SerializationConfig config, BasicBeanDescription beanDesc, BeanProperty property)
Method called to construct serializer for serializing specified bean type.protected BeanSerializerBuilder
constructBeanSerializerBuilder(BasicBeanDescription beanDesc)
protected BeanPropertyWriter
constructFilteredBeanWriter(BeanPropertyWriter writer, Class<?>[] inViews)
Method called to construct a filtered writer, for given view definitions.protected PropertyBuilder
constructPropertyBuilder(SerializationConfig config, BasicBeanDescription beanDesc)
JsonSerializer<Object>
createKeySerializer(SerializationConfig config, JavaType type, BeanProperty property)
Method called to create serializer to use for serializing JSON property names (which must be output asJsonToken.FIELD_NAME
) for Map that has specified declared key type, and is for specified property (or, if property is null, as root value)JsonSerializer<Object>
createSerializer(SerializationConfig config, JavaType origType, BeanProperty property)
Main serializer constructor method.protected Iterable<Serializers>
customSerializers()
protected List<BeanPropertyWriter>
filterBeanProperties(SerializationConfig config, BasicBeanDescription beanDesc, List<BeanPropertyWriter> props)
Overridable method that can filter out properties.protected List<BeanPropertyWriter>
findBeanProperties(SerializationConfig config, BasicBeanDescription beanDesc)
Method used to collect all actual serializable properties.JsonSerializer<Object>
findBeanSerializer(SerializationConfig config, JavaType type, BasicBeanDescription beanDesc, BeanProperty property)
Method that will try to construct aBeanSerializer
for given class.protected Object
findFilterId(SerializationConfig config, BasicBeanDescription beanDesc)
Method called to find filter that is configured to be used with bean serializer being built, if any.TypeSerializer
findPropertyContentTypeSerializer(JavaType containerType, SerializationConfig config, AnnotatedMember accessor, BeanProperty property)
Method called to create a type information serializer for values of given container property if one is needed.TypeSerializer
findPropertyTypeSerializer(JavaType baseType, SerializationConfig config, AnnotatedMember accessor, BeanProperty property)
Method called to create a type information serializer for values of given non-container property if one is needed.SerializerFactory.Config
getConfig()
protected boolean
isPotentialBeanType(Class<?> type)
Helper method used to skip processing for types that we know can not be (i.e.protected void
processViews(SerializationConfig config, BeanSerializerBuilder builder)
Method called to handle view information for constructed serializer, based on bean property writers.protected void
removeIgnorableTypes(SerializationConfig config, BasicBeanDescription beanDesc, List<BeanPropertyDefinition> properties)
Method that will apply by-type limitations (as per [JACKSON-429]); by default this is based onJsonIgnoreType
annotation but can be supplied by module-provided introspectors too.protected void
removeSetterlessGetters(SerializationConfig config, BasicBeanDescription beanDesc, List<BeanPropertyDefinition> properties)
Helper method that will remove all properties that do not have a mutator.protected List<BeanPropertyWriter>
sortBeanProperties(SerializationConfig config, BasicBeanDescription beanDesc, List<BeanPropertyWriter> props)
Deprecated.Since 1.9 this method does nothing, so there is no benefit from overriding it; it will be removed from 2.0.SerializerFactory
withConfig(SerializerFactory.Config config)
Method used by module registration functionality, to attach additional serializer providers into this serializer factory.-
Methods inherited from class org.codehaus.jackson.map.ser.BasicSerializerFactory
buildArraySerializer, buildCollectionLikeSerializer, buildCollectionSerializer, buildContainerSerializer, buildEnumMapSerializer, buildEnumSetSerializer, buildIterableSerializer, buildIteratorSerializer, buildMapLikeSerializer, buildMapSerializer, createTypeSerializer, findContentSerializer, findKeySerializer, findSerializerByAddonType, findSerializerByLookup, findSerializerByPrimaryType, findSerializerFromAnnotation, getNullSerializer, isIndexedList, modifySecondaryTypesByAnnotation, modifyTypeByAnnotation, usesStaticTyping
-
Methods inherited from class org.codehaus.jackson.map.SerializerFactory
createSerializer, createTypeSerializer, withAdditionalKeySerializers, withAdditionalSerializers, withSerializerModifier
-
-
-
-
Field Detail
-
instance
public static final BeanSerializerFactory instance
LikeBasicSerializerFactory
, this factory is stateless, and thus a single shared global (== singleton) instance can be used without thread-safety issues.
-
_factoryConfig
protected final SerializerFactory.Config _factoryConfig
Configuration settings for this factory; immutable instance (just like this factory), new version created via copy-constructor (fluent-style)- Since:
- 1.7
-
-
Constructor Detail
-
BeanSerializerFactory
protected BeanSerializerFactory(SerializerFactory.Config config)
Constructor for creating instances with specified configuration.
-
-
Method Detail
-
getConfig
public SerializerFactory.Config getConfig()
- Specified by:
getConfig
in classSerializerFactory
-
withConfig
public SerializerFactory withConfig(SerializerFactory.Config config)
Method used by module registration functionality, to attach additional serializer providers into this serializer factory. This is typically handled by constructing a new instance with additional serializers, to ensure thread-safe access.- Specified by:
withConfig
in classSerializerFactory
- Since:
- 1.7
-
customSerializers
protected Iterable<Serializers> customSerializers()
- Specified by:
customSerializers
in classBasicSerializerFactory
-
createSerializer
public JsonSerializer<Object> createSerializer(SerializationConfig config, JavaType origType, BeanProperty property) throws JsonMappingException
Main serializer constructor method. We will have to be careful with respect to ordering of various method calls: essentially we want to reliably figure out which classes are standard types, and which are beans. The problem is that some bean Classes may implement standard interfaces (say,Iterable
.Note: sub-classes may choose to complete replace implementation, if they want to alter priority of serializer lookups.
- Specified by:
createSerializer
in classBasicSerializerFactory
- Throws:
JsonMappingException
-
createKeySerializer
public JsonSerializer<Object> createKeySerializer(SerializationConfig config, JavaType type, BeanProperty property)
Description copied from class:SerializerFactory
Method called to create serializer to use for serializing JSON property names (which must be output asJsonToken.FIELD_NAME
) for Map that has specified declared key type, and is for specified property (or, if property is null, as root value)- Specified by:
createKeySerializer
in classSerializerFactory
- Parameters:
config
- Serialization configuration in usetype
- Declared type for Map keysproperty
- Property that contains Map being serialized; null when serializing root Map value.- Returns:
- Serializer to use, if factory knows it; null if not (in which case default serializer is to be used)
-
findBeanSerializer
public JsonSerializer<Object> findBeanSerializer(SerializationConfig config, JavaType type, BasicBeanDescription beanDesc, BeanProperty property) throws JsonMappingException
Method that will try to construct aBeanSerializer
for given class. Returns null if no properties are found.- Throws:
JsonMappingException
-
findPropertyTypeSerializer
public TypeSerializer findPropertyTypeSerializer(JavaType baseType, SerializationConfig config, AnnotatedMember accessor, BeanProperty property) throws JsonMappingException
Method called to create a type information serializer for values of given non-container property if one is needed. If not needed (no polymorphic handling configured), should return null.- Parameters:
baseType
- Declared type to use as the base type for type information serializer- Returns:
- Type serializer to use for property values, if one is needed; null if not.
- Throws:
JsonMappingException
- Since:
- 1.5
-
findPropertyContentTypeSerializer
public TypeSerializer findPropertyContentTypeSerializer(JavaType containerType, SerializationConfig config, AnnotatedMember accessor, BeanProperty property) throws JsonMappingException
Method called to create a type information serializer for values of given container property if one is needed. If not needed (no polymorphic handling configured), should return null.- Parameters:
containerType
- Declared type of the container to use as the base type for type information serializer- Returns:
- Type serializer to use for property value contents, if one is needed; null if not.
- Throws:
JsonMappingException
- Since:
- 1.5
-
constructBeanSerializer
protected JsonSerializer<Object> constructBeanSerializer(SerializationConfig config, BasicBeanDescription beanDesc, BeanProperty property) throws JsonMappingException
Method called to construct serializer for serializing specified bean type.- Throws:
JsonMappingException
- Since:
- 1.6
-
constructFilteredBeanWriter
protected BeanPropertyWriter constructFilteredBeanWriter(BeanPropertyWriter writer, Class<?>[] inViews)
Method called to construct a filtered writer, for given view definitions. Default implementation constructs filter that checks active view type to views property is to be included in.
-
constructPropertyBuilder
protected PropertyBuilder constructPropertyBuilder(SerializationConfig config, BasicBeanDescription beanDesc)
-
constructBeanSerializerBuilder
protected BeanSerializerBuilder constructBeanSerializerBuilder(BasicBeanDescription beanDesc)
-
findFilterId
protected Object findFilterId(SerializationConfig config, BasicBeanDescription beanDesc)
Method called to find filter that is configured to be used with bean serializer being built, if any.- Since:
- 1.7
-
isPotentialBeanType
protected boolean isPotentialBeanType(Class<?> type)
Helper method used to skip processing for types that we know can not be (i.e. are never consider to be) beans: things like primitives, Arrays, Enums, and proxy types.Note that usually we shouldn't really be getting these sort of types anyway; but better safe than sorry.
-
findBeanProperties
protected List<BeanPropertyWriter> findBeanProperties(SerializationConfig config, BasicBeanDescription beanDesc) throws JsonMappingException
Method used to collect all actual serializable properties. Can be overridden to implement custom detection schemes.- Throws:
JsonMappingException
-
filterBeanProperties
protected List<BeanPropertyWriter> filterBeanProperties(SerializationConfig config, BasicBeanDescription beanDesc, List<BeanPropertyWriter> props)
Overridable method that can filter out properties. Default implementation checks annotations class may have.
-
sortBeanProperties
@Deprecated protected List<BeanPropertyWriter> sortBeanProperties(SerializationConfig config, BasicBeanDescription beanDesc, List<BeanPropertyWriter> props)
Deprecated.Since 1.9 this method does nothing, so there is no benefit from overriding it; it will be removed from 2.0.Method that used to be called (pre-1.9) to impose configured ordering on list of discovered properties. With 1.9 it is not needed any more as ordering is done earlier.
-
processViews
protected void processViews(SerializationConfig config, BeanSerializerBuilder builder)
Method called to handle view information for constructed serializer, based on bean property writers.Note that this method is designed to be overridden by sub-classes if they want to provide custom view handling. As such it is not considered an internal implementation detail, and will be supported as part of API going forward.
NOTE: signature of this method changed in 1.7, due to other significant changes (esp. use of builder for serializer construction).
-
removeIgnorableTypes
protected void removeIgnorableTypes(SerializationConfig config, BasicBeanDescription beanDesc, List<BeanPropertyDefinition> properties)
Method that will apply by-type limitations (as per [JACKSON-429]); by default this is based onJsonIgnoreType
annotation but can be supplied by module-provided introspectors too.
-
removeSetterlessGetters
protected void removeSetterlessGetters(SerializationConfig config, BasicBeanDescription beanDesc, List<BeanPropertyDefinition> properties)
Helper method that will remove all properties that do not have a mutator.- Since:
- 1.9
-
_constructWriter
protected BeanPropertyWriter _constructWriter(SerializationConfig config, TypeBindings typeContext, PropertyBuilder pb, boolean staticTyping, String name, AnnotatedMember accessor) throws JsonMappingException
Secondary helper method for constructingBeanPropertyWriter
for given member (field or method).- Throws:
JsonMappingException
-
-