org.springframework.http.converter.json

Class Jackson2ObjectMapperFactoryBean

java.lang.Object

org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean

All Implemented Interfaces:

org.springframework.beans.factory.FactoryBean<ObjectMapper>, org.springframework.beans.factory.InitializingBean

public class Jackson2ObjectMapperFactoryBean
extends Object
implements org.springframework.beans.factory.FactoryBean<ObjectMapper>, org.springframework.beans.factory.InitializingBean

A FactoryBean for creating a Jackson 2.x ObjectMapper with setters to enable or disable Jackson features from within XML configuration.

Example usage with MappingJackson2HttpMessageConverter:

 <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
   <property name="objectMapper">
     <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean"
       p:autoDetectFields="false"
       p:autoDetectGettersSetters="false"
       p:annotationIntrospector-ref="jaxbAnnotationIntrospector" />
   </property>
 </bean>
 

Example usage with MappingJackson2JsonView:

 <bean class="org.springframework.web.servlet.view.json.MappingJackson2JsonView">
   <property name="objectMapper">
     <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean"
       p:failOnEmptyBeans="false"
       p:indentOutput="true">
       <property name="serializers">
         <array>
           <bean class="org.mycompany.MyCustomSerializer" />
         </array>
       </property>
     </bean>
   </property>
 </bean>
 

In case there are no specific setters provided (for some rarely used options), you can still use the more general methods setFeaturesToEnable(java.lang.Object...) and setFeaturesToDisable(java.lang.Object...).

 <bean class="org.springframework.http.converter.json.Jackson2ObjectMapperFactoryBean">
   <property name="featuresToEnable">
     <array>
       <util:constant static-field="com.fasterxml.jackson.databind.SerializationFeature$WRAP_ROOT_VALUE"/>
       <util:constant static-field="com.fasterxml.jackson.databind.SerializationFeature$CLOSE_CLOSEABLE"/>
     </array>
   </property>
   <property name="featuresToDisable">
     <array>
       <util:constant static-field="com.fasterxml.jackson.databind.MapperFeature$USE_ANNOTATIONS"/>
     </array>
   </property>
 </bean>
 

Since:

3.2

Author:

Dmitry Katsubo, Rossen Stoyanchev

Constructor Summary

Constructors

Constructor and Description
Jackson2ObjectMapperFactoryBean()

Method Summary

Methods

Modifier and Type	Method and Description
void	afterPropertiesSet()
ObjectMapper	getObject() Return the singleton ObjectMapper.
Class<?>	getObjectType()
boolean	isSingleton()
void	setAnnotationIntrospector(AnnotationIntrospector annotationIntrospector) Set an AnnotationIntrospector for both serialization and deserialization.
void	setAutoDetectFields(boolean autoDetectFields) Shortcut for MapperFeature.AUTO_DETECT_FIELDS option.
void	setAutoDetectGettersSetters(boolean autoDetectGettersSetters) Shortcut for MapperFeature.AUTO_DETECT_SETTERS/ MapperFeature.AUTO_DETECT_GETTERS option.
void	setDateFormat(DateFormat dateFormat) Define the format for date/time with the given DateFormat.
void	setDeserializersByType(Map<Class<?>,JsonDeserializer<?>> deserializers) Configure custom deserializers for the given types.
void	setFailOnEmptyBeans(boolean failOnEmptyBeans) Shortcut for SerializationFeature.FAIL_ON_EMPTY_BEANS option.
void	setFeaturesToDisable(Object... featuresToDisable) Specify features to disable.
void	setFeaturesToEnable(Object... featuresToEnable) Specify features to enable.
void	setIndentOutput(boolean indentOutput) Shortcut for SerializationFeature.INDENT_OUTPUT option.
void	setObjectMapper(ObjectMapper objectMapper) Set the ObjectMapper instance to use.
void	setSerializers(JsonSerializer<?>... serializers) Configure custom serializers.
void	setSerializersByType(Map<Class<?>,JsonSerializer<?>> serializers) Configure custom serializers for the given types.
void	setSimpleDateFormat(String format) Define the date/time format with a SimpleDateFormat.

Methods inherited from class java.lang.Object

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

Constructor Detail

Jackson2ObjectMapperFactoryBean

public Jackson2ObjectMapperFactoryBean()

Method Detail

setObjectMapper

public void setObjectMapper(ObjectMapper objectMapper)

Set the ObjectMapper instance to use. If not set, the ObjectMapper will be created using its default constructor.

setDateFormat

public void setDateFormat(DateFormat dateFormat)

Define the format for date/time with the given DateFormat.

Note: Setting this property makes the exposed ObjectMapper non-thread-safe, according to Jackson's thread safety rules.

See Also:

setSimpleDateFormat(String)

setSimpleDateFormat

public void setSimpleDateFormat(String format)

Define the date/time format with a SimpleDateFormat.

Note: Setting this property makes the exposed ObjectMapper non-thread-safe, according to Jackson's thread safety rules.

See Also:

setDateFormat(DateFormat)

setAnnotationIntrospector

public void setAnnotationIntrospector(AnnotationIntrospector annotationIntrospector)

Set an AnnotationIntrospector for both serialization and deserialization.

setSerializers

public void setSerializers(JsonSerializer<?>... serializers)

Configure custom serializers. Each serializer is registered for the type returned by JsonSerializer.handledType(), which must not be null.

See Also:

setSerializersByType(Map)

setSerializersByType

public void setSerializersByType(Map<Class<?>,JsonSerializer<?>> serializers)

Configure custom serializers for the given types.

See Also:

setSerializers(JsonSerializer...)

setDeserializersByType

public void setDeserializersByType(Map<Class<?>,JsonDeserializer<?>> deserializers)

Configure custom deserializers for the given types.

setAutoDetectFields

public void setAutoDetectFields(boolean autoDetectFields)

Shortcut for MapperFeature.AUTO_DETECT_FIELDS option.

setAutoDetectGettersSetters

public void setAutoDetectGettersSetters(boolean autoDetectGettersSetters)

Shortcut for MapperFeature.AUTO_DETECT_SETTERS/ MapperFeature.AUTO_DETECT_GETTERS option.

setFailOnEmptyBeans

public void setFailOnEmptyBeans(boolean failOnEmptyBeans)

Shortcut for SerializationFeature.FAIL_ON_EMPTY_BEANS option.

setIndentOutput

public void setIndentOutput(boolean indentOutput)

Shortcut for SerializationFeature.INDENT_OUTPUT option.

setFeaturesToEnable

public void setFeaturesToEnable(Object... featuresToEnable)

Specify features to enable.

See Also:

JsonParser.Feature, JsonGenerator.Feature, SerializationFeature, DeserializationFeature, MapperFeature

setFeaturesToDisable

public void setFeaturesToDisable(Object... featuresToDisable)

Specify features to disable.

See Also:

JsonParser.Feature, JsonGenerator.Feature, SerializationFeature, DeserializationFeature, MapperFeature

afterPropertiesSet

public void afterPropertiesSet()

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

getObject

public ObjectMapper getObject()

Return the singleton ObjectMapper.

Specified by:

getObject in interface org.springframework.beans.factory.FactoryBean<ObjectMapper>

getObjectType

public Class<?> getObjectType()

Specified by:

getObjectType in interface org.springframework.beans.factory.FactoryBean<ObjectMapper>

isSingleton

public boolean isSingleton()

Specified by:

isSingleton in interface org.springframework.beans.factory.FactoryBean<ObjectMapper>