org.springframework.http.converter.json

Class Jackson2ObjectMapperBuilder

java.lang.Object

org.springframework.http.converter.json.Jackson2ObjectMapperBuilder

public class Jackson2ObjectMapperBuilder
extends Object

A builder used to create ObjectMapper instances with a fluent API.

It customizes Jackson's default properties with the following ones:

• MapperFeature.DEFAULT_VIEW_INCLUSION is disabled
• DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES is disabled

It also automatically registers the following well-known modules if they are detected on the classpath:

• jackson-datatype-jdk7: support for Java 7 types like Path
• jackson-datatype-joda: support for Joda-Time types
• jackson-datatype-jsr310: support for Java 8 Date & Time API types
• jackson-datatype-jdk8: support for other Java 8 types like Optional

Tested against Jackson 2.2, 2.3, 2.4, 2.5, 2.6; compatible with Jackson 2.0 and higher.

Since:

4.1.1

Author:

Sebastien Deleuze, Juergen Hoeller, Tadaya Tsuyukubo

See Also:

build(), configure(ObjectMapper), Jackson2ObjectMapperFactoryBean

Constructor Summary

Constructors

Constructor and Description
Jackson2ObjectMapperBuilder()

Method Summary

Modifier and Type	Method and Description
Jackson2ObjectMapperBuilder	annotationIntrospector(AnnotationIntrospector annotationIntrospector) Set an AnnotationIntrospector for both serialization and deserialization.
Jackson2ObjectMapperBuilder	applicationContext(org.springframework.context.ApplicationContext applicationContext) Set the Spring ApplicationContext in order to autowire Jackson handlers (JsonSerializer, JsonDeserializer, KeyDeserializer, TypeResolverBuilder and TypeIdResolver).
Jackson2ObjectMapperBuilder	autoDetectFields(boolean autoDetectFields) Shortcut for MapperFeature.AUTO_DETECT_FIELDS option.
Jackson2ObjectMapperBuilder	autoDetectGettersSetters(boolean autoDetectGettersSetters) Shortcut for MapperFeature.AUTO_DETECT_SETTERS/ MapperFeature.AUTO_DETECT_GETTERS option.
<T extends ObjectMapper> T	build() Build a new ObjectMapper instance.
void	configure(ObjectMapper objectMapper) Configure an existing ObjectMapper instance with this builder's settings.
Jackson2ObjectMapperBuilder	createXmlMapper(boolean createXmlMapper) If set to true, an XmlMapper will be created using its default constructor.
Jackson2ObjectMapperBuilder	dateFormat(DateFormat dateFormat) Define the format for date/time with the given DateFormat.
Jackson2ObjectMapperBuilder	defaultViewInclusion(boolean defaultViewInclusion) Shortcut for MapperFeature.DEFAULT_VIEW_INCLUSION option.
Jackson2ObjectMapperBuilder	deserializerByType(Class<?> type, JsonDeserializer<?> deserializer) Configure a custom deserializer for the given type.
Jackson2ObjectMapperBuilder	deserializersByType(Map<Class<?>,JsonDeserializer<?>> deserializers) Configure custom deserializers for the given types.
Jackson2ObjectMapperBuilder	failOnEmptyBeans(boolean failOnEmptyBeans) Shortcut for SerializationFeature.FAIL_ON_EMPTY_BEANS option.
Jackson2ObjectMapperBuilder	failOnUnknownProperties(boolean failOnUnknownProperties) Shortcut for DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES option.
Jackson2ObjectMapperBuilder	featuresToDisable(Object... featuresToDisable) Specify features to disable.
Jackson2ObjectMapperBuilder	featuresToEnable(Object... featuresToEnable) Specify features to enable.
Jackson2ObjectMapperBuilder	filters(FilterProvider filters) Set the global filters to use in order to support @JsonFilter annotated POJO.
Jackson2ObjectMapperBuilder	findModulesViaServiceLoader(boolean findModules) Set whether to let Jackson find available modules via the JDK ServiceLoader, based on META-INF metadata in the classpath.
Jackson2ObjectMapperBuilder	handlerInstantiator(HandlerInstantiator handlerInstantiator) Customize the construction of Jackson handlers (JsonSerializer, JsonDeserializer, KeyDeserializer, TypeResolverBuilder and TypeIdResolver).
Jackson2ObjectMapperBuilder	indentOutput(boolean indentOutput) Shortcut for SerializationFeature.INDENT_OUTPUT option.
static Jackson2ObjectMapperBuilder	json() Obtain a Jackson2ObjectMapperBuilder instance in order to build a regular JSON ObjectMapper instance.
Jackson2ObjectMapperBuilder	locale(Locale locale) Override the default Locale to use for formatting.
Jackson2ObjectMapperBuilder	locale(String localeString) Override the default Locale to use for formatting.
Jackson2ObjectMapperBuilder	mixIn(Class<?> target, Class<?> mixinSource) Add mix-in annotations to use for augmenting specified class or interface.
Jackson2ObjectMapperBuilder	mixIns(Map<Class<?>,Class<?>> mixIns) Add mix-in annotations to use for augmenting specified class or interface.
Jackson2ObjectMapperBuilder	moduleClassLoader(ClassLoader moduleClassLoader) Set the ClassLoader to use for loading Jackson extension modules.
Jackson2ObjectMapperBuilder	modules(List<Module> modules) Set a complete list of modules to be registered with the ObjectMapper.
Jackson2ObjectMapperBuilder	modules(Module... modules) Specify one or more modules to be registered with the ObjectMapper.
Jackson2ObjectMapperBuilder	modulesToInstall(Class<? extends Module>... modules) Specify one or more modules by class to be registered with the ObjectMapper.
Jackson2ObjectMapperBuilder	modulesToInstall(Module... modules) Specify one or more modules to be registered with the ObjectMapper.
Jackson2ObjectMapperBuilder	propertyNamingStrategy(PropertyNamingStrategy propertyNamingStrategy) Specify a PropertyNamingStrategy to configure the ObjectMapper with.
Jackson2ObjectMapperBuilder	serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Include serializationInclusion) Set a custom inclusion strategy for serialization.
Jackson2ObjectMapperBuilder	serializerByType(Class<?> type, JsonSerializer<?> serializer) Configure a custom serializer for the given type.
Jackson2ObjectMapperBuilder	serializers(JsonSerializer<?>... serializers) Configure custom serializers.
Jackson2ObjectMapperBuilder	serializersByType(Map<Class<?>,JsonSerializer<?>> serializers) Configure custom serializers for the given types.
Jackson2ObjectMapperBuilder	simpleDateFormat(String format) Define the date/time format with a SimpleDateFormat.
Jackson2ObjectMapperBuilder	timeZone(String timeZoneString) Override the default TimeZone to use for formatting.
Jackson2ObjectMapperBuilder	timeZone(TimeZone timeZone) Override the default TimeZone to use for formatting.
static Jackson2ObjectMapperBuilder	xml() Obtain a Jackson2ObjectMapperBuilder instance in order to build an XmlMapper instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

Jackson2ObjectMapperBuilder

public Jackson2ObjectMapperBuilder()

Method Detail

createXmlMapper

public Jackson2ObjectMapperBuilder createXmlMapper(boolean createXmlMapper)

If set to true, an XmlMapper will be created using its default constructor. This is only applicable to build() calls, not to configure(com.fasterxml.jackson.databind.ObjectMapper) calls.

dateFormat

public Jackson2ObjectMapperBuilder dateFormat(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:

simpleDateFormat(String)

simpleDateFormat

public Jackson2ObjectMapperBuilder simpleDateFormat(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:

dateFormat(DateFormat)

locale

public Jackson2ObjectMapperBuilder locale(Locale locale)

Override the default Locale to use for formatting. Default value used is Locale.getDefault().

Since:

4.1.5

locale

public Jackson2ObjectMapperBuilder locale(String localeString)

Override the default Locale to use for formatting. Default value used is Locale.getDefault().

Parameters:

localeString - the locale ID as a String representation

Since:

4.1.5

timeZone

public Jackson2ObjectMapperBuilder timeZone(TimeZone timeZone)

Override the default TimeZone to use for formatting. Default value used is UTC (NOT local timezone).

Since:

4.1.5

timeZone

public Jackson2ObjectMapperBuilder timeZone(String timeZoneString)

Override the default TimeZone to use for formatting. Default value used is UTC (NOT local timezone).

Parameters:

timeZoneString - the zone ID as a String representation

Since:

4.1.5

annotationIntrospector

public Jackson2ObjectMapperBuilder annotationIntrospector(AnnotationIntrospector annotationIntrospector)

Set an AnnotationIntrospector for both serialization and deserialization.

propertyNamingStrategy

public Jackson2ObjectMapperBuilder propertyNamingStrategy(PropertyNamingStrategy propertyNamingStrategy)

Specify a PropertyNamingStrategy to configure the ObjectMapper with.

serializationInclusion

public Jackson2ObjectMapperBuilder serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Include serializationInclusion)

Set a custom inclusion strategy for serialization.

See Also:

JsonInclude.Include

filters

public Jackson2ObjectMapperBuilder filters(FilterProvider filters)

Set the global filters to use in order to support @JsonFilter annotated POJO.

Since:

4.2

See Also:

MappingJacksonValue.setFilters(FilterProvider)

mixIn

public Jackson2ObjectMapperBuilder mixIn(Class<?> target,
                                         Class<?> mixinSource)

Add mix-in annotations to use for augmenting specified class or interface.

Parameters:

target - class (or interface) whose annotations to effectively override

mixinSource - class (or interface) whose annotations are to be "added" to target's annotations as value

Since:

4.1.2

See Also:

ObjectMapper.addMixInAnnotations(Class, Class)

mixIns

public Jackson2ObjectMapperBuilder mixIns(Map<Class<?>,Class<?>> mixIns)

Add mix-in annotations to use for augmenting specified class or interface.

Parameters:

mixIns - Map of entries with target classes (or interface) whose annotations to effectively override as key and mix-in classes (or interface) whose annotations are to be "added" to target's annotations as value.

Since:

4.1.2

See Also:

ObjectMapper.addMixInAnnotations(Class, Class)

serializers

public Jackson2ObjectMapperBuilder serializers(JsonSerializer<?>... serializers)

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

See Also:

serializersByType(Map)

serializerByType

public Jackson2ObjectMapperBuilder serializerByType(Class<?> type,
                                                    JsonSerializer<?> serializer)

Configure a custom serializer for the given type.

Since:

4.1.2

See Also:

serializers(JsonSerializer...)

serializersByType

public Jackson2ObjectMapperBuilder serializersByType(Map<Class<?>,JsonSerializer<?>> serializers)

Configure custom serializers for the given types.

See Also:

serializers(JsonSerializer...)

deserializerByType

public Jackson2ObjectMapperBuilder deserializerByType(Class<?> type,
                                                      JsonDeserializer<?> deserializer)

Configure a custom deserializer for the given type.

Since:

4.1.2

deserializersByType

public Jackson2ObjectMapperBuilder deserializersByType(Map<Class<?>,JsonDeserializer<?>> deserializers)

Configure custom deserializers for the given types.

autoDetectFields

public Jackson2ObjectMapperBuilder autoDetectFields(boolean autoDetectFields)

Shortcut for MapperFeature.AUTO_DETECT_FIELDS option.

autoDetectGettersSetters

public Jackson2ObjectMapperBuilder autoDetectGettersSetters(boolean autoDetectGettersSetters)

Shortcut for MapperFeature.AUTO_DETECT_SETTERS/ MapperFeature.AUTO_DETECT_GETTERS option.

defaultViewInclusion

public Jackson2ObjectMapperBuilder defaultViewInclusion(boolean defaultViewInclusion)

Shortcut for MapperFeature.DEFAULT_VIEW_INCLUSION option.

failOnUnknownProperties

public Jackson2ObjectMapperBuilder failOnUnknownProperties(boolean failOnUnknownProperties)

Shortcut for DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES option.

failOnEmptyBeans

public Jackson2ObjectMapperBuilder failOnEmptyBeans(boolean failOnEmptyBeans)

Shortcut for SerializationFeature.FAIL_ON_EMPTY_BEANS option.

indentOutput

public Jackson2ObjectMapperBuilder indentOutput(boolean indentOutput)

Shortcut for SerializationFeature.INDENT_OUTPUT option.

featuresToEnable

public Jackson2ObjectMapperBuilder featuresToEnable(Object... featuresToEnable)

Specify features to enable.

See Also:

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

featuresToDisable

public Jackson2ObjectMapperBuilder featuresToDisable(Object... featuresToDisable)

Specify features to disable.

See Also:

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

modules

public Jackson2ObjectMapperBuilder modules(Module... modules)

Specify one or more modules to be registered with the ObjectMapper.

Note: If this is set, no finding of modules is going to happen - not by Jackson, and not by Spring either (see findModulesViaServiceLoader). As a consequence, specifying an empty list here will suppress any kind of module detection.

Specify either this or modulesToInstall(com.fasterxml.jackson.databind.Module...), not both.

Since:

4.1.5

See Also:

modules(List), Module

modules

public Jackson2ObjectMapperBuilder modules(List<Module> modules)

Set a complete list of modules to be registered with the ObjectMapper.

Note: If this is set, no finding of modules is going to happen - not by Jackson, and not by Spring either (see findModulesViaServiceLoader). As a consequence, specifying an empty list here will suppress any kind of module detection.

Specify either this or modulesToInstall(com.fasterxml.jackson.databind.Module...), not both.

See Also:

modules(Module...), Module

modulesToInstall

public Jackson2ObjectMapperBuilder modulesToInstall(Module... modules)

Specify one or more modules to be registered with the ObjectMapper.

Modules specified here will be registered after Spring's autodetection of JSR-310 and Joda-Time, or Jackson's finding of modules (see findModulesViaServiceLoader), allowing to eventually override their configuration.

Specify either this or modules, not both.

Since:

4.1.5

See Also:

Module

modulesToInstall

public Jackson2ObjectMapperBuilder modulesToInstall(Class<? extends Module>... modules)

Specify one or more modules by class to be registered with the ObjectMapper.

Modules specified here will be registered after Spring's autodetection of JSR-310 and Joda-Time, or Jackson's finding of modules (see findModulesViaServiceLoader), allowing to eventually override their configuration.

Specify either this or modules, not both.

See Also:

modulesToInstall(Module...), Module

findModulesViaServiceLoader

public Jackson2ObjectMapperBuilder findModulesViaServiceLoader(boolean findModules)

Set whether to let Jackson find available modules via the JDK ServiceLoader, based on META-INF metadata in the classpath. Requires Jackson 2.2 or higher.

If this mode is not set, Spring's Jackson2ObjectMapperBuilder itself will try to find the JSR-310 and Joda-Time support modules on the classpath - provided that Java 8 and Joda-Time themselves are available, respectively.

See Also:

ObjectMapper.findModules()

moduleClassLoader

public Jackson2ObjectMapperBuilder moduleClassLoader(ClassLoader moduleClassLoader)

Set the ClassLoader to use for loading Jackson extension modules.

handlerInstantiator

public Jackson2ObjectMapperBuilder handlerInstantiator(HandlerInstantiator handlerInstantiator)

Customize the construction of Jackson handlers (JsonSerializer, JsonDeserializer, KeyDeserializer, TypeResolverBuilder and TypeIdResolver).

Since:

4.1.3

See Also:

applicationContext(ApplicationContext)

applicationContext

public Jackson2ObjectMapperBuilder applicationContext(org.springframework.context.ApplicationContext applicationContext)

Set the Spring ApplicationContext in order to autowire Jackson handlers (JsonSerializer, JsonDeserializer, KeyDeserializer, TypeResolverBuilder and TypeIdResolver).

Since:

4.1.3

See Also:

SpringHandlerInstantiator

build

public <T extends ObjectMapper> T build()

Build a new ObjectMapper instance.

Each build operation produces an independent ObjectMapper instance. The builder's settings can get modified, with a subsequent build operation then producing a new ObjectMapper based on the most recent settings.

Returns:

the newly built ObjectMapper

configure

public void configure(ObjectMapper objectMapper)

Configure an existing ObjectMapper instance with this builder's settings. This can be applied to any number of ObjectMappers.

Parameters:

objectMapper - the ObjectMapper to configure

json

public static Jackson2ObjectMapperBuilder json()

Obtain a Jackson2ObjectMapperBuilder instance in order to build a regular JSON ObjectMapper instance.

xml

public static Jackson2ObjectMapperBuilder xml()

Obtain a Jackson2ObjectMapperBuilder instance in order to build an XmlMapper instance.