public class Jackson2ObjectMapperBuilder extends Object
ObjectMapper instances with a fluent API.
It customizes Jackson's default properties with the following ones:
MapperFeature.DEFAULT_VIEW_INCLUSION is disabledDeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES is disabledIt also automatically registers the following well-known modules if they are detected on the classpath:
OptionalCompatible with Jackson 2.9 to 2.12, as of Spring 5.3.
build(),
configure(ObjectMapper),
Jackson2ObjectMapperFactoryBean| Constructor and Description |
|---|
Jackson2ObjectMapperBuilder() |
| Modifier and Type | Method and Description |
|---|---|
Jackson2ObjectMapperBuilder |
annotationIntrospector(AnnotationIntrospector annotationIntrospector)
Set an
AnnotationIntrospector for both serialization and deserialization. |
Jackson2ObjectMapperBuilder |
annotationIntrospector(Function<AnnotationIntrospector,AnnotationIntrospector> pairingFunction)
Alternative to
annotationIntrospector(AnnotationIntrospector)
that allows combining with rather than replacing the currently set
introspector, e.g. |
Jackson2ObjectMapperBuilder |
applicationContext(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)
|
<T extends ObjectMapper> |
build()
Build a new
ObjectMapper instance. |
static Jackson2ObjectMapperBuilder |
cbor()
Obtain a
Jackson2ObjectMapperBuilder instance in order to
build a CBOR data format 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 |
defaultTyping(TypeResolverBuilder<?> typeResolverBuilder)
Specify a
TypeResolverBuilder to use for Jackson's default typing. |
Jackson2ObjectMapperBuilder |
defaultUseWrapper(boolean defaultUseWrapper)
Define if a wrapper will be used for indexed (List, array) properties or not by
default (only applies to
XmlMapper). |
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 |
deserializers(JsonDeserializer<?>... deserializers)
Configure custom deserializers.
|
Jackson2ObjectMapperBuilder |
deserializersByType(Map<Class<?>,JsonDeserializer<?>> deserializers)
Configure custom deserializers for the given types.
|
Jackson2ObjectMapperBuilder |
factory(JsonFactory factory)
Define the
JsonFactory to be used to create the ObjectMapper
instance. |
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 |
postConfigurer(Consumer<ObjectMapper> configurer)
An option to apply additional customizations directly to the
ObjectMapper instances at the end, after all other config
properties of the builder have been applied. |
Jackson2ObjectMapperBuilder |
propertyNamingStrategy(PropertyNamingStrategy propertyNamingStrategy)
Specify a
PropertyNamingStrategy to
configure the ObjectMapper with. |
Jackson2ObjectMapperBuilder |
serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Include inclusion)
Set a custom inclusion strategy for serialization.
|
Jackson2ObjectMapperBuilder |
serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Value 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. |
static Jackson2ObjectMapperBuilder |
smile()
Obtain a
Jackson2ObjectMapperBuilder instance in order to
build a Smile data format ObjectMapper instance. |
Jackson2ObjectMapperBuilder |
timeZone(String timeZoneString)
Override the default
TimeZone to use for formatting. |
Jackson2ObjectMapperBuilder |
timeZone(TimeZone timeZone)
Override the default
TimeZone to use for formatting. |
Jackson2ObjectMapperBuilder |
visibility(com.fasterxml.jackson.annotation.PropertyAccessor accessor,
com.fasterxml.jackson.annotation.JsonAutoDetect.Visibility visibility)
Specify visibility to limit what kind of properties are auto-detected.
|
static Jackson2ObjectMapperBuilder |
xml()
Obtain a
Jackson2ObjectMapperBuilder instance in order to
build an XmlMapper instance. |
public Jackson2ObjectMapperBuilder createXmlMapper(boolean createXmlMapper)
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.public Jackson2ObjectMapperBuilder factory(JsonFactory factory)
JsonFactory to be used to create the ObjectMapper
instance.public Jackson2ObjectMapperBuilder dateFormat(DateFormat dateFormat)
DateFormat.
Note: Setting this property makes the exposed ObjectMapper
non-thread-safe, according to Jackson's thread safety rules.
simpleDateFormat(String)public Jackson2ObjectMapperBuilder simpleDateFormat(String format)
SimpleDateFormat.
Note: Setting this property makes the exposed ObjectMapper
non-thread-safe, according to Jackson's thread safety rules.
dateFormat(DateFormat)public Jackson2ObjectMapperBuilder locale(Locale locale)
Locale to use for formatting.
Default value used is Locale.getDefault().public Jackson2ObjectMapperBuilder locale(String localeString)
Locale to use for formatting.
Default value used is Locale.getDefault().localeString - the locale ID as a String representationpublic Jackson2ObjectMapperBuilder timeZone(TimeZone timeZone)
TimeZone to use for formatting.
Default value used is UTC (NOT local timezone).public Jackson2ObjectMapperBuilder timeZone(String timeZoneString)
TimeZone to use for formatting.
Default value used is UTC (NOT local timezone).timeZoneString - the zone ID as a String representationpublic Jackson2ObjectMapperBuilder annotationIntrospector(AnnotationIntrospector annotationIntrospector)
AnnotationIntrospector for both serialization and deserialization.public Jackson2ObjectMapperBuilder annotationIntrospector(Function<AnnotationIntrospector,AnnotationIntrospector> pairingFunction)
annotationIntrospector(AnnotationIntrospector)
that allows combining with rather than replacing the currently set
introspector, e.g. via
AnnotationIntrospector.pair(AnnotationIntrospector, AnnotationIntrospector).pairingFunction - a function to apply to the currently set
introspector (possibly null); the result of the function becomes
the new introspector.public Jackson2ObjectMapperBuilder propertyNamingStrategy(PropertyNamingStrategy propertyNamingStrategy)
PropertyNamingStrategy to
configure the ObjectMapper with.public Jackson2ObjectMapperBuilder defaultTyping(TypeResolverBuilder<?> typeResolverBuilder)
TypeResolverBuilder to use for Jackson's default typing.public Jackson2ObjectMapperBuilder serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Include inclusion)
JsonInclude.Includepublic Jackson2ObjectMapperBuilder serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Value serializationInclusion)
JsonInclude.Valuepublic Jackson2ObjectMapperBuilder filters(FilterProvider filters)
@JsonFilter annotated POJO.MappingJacksonValue.setFilters(FilterProvider)public Jackson2ObjectMapperBuilder mixIn(Class<?> target, Class<?> mixinSource)
target - class (or interface) whose annotations to effectively overridemixinSource - class (or interface) whose annotations are to be "added"
to target's annotations as valueObjectMapper.addMixIn(Class, Class)public Jackson2ObjectMapperBuilder mixIns(Map<Class<?>,Class<?>> mixIns)
mixIns - a 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.ObjectMapper.addMixIn(Class, Class)public Jackson2ObjectMapperBuilder serializers(JsonSerializer<?>... serializers)
JsonSerializer.handledType(), which must not be null.serializersByType(Map)public Jackson2ObjectMapperBuilder serializerByType(Class<?> type, JsonSerializer<?> serializer)
serializers(JsonSerializer...)public Jackson2ObjectMapperBuilder serializersByType(Map<Class<?>,JsonSerializer<?>> serializers)
serializers(JsonSerializer...)public Jackson2ObjectMapperBuilder deserializers(JsonDeserializer<?>... deserializers)
JsonDeserializer.handledType(), which must not be null.deserializersByType(Map)public Jackson2ObjectMapperBuilder deserializerByType(Class<?> type, JsonDeserializer<?> deserializer)
public Jackson2ObjectMapperBuilder deserializersByType(Map<Class<?>,JsonDeserializer<?>> deserializers)
public Jackson2ObjectMapperBuilder autoDetectFields(boolean autoDetectFields)
MapperFeature.AUTO_DETECT_FIELDS option.public Jackson2ObjectMapperBuilder autoDetectGettersSetters(boolean autoDetectGettersSetters)
public Jackson2ObjectMapperBuilder defaultViewInclusion(boolean defaultViewInclusion)
MapperFeature.DEFAULT_VIEW_INCLUSION option.public Jackson2ObjectMapperBuilder failOnUnknownProperties(boolean failOnUnknownProperties)
DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES option.public Jackson2ObjectMapperBuilder failOnEmptyBeans(boolean failOnEmptyBeans)
SerializationFeature.FAIL_ON_EMPTY_BEANS option.public Jackson2ObjectMapperBuilder indentOutput(boolean indentOutput)
SerializationFeature.INDENT_OUTPUT option.public Jackson2ObjectMapperBuilder defaultUseWrapper(boolean defaultUseWrapper)
XmlMapper).public Jackson2ObjectMapperBuilder visibility(com.fasterxml.jackson.annotation.PropertyAccessor accessor, com.fasterxml.jackson.annotation.JsonAutoDetect.Visibility visibility)
PropertyAccessor,
JsonAutoDetect.Visibilitypublic Jackson2ObjectMapperBuilder featuresToEnable(Object... featuresToEnable)
public Jackson2ObjectMapperBuilder featuresToDisable(Object... featuresToDisable)
public Jackson2ObjectMapperBuilder modules(Module... modules)
ObjectMapper.
Multiple invocations are not additive, the last one defines the modules to register.
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.
modules(List),
Modulepublic Jackson2ObjectMapperBuilder modules(List<Module> modules)
ObjectMapper.
Multiple invocations are not additive, the last one defines the modules to register.
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.
modules(Module...),
Modulepublic Jackson2ObjectMapperBuilder modulesToInstall(Module... modules)
ObjectMapper.
Multiple invocations are not additive, the last one defines the modules to register.
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(Module...), not both.
modulesToInstall(Class...),
Module@SafeVarargs public final Jackson2ObjectMapperBuilder modulesToInstall(Class<? extends Module>... modules)
ObjectMapper.
Multiple invocations are not additive, the last one defines the modules to register.
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(Module...), not both.
modulesToInstall(Module...),
Modulepublic Jackson2ObjectMapperBuilder findModulesViaServiceLoader(boolean findModules)
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.
ObjectMapper.findModules()public Jackson2ObjectMapperBuilder moduleClassLoader(ClassLoader moduleClassLoader)
public Jackson2ObjectMapperBuilder handlerInstantiator(HandlerInstantiator handlerInstantiator)
JsonSerializer, JsonDeserializer,
KeyDeserializer, TypeResolverBuilder and TypeIdResolver).applicationContext(ApplicationContext)public Jackson2ObjectMapperBuilder applicationContext(ApplicationContext applicationContext)
ApplicationContext in order to autowire Jackson handlers (JsonSerializer,
JsonDeserializer, KeyDeserializer, TypeResolverBuilder and TypeIdResolver).SpringHandlerInstantiatorpublic Jackson2ObjectMapperBuilder postConfigurer(Consumer<ObjectMapper> configurer)
ObjectMapper instances at the end, after all other config
properties of the builder have been applied.configurer - a configurer to apply. If several configurers are
registered, they will get applied in their registration order.public <T extends ObjectMapper> T build()
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.
public void configure(ObjectMapper objectMapper)
ObjectMapper instance with this builder's
settings. This can be applied to any number of ObjectMappers.objectMapper - the ObjectMapper to configurepublic static Jackson2ObjectMapperBuilder json()
Jackson2ObjectMapperBuilder instance in order to
build a regular JSON ObjectMapper instance.public static Jackson2ObjectMapperBuilder xml()
Jackson2ObjectMapperBuilder instance in order to
build an XmlMapper instance.public static Jackson2ObjectMapperBuilder smile()
Jackson2ObjectMapperBuilder instance in order to
build a Smile data format ObjectMapper instance.public static Jackson2ObjectMapperBuilder cbor()
Jackson2ObjectMapperBuilder instance in order to
build a CBOR data format ObjectMapper instance.