Class BeanSerializerModifier
- java.lang.Object
 - 
- com.fasterxml.jackson.databind.ser.BeanSerializerModifier
 
 
- 
- All Implemented Interfaces:
 java.io.Serializable
public abstract class BeanSerializerModifier extends java.lang.Object implements java.io.SerializableAbstract class that defines API for objects that can be registered (forBeanSerializerFactoryto participate in constructingBeanSerializerinstances. This is typically done by modules that want alter some aspects of serialization process; and is preferable to sub-classing ofBeanSerializerFactory.Sequence in which callback methods are called is as follows:
- After factory has collected tentative set of properties (instances of
     
BeanPropertyWriter) is sent for modification viachangeProperties(com.fasterxml.jackson.databind.SerializationConfig, com.fasterxml.jackson.databind.BeanDescription, java.util.List<com.fasterxml.jackson.databind.ser.BeanPropertyWriter>). Changes can include removal, addition and replacement of suggested properties. - Resulting set of properties are ordered (sorted) by factory, as per
     configuration, and then 
orderProperties(com.fasterxml.jackson.databind.SerializationConfig, com.fasterxml.jackson.databind.BeanDescription, java.util.List<com.fasterxml.jackson.databind.ser.BeanPropertyWriter>)is called to allow modifiers to alter ordering. - After all bean properties and related information is accumulated,
     
updateBuilder(com.fasterxml.jackson.databind.SerializationConfig, com.fasterxml.jackson.databind.BeanDescription, com.fasterxml.jackson.databind.ser.BeanSerializerBuilder)is called with builder, to allow builder state to be modified (including possibly replacing builder itself if necessary) - Once all bean information has been determined,
     factory creates default 
BeanSerializerinstance and passes it to modifiers usingmodifySerializer(com.fasterxml.jackson.databind.SerializationConfig, com.fasterxml.jackson.databind.BeanDescription, com.fasterxml.jackson.databind.JsonSerializer<?>), for possible modification or replacement (by anyJsonSerializerinstance) 
Default method implementations are "no-op"s, meaning that methods are implemented but have no effect.
- See Also:
 - Serialized Form
 
 
- 
- 
Constructor Summary
Constructors Constructor Description BeanSerializerModifier() 
- 
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description java.util.List<BeanPropertyWriter>changeProperties(SerializationConfig config, BeanDescription beanDesc, java.util.List<BeanPropertyWriter> beanProperties)Method called byBeanSerializerFactorywith tentative set of discovered properties.JsonSerializer<?>modifyArraySerializer(SerializationConfig config, ArrayType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)Method called byDeserializerFactoryafter it has constructed the standard serializer for givenArrayTypeto make it possible to either replace or augment this serializer with additional functionality.JsonSerializer<?>modifyCollectionLikeSerializer(SerializationConfig config, CollectionLikeType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)JsonSerializer<?>modifyCollectionSerializer(SerializationConfig config, CollectionType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)JsonSerializer<?>modifyEnumSerializer(SerializationConfig config, JavaType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)JsonSerializer<?>modifyKeySerializer(SerializationConfig config, JavaType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)Method called byDeserializerFactoryafter it has constructed the default key serializer to use for serializingMapkeys of given type.JsonSerializer<?>modifyMapLikeSerializer(SerializationConfig config, MapLikeType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)JsonSerializer<?>modifyMapSerializer(SerializationConfig config, MapType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)JsonSerializer<?>modifySerializer(SerializationConfig config, BeanDescription beanDesc, JsonSerializer<?> serializer)Method called byBeanSerializerFactoryafter constructing default bean serializer instance with properties collected and ordered earlier.java.util.List<BeanPropertyWriter>orderProperties(SerializationConfig config, BeanDescription beanDesc, java.util.List<BeanPropertyWriter> beanProperties)Method called byBeanSerializerFactorywith set of properties to serialize, in default ordering (based on defaults as well as possible type annotations).BeanSerializerBuilderupdateBuilder(SerializationConfig config, BeanDescription beanDesc, BeanSerializerBuilder builder)Method called byBeanSerializerFactoryafter collecting all information regarding POJO to serialize and updating builder with it, but before constructing serializer. 
 - 
 
- 
- 
Method Detail
- 
changeProperties
public java.util.List<BeanPropertyWriter> changeProperties(SerializationConfig config, BeanDescription beanDesc, java.util.List<BeanPropertyWriter> beanProperties)
Method called byBeanSerializerFactorywith tentative set of discovered properties. Implementations can add, remove or replace any of passed properties. PropertiesListpassed as argument is modifiable, and returned List must likewise be modifiable as it may be passed to multiple registered modifiers. 
- 
orderProperties
public java.util.List<BeanPropertyWriter> orderProperties(SerializationConfig config, BeanDescription beanDesc, java.util.List<BeanPropertyWriter> beanProperties)
Method called byBeanSerializerFactorywith set of properties to serialize, in default ordering (based on defaults as well as possible type annotations). Implementations can change ordering any way they like. PropertiesListpassed as argument is modifiable, and returned List must likewise be modifiable as it may be passed to multiple registered modifiers. 
- 
updateBuilder
public BeanSerializerBuilder updateBuilder(SerializationConfig config, BeanDescription beanDesc, BeanSerializerBuilder builder)
Method called byBeanSerializerFactoryafter collecting all information regarding POJO to serialize and updating builder with it, but before constructing serializer. Implementations may choose to modify state of builder (to affect serializer being built), or even completely replace it (if they want to build different kind of serializer). Typically, however, passed-in builder is returned, possibly with some modifications. 
- 
modifySerializer
public JsonSerializer<?> modifySerializer(SerializationConfig config, BeanDescription beanDesc, JsonSerializer<?> serializer)
Method called byBeanSerializerFactoryafter constructing default bean serializer instance with properties collected and ordered earlier. Implementations can modify or replace given serializer and return serializer to use. Note that although initial serializer being passed is of typeBeanSerializer, modifiers may return serializers of other types; and this is why implementations must check for type before casting.NOTE: since 2.2, gets called for serializer of those non-POJO types that do not go through any of more specific
modifyXxxSerializermethods; mostly for JDK types likeIteratorand such. 
- 
modifyArraySerializer
public JsonSerializer<?> modifyArraySerializer(SerializationConfig config, ArrayType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)
Method called byDeserializerFactoryafter it has constructed the standard serializer for givenArrayTypeto make it possible to either replace or augment this serializer with additional functionality.- Parameters:
 config- Configuration in usevalueType- Type of the value serializer is used for.beanDesc- Details of the type in question, to allow checking class annotationsserializer- Default serializer that would be used.- Returns:
 - Serializer to use; either 
serializerthat was passed in, or an instance method constructed. - Since:
 - 2.2
 
 
- 
modifyCollectionSerializer
public JsonSerializer<?> modifyCollectionSerializer(SerializationConfig config, CollectionType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)
- Since:
 - 2.2
 
 
- 
modifyCollectionLikeSerializer
public JsonSerializer<?> modifyCollectionLikeSerializer(SerializationConfig config, CollectionLikeType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)
- Since:
 - 2.2
 
 
- 
modifyMapSerializer
public JsonSerializer<?> modifyMapSerializer(SerializationConfig config, MapType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)
- Since:
 - 2.2
 
 
- 
modifyMapLikeSerializer
public JsonSerializer<?> modifyMapLikeSerializer(SerializationConfig config, MapLikeType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)
- Since:
 - 2.2
 
 
- 
modifyEnumSerializer
public JsonSerializer<?> modifyEnumSerializer(SerializationConfig config, JavaType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)
- Since:
 - 2.2
 
 
- 
modifyKeySerializer
public JsonSerializer<?> modifyKeySerializer(SerializationConfig config, JavaType valueType, BeanDescription beanDesc, JsonSerializer<?> serializer)
Method called byDeserializerFactoryafter it has constructed the default key serializer to use for serializingMapkeys of given type. This makes it possible to either replace or augment default serializer with additional functionality.- Parameters:
 config- Configuration in usevalueType- Type of keys the serializer is used for.beanDesc- Details of the type in question, to allow checking class annotationsserializer- Default serializer that would be used.- Returns:
 - Serializer to use; either 
serializerthat was passed in, or an instance method constructed. - Since:
 - 2.2
 
 
 - 
 
 -