Class Jackson2ObjectMapperBuilder

java.lang.Object
org.springframework.http.converter.json.Jackson2ObjectMapperBuilder

@Deprecated(since="7.0", forRemoval=true) public class Jackson2ObjectMapperBuilder extends Object
Deprecated, for removal: This API element is subject to removal in a future version.
since 7.0 in favor using directly Jackson 3 builders like JsonMapper.builder()
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:

Since:
4.1.1
Author:
Sebastien Deleuze, Juergen Hoeller, Tadaya Tsuyukubo, EddĂș MelĂ©ndez, Hyoungjune Kim
See Also:
  • Constructor Summary

    Constructors
    Constructor
    Description
    Deprecated, for removal: This API element is subject to removal in a future version.
     
  • Method Summary

    Modifier and Type
    Method
    Description
    annotationIntrospector(com.fasterxml.jackson.databind.AnnotationIntrospector annotationIntrospector)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Set an AnnotationIntrospector for both serialization and deserialization.
    annotationIntrospector(Function<@Nullable com.fasterxml.jackson.databind.AnnotationIntrospector, @Nullable com.fasterxml.jackson.databind.AnnotationIntrospector> pairingFunction)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Alternative to annotationIntrospector(AnnotationIntrospector) that allows combining with rather than replacing the currently set introspector, for example, via AnnotationIntrospector.pair(AnnotationIntrospector, AnnotationIntrospector).
    Deprecated, for removal: This API element is subject to removal in a future version.
    Set the Spring ApplicationContext in order to autowire Jackson handlers (JsonSerializer, JsonDeserializer, KeyDeserializer, TypeResolverBuilder and TypeIdResolver).
    autoDetectFields(boolean autoDetectFields)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Shortcut for MapperFeature.AUTO_DETECT_FIELDS option.
    autoDetectGettersSetters(boolean autoDetectGettersSetters)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Shortcut for MapperFeature.AUTO_DETECT_SETTERS/ MapperFeature.AUTO_DETECT_GETTERS/MapperFeature.AUTO_DETECT_IS_GETTERS options.
    <T extends com.fasterxml.jackson.databind.ObjectMapper>
    T
    Deprecated, for removal: This API element is subject to removal in a future version.
    Build a new ObjectMapper instance.
    Deprecated, for removal: This API element is subject to removal in a future version.
    Obtain a Jackson2ObjectMapperBuilder instance in order to build a CBOR data format ObjectMapper instance.
    void
    configure(com.fasterxml.jackson.databind.ObjectMapper objectMapper)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Configure an existing ObjectMapper instance with this builder's settings.
    createXmlMapper(boolean createXmlMapper)
    Deprecated, for removal: This API element is subject to removal in a future version.
    If set to true, an XmlMapper will be created using its default constructor.
    dateFormat(DateFormat dateFormat)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Define the format for date/time with the given DateFormat.
    defaultTyping(com.fasterxml.jackson.databind.jsontype.TypeResolverBuilder<?> typeResolverBuilder)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Specify a TypeResolverBuilder to use for Jackson's default typing.
    defaultUseWrapper(boolean defaultUseWrapper)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Define if a wrapper will be used for indexed (List, array) properties or not by default (only applies to XmlMapper).
    defaultViewInclusion(boolean defaultViewInclusion)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Shortcut for MapperFeature.DEFAULT_VIEW_INCLUSION option.
    deserializerByType(Class<?> type, com.fasterxml.jackson.databind.JsonDeserializer<?> deserializer)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Configure a custom deserializer for the given type.
    deserializers(com.fasterxml.jackson.databind.JsonDeserializer<?>... deserializers)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Configure custom deserializers.
    deserializersByType(Map<Class<?>, com.fasterxml.jackson.databind.JsonDeserializer<?>> deserializers)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Configure custom deserializers for the given types.
    factory(com.fasterxml.jackson.core.JsonFactory factory)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Define the JsonFactory to be used to create the ObjectMapper instance.
    failOnEmptyBeans(boolean failOnEmptyBeans)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Shortcut for SerializationFeature.FAIL_ON_EMPTY_BEANS option.
    failOnUnknownProperties(boolean failOnUnknownProperties)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Shortcut for DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES option.
    featuresToDisable(Object... featuresToDisable)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Specify features to disable.
    featuresToEnable(Object... featuresToEnable)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Specify features to enable.
    filters(com.fasterxml.jackson.databind.ser.FilterProvider filters)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Set the global filters to use in order to support @JsonFilter annotated POJO.
    findModulesViaServiceLoader(boolean findModules)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Set whether to let Jackson find available modules via the JDK ServiceLoader, based on META-INF metadata in the classpath.
    handlerInstantiator(com.fasterxml.jackson.databind.cfg.HandlerInstantiator handlerInstantiator)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Customize the construction of Jackson handlers (JsonSerializer, JsonDeserializer, KeyDeserializer, TypeResolverBuilder and TypeIdResolver).
    indentOutput(boolean indentOutput)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Shortcut for SerializationFeature.INDENT_OUTPUT option.
    Deprecated, for removal: This API element is subject to removal in a future version.
    Obtain a Jackson2ObjectMapperBuilder instance in order to build a regular JSON ObjectMapper instance.
    locale(String localeString)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Override the default Locale to use for formatting.
    locale(Locale locale)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Override the default Locale to use for formatting.
    mixIn(Class<?> target, Class<?> mixinSource)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Add mix-in annotations to use for augmenting specified class or interface.
    mixIns(Map<Class<?>,Class<?>> mixIns)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Add mix-in annotations to use for augmenting specified class or interface.
    moduleClassLoader(ClassLoader moduleClassLoader)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Set the ClassLoader to use for loading Jackson extension modules.
    modules(com.fasterxml.jackson.databind.Module... modules)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Specify the modules to be registered with the ObjectMapper.
    modules(Consumer<List<com.fasterxml.jackson.databind.Module>> consumer)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Variant of modules(Module...) with a Consumer for full control over the underlying list of modules.
    modules(List<com.fasterxml.jackson.databind.Module> modules)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Variant of modules(Module...) with a List.
    modulesToInstall(com.fasterxml.jackson.databind.Module... modules)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Specify one or more modules to be registered with the ObjectMapper.
    modulesToInstall(Class<? extends com.fasterxml.jackson.databind.Module>... modules)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Specify one or more modules by class to be registered with the ObjectMapper.
    modulesToInstall(Consumer<List<com.fasterxml.jackson.databind.Module>> consumer)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Variant of modulesToInstall(Module...) with a Consumer for full control over the underlying list of modules.
    postConfigurer(Consumer<com.fasterxml.jackson.databind.ObjectMapper> configurer)
    Deprecated, for removal: This API element is subject to removal in a future version.
    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.
    propertyNamingStrategy(com.fasterxml.jackson.databind.PropertyNamingStrategy propertyNamingStrategy)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Specify a PropertyNamingStrategy to configure the ObjectMapper with.
    serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Include inclusion)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Set a custom inclusion strategy for serialization.
    serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Value serializationInclusion)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Set a custom inclusion strategy for serialization.
    serializerByType(Class<?> type, com.fasterxml.jackson.databind.JsonSerializer<?> serializer)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Configure a custom serializer for the given type.
    serializers(com.fasterxml.jackson.databind.JsonSerializer<?>... serializers)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Configure custom serializers.
    serializersByType(Map<Class<?>, com.fasterxml.jackson.databind.JsonSerializer<?>> serializers)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Configure custom serializers for the given types.
    Deprecated, for removal: This API element is subject to removal in a future version.
    Define the date/time format with a SimpleDateFormat.
    Deprecated, for removal: This API element is subject to removal in a future version.
    Obtain a Jackson2ObjectMapperBuilder instance in order to build a Smile data format ObjectMapper instance.
    timeZone(String timeZoneString)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Override the default TimeZone to use for formatting.
    timeZone(TimeZone timeZone)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Override the default TimeZone to use for formatting.
    visibility(com.fasterxml.jackson.annotation.PropertyAccessor accessor, com.fasterxml.jackson.annotation.JsonAutoDetect.Visibility visibility)
    Deprecated, for removal: This API element is subject to removal in a future version.
    Specify visibility to limit what kind of properties are auto-detected.
    xml()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Obtain a Jackson2ObjectMapperBuilder instance in order to build an XmlMapper instance.
    Deprecated, for removal: This API element is subject to removal in a future version.
    Obtain a Jackson2ObjectMapperBuilder instance in order to build a YAML data format ObjectMapper instance.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Constructor Details

    • Jackson2ObjectMapperBuilder

      public Jackson2ObjectMapperBuilder()
      Deprecated, for removal: This API element is subject to removal in a future version.
  • Method Details

    • createXmlMapper

      public Jackson2ObjectMapperBuilder createXmlMapper(boolean createXmlMapper)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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.
    • factory

      public Jackson2ObjectMapperBuilder factory(com.fasterxml.jackson.core.JsonFactory factory)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Define the JsonFactory to be used to create the ObjectMapper instance.
      Since:
      5.0
    • dateFormat

      public Jackson2ObjectMapperBuilder dateFormat(DateFormat dateFormat)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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

      public Jackson2ObjectMapperBuilder simpleDateFormat(String format)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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:
    • locale

      public Jackson2ObjectMapperBuilder locale(Locale locale)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Override the default Locale to use for formatting.

      Default value used is Locale.getDefault().

      Since:
      4.1.5
    • locale

      public Jackson2ObjectMapperBuilder locale(String localeString)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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(com.fasterxml.jackson.databind.AnnotationIntrospector annotationIntrospector)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Set an AnnotationIntrospector for both serialization and deserialization.
    • annotationIntrospector

      public Jackson2ObjectMapperBuilder annotationIntrospector(Function<@Nullable com.fasterxml.jackson.databind.AnnotationIntrospector, @Nullable com.fasterxml.jackson.databind.AnnotationIntrospector> pairingFunction)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Alternative to annotationIntrospector(AnnotationIntrospector) that allows combining with rather than replacing the currently set introspector, for example, via AnnotationIntrospector.pair(AnnotationIntrospector, AnnotationIntrospector).
      Parameters:
      pairingFunction - a function to apply to the currently set introspector (possibly null); the result of the function becomes the new introspector.
      Since:
      5.2.4
    • propertyNamingStrategy

      public Jackson2ObjectMapperBuilder propertyNamingStrategy(com.fasterxml.jackson.databind.PropertyNamingStrategy propertyNamingStrategy)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Specify a PropertyNamingStrategy to configure the ObjectMapper with.
    • defaultTyping

      public Jackson2ObjectMapperBuilder defaultTyping(com.fasterxml.jackson.databind.jsontype.TypeResolverBuilder<?> typeResolverBuilder)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Specify a TypeResolverBuilder to use for Jackson's default typing.
      Since:
      4.2.2
    • serializationInclusion

      public Jackson2ObjectMapperBuilder serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Include inclusion)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Set a custom inclusion strategy for serialization.
      See Also:
      • JsonInclude.Include
    • serializationInclusion

      public Jackson2ObjectMapperBuilder serializationInclusion(com.fasterxml.jackson.annotation.JsonInclude.Value serializationInclusion)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Set a custom inclusion strategy for serialization.
      Since:
      5.3
      See Also:
      • JsonInclude.Value
    • filters

      public Jackson2ObjectMapperBuilder filters(com.fasterxml.jackson.databind.ser.FilterProvider filters)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Set the global filters to use in order to support @JsonFilter annotated POJO.
      Since:
      4.2
      See Also:
    • mixIn

      public Jackson2ObjectMapperBuilder mixIn(Class<?> target, Class<?> mixinSource)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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.addMixIn(Class, Class)
    • mixIns

      public Jackson2ObjectMapperBuilder mixIns(Map<Class<?>,Class<?>> mixIns)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Add mix-in annotations to use for augmenting specified class or interface.
      Parameters:
      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.
      Since:
      4.1.2
      See Also:
      • ObjectMapper.addMixIn(Class, Class)
    • serializers

      public Jackson2ObjectMapperBuilder serializers(com.fasterxml.jackson.databind.JsonSerializer<?>... serializers)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Configure custom serializers. Each serializer is registered for the type returned by JsonSerializer.handledType(), which must not be null.
      See Also:
    • serializerByType

      public Jackson2ObjectMapperBuilder serializerByType(Class<?> type, com.fasterxml.jackson.databind.JsonSerializer<?> serializer)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Configure a custom serializer for the given type.
      Since:
      4.1.2
      See Also:
    • serializersByType

      public Jackson2ObjectMapperBuilder serializersByType(Map<Class<?>, com.fasterxml.jackson.databind.JsonSerializer<?>> serializers)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Configure custom serializers for the given types.
      See Also:
    • deserializers

      public Jackson2ObjectMapperBuilder deserializers(com.fasterxml.jackson.databind.JsonDeserializer<?>... deserializers)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Configure custom deserializers. Each deserializer is registered for the type returned by JsonDeserializer.handledType(), which must not be null.
      Since:
      4.3
      See Also:
    • deserializerByType

      public Jackson2ObjectMapperBuilder deserializerByType(Class<?> type, com.fasterxml.jackson.databind.JsonDeserializer<?> deserializer)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Configure a custom deserializer for the given type.
      Since:
      4.1.2
    • deserializersByType

      public Jackson2ObjectMapperBuilder deserializersByType(Map<Class<?>, com.fasterxml.jackson.databind.JsonDeserializer<?>> deserializers)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Configure custom deserializers for the given types.
    • autoDetectFields

      public Jackson2ObjectMapperBuilder autoDetectFields(boolean autoDetectFields)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Shortcut for MapperFeature.AUTO_DETECT_FIELDS option.
    • autoDetectGettersSetters

      public Jackson2ObjectMapperBuilder autoDetectGettersSetters(boolean autoDetectGettersSetters)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Shortcut for MapperFeature.AUTO_DETECT_SETTERS/ MapperFeature.AUTO_DETECT_GETTERS/MapperFeature.AUTO_DETECT_IS_GETTERS options.
    • defaultViewInclusion

      public Jackson2ObjectMapperBuilder defaultViewInclusion(boolean defaultViewInclusion)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Shortcut for MapperFeature.DEFAULT_VIEW_INCLUSION option.
    • failOnUnknownProperties

      public Jackson2ObjectMapperBuilder failOnUnknownProperties(boolean failOnUnknownProperties)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Shortcut for DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES option.
    • failOnEmptyBeans

      public Jackson2ObjectMapperBuilder failOnEmptyBeans(boolean failOnEmptyBeans)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Shortcut for SerializationFeature.FAIL_ON_EMPTY_BEANS option.
    • indentOutput

      public Jackson2ObjectMapperBuilder indentOutput(boolean indentOutput)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Shortcut for SerializationFeature.INDENT_OUTPUT option.
    • defaultUseWrapper

      public Jackson2ObjectMapperBuilder defaultUseWrapper(boolean defaultUseWrapper)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Define if a wrapper will be used for indexed (List, array) properties or not by default (only applies to XmlMapper).
      Since:
      4.3
    • visibility

      public Jackson2ObjectMapperBuilder visibility(com.fasterxml.jackson.annotation.PropertyAccessor accessor, com.fasterxml.jackson.annotation.JsonAutoDetect.Visibility visibility)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Specify visibility to limit what kind of properties are auto-detected.
      Since:
      5.1
      See Also:
      • PropertyAccessor
      • JsonAutoDetect.Visibility
    • featuresToEnable

      public Jackson2ObjectMapperBuilder featuresToEnable(Object... featuresToEnable)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Specify features to enable.
      See Also:
      • JsonParser.Feature
      • JsonGenerator.Feature
      • SerializationFeature
      • DeserializationFeature
      • MapperFeature
    • featuresToDisable

      public Jackson2ObjectMapperBuilder featuresToDisable(Object... featuresToDisable)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Specify features to disable.
      See Also:
      • JsonParser.Feature
      • JsonGenerator.Feature
      • SerializationFeature
      • DeserializationFeature
      • MapperFeature
    • modules

      public Jackson2ObjectMapperBuilder modules(com.fasterxml.jackson.databind.Module... modules)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Specify the modules to be registered with the ObjectMapper.

      Multiple invocations are not additive; the last one defines the modules to register.

      Note: If this is set, autodetection of modules will not occur — 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

      public Jackson2ObjectMapperBuilder modules(List<com.fasterxml.jackson.databind.Module> modules)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Variant of modules(Module...) with a List.
      See Also:
    • modules

      public Jackson2ObjectMapperBuilder modules(Consumer<List<com.fasterxml.jackson.databind.Module>> consumer)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Variant of modules(Module...) with a Consumer for full control over the underlying list of modules.
      Since:
      5.3.22
      See Also:
    • modulesToInstall

      public Jackson2ObjectMapperBuilder modulesToInstall(com.fasterxml.jackson.databind.Module... modules)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Specify one or more modules to be registered with the 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, or Jackson's finding of modules (see findModulesViaServiceLoader), allowing to eventually override their configuration.

      Specify either this or modules(Module...), not both.

      Since:
      4.1.5
      See Also:
    • modulesToInstall

      public Jackson2ObjectMapperBuilder modulesToInstall(Consumer<List<com.fasterxml.jackson.databind.Module>> consumer)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Variant of modulesToInstall(Module...) with a Consumer for full control over the underlying list of modules.
      Since:
      5.3.22
      See Also:
    • modulesToInstall

      @SafeVarargs public final Jackson2ObjectMapperBuilder modulesToInstall(Class<? extends com.fasterxml.jackson.databind.Module>... modules)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Specify one or more modules by class to be registered with the 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, or Jackson's finding of modules (see findModulesViaServiceLoader), allowing to eventually override their configuration.

      Specify either this or modules(Module...), not both.

      See Also:
    • findModulesViaServiceLoader

      public Jackson2ObjectMapperBuilder findModulesViaServiceLoader(boolean findModules)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Set whether to let Jackson find available modules via the JDK ServiceLoader, based on META-INF metadata in the classpath.

      If this mode is not set, Spring's Jackson2ObjectMapperBuilder itself will try to find the JSR-310 support module on the classpath.

      See Also:
      • ObjectMapper.findModules()
    • moduleClassLoader

      public Jackson2ObjectMapperBuilder moduleClassLoader(ClassLoader moduleClassLoader)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Set the ClassLoader to use for loading Jackson extension modules.
    • handlerInstantiator

      public Jackson2ObjectMapperBuilder handlerInstantiator(com.fasterxml.jackson.databind.cfg.HandlerInstantiator handlerInstantiator)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Customize the construction of Jackson handlers (JsonSerializer, JsonDeserializer, KeyDeserializer, TypeResolverBuilder and TypeIdResolver).
      Since:
      4.1.3
      See Also:
    • applicationContext

      public Jackson2ObjectMapperBuilder applicationContext(ApplicationContext applicationContext)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Set the Spring ApplicationContext in order to autowire Jackson handlers (JsonSerializer, JsonDeserializer, KeyDeserializer, TypeResolverBuilder and TypeIdResolver).
      Since:
      4.1.3
      See Also:
    • postConfigurer

      public Jackson2ObjectMapperBuilder postConfigurer(Consumer<com.fasterxml.jackson.databind.ObjectMapper> configurer)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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.
      Parameters:
      configurer - a configurer to apply. If several configurers are registered, they will get applied in their registration order.
      Since:
      5.3
    • build

      public <T extends com.fasterxml.jackson.databind.ObjectMapper> T build()
      Deprecated, for removal: This API element is subject to removal in a future version.
      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(com.fasterxml.jackson.databind.ObjectMapper objectMapper)
      Deprecated, for removal: This API element is subject to removal in a future version.
      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()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Obtain a Jackson2ObjectMapperBuilder instance in order to build a regular JSON ObjectMapper instance.
    • xml

      public static Jackson2ObjectMapperBuilder xml()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Obtain a Jackson2ObjectMapperBuilder instance in order to build an XmlMapper instance.
    • smile

      public static Jackson2ObjectMapperBuilder smile()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Obtain a Jackson2ObjectMapperBuilder instance in order to build a Smile data format ObjectMapper instance.
      Since:
      5.0
    • cbor

      public static Jackson2ObjectMapperBuilder cbor()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Obtain a Jackson2ObjectMapperBuilder instance in order to build a CBOR data format ObjectMapper instance.
      Since:
      5.0
    • yaml

      public static Jackson2ObjectMapperBuilder yaml()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Obtain a Jackson2ObjectMapperBuilder instance in order to build a YAML data format ObjectMapper instance.
      Since:
      6.2