Skip to content

Jackson Release 3.2

Jump to bottom
Tatu Saloranta edited this page Mar 27, 2026 · 162 revisions

Jackson Version 3.2 is under development as of February, 2026.

This wiki page gives a list of links to all changes (with brief descriptions) that will be included.

Status

Version is under development (under branch 3.x).

It will likely NOT be designated as Long-Term-Support (LTS) since 3.1 is an LTS.

Patches

No release yet.

Documentation

Articles, Blog posts

Changes, compatibility

Android

Up to SDK 34 for all components (Jackson 3.1 had SDK 26 for jackson-core, 34 for jackson-databind). Verified by "Animal Sniffer" plug-in.

JDK

Same as Jackson 3.1; Java 17.

Kotlin

Same as Jackson 3.1?

Compatibility: datatype modules

No changes.

Changes, behavior

Databind

Default changes

  • #1329 -- External type property (@JsonTypeInfo(include = As.EXTERNAL_PROPERTY)) deserialized even if visible = false -- fixed to now properly consider visibility
    • Fixes behavior but since wrong behavior has been in for a long time (since Jackson 2.7), a new MapperFeature.EXTERNAL_TYPE_ID_ALWAYS_VISIBLE (default: false) was added: it can be enabled to change behavior back to pre-3.2. (i.e. External Type Id property always visible)
  • #5734 -- "DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES treats absent field same as explicit null" -- changed handling so missing primitive values no longer fail unless DeserializationFeature.FAIL_ON_MISSING_CREATOR_PROPERTIES is enabled

Major focus area(s)

Most wanted Issues resolved

Issues with at least 5 thumbs-ups that were resolved in this version:

  • databind#1757: Regression in JsonInclude.Include.NON_DEFAULT set as global default serialization inclusion (add new MapperFeature.USE_REAL_INCLUDE_NON_DEFAULT)
  • dataformat-xml#306: Can not use @JacksonXmlText for Creator property (creator parameter)

Full Change list

Changes, core

Annotations

No separate 3.x versions released, uses jackson-annotations 2.22.

Streaming

  • #679: Number parsing should fail for trailing dot (period)
  • #1211: Add JsonParser.willInternPropertyNames() to check whether property name interning is enabled
  • #1544: Validate read() parameters in MergedStream and UTF32Reader
  • #1545: Increase Android baseline from 26 to 34 in Jackson 3.2
  • #1564: Add SimpleStreamReadContext.rollbackValueRead() method
  • #1575: Implement document length tracking for DataInput-backed JSON parsers via subclass
  • #1576: Use Java 17 intrinstics for long multiplication

Databind

  • #639: @JacksonInject with @JsonIdentityInfo causes deserialization failure (unresolved forward reference)
  • #1075: @JsonUnwrapped fields with matching @JsonIgnored getter in outer class are ignored
  • #1281: @JsonIgnoreProperties should work for "any getter" (for serialization)
  • #1298: Writing ObjectId reference for @JsonUnwrapped property fails with obscure error message
  • #1329: External type property (@JsonTypeInfo(include = As.EXTERNAL_PROPERTY)) deserialized even if visible = false
  • #1410: Overlap between @JsonTypeInfo.As.PROPERTY indicated type id and field with same name results in UnrecognizedPropertyException
  • #1515: @JsonSerialize(Typing.DYNAMIC) in some cases does not override MapperFeature.USE_STATIC_TYPING
  • #1622: Failure to deserialize child object when using @JsonIgnoreProperties to break cycle
  • #1706: @JsonCreator not working properly with @JsonIdentityInfo when deserializing a collection of interfaces (immutables.io compatibility)
  • #1755: Get NPE on deserializing values with recursive @JsonIgnoreProperties
  • #1757: Regression in JsonInclude.Include.NON_DEFAULT set as global default serialization inclusion (add new MapperFeature.USE_REAL_INCLUDE_NON_DEFAULT)
  • #2039: @JsonUnwrapped and JsonTypeInfo.As.EXTERNAL_PROPERTY in the same bean doesn't work
  • #2572: Can't deserialize inner class if default setter is Nulls.AS_EMPTY
  • #2780: Deserialization with Default Typing and @JsonIdentityInfo in untyped collections fails
  • #3030: Correctly deserialize forward @JsonIdentityInfo references when using @JsonCreator
  • #3064: @JsonPropertyOrder(alphabetic=true) is ignored in case indices are defined for @JsonProperty -- add MapperFeature.SORT_PROPERTIES_BY_INDEX
  • #3083: @JsonIncludeProperties could be used like @JsonPropertyOrder
  • #3166: Ability to sort Sets before serialization (add SerializationFeature.ORDER_SET_ELEMENTS)
  • #3194: Deserialization of 2-dimensional arrays of final types fails when using DefaultTyping.NON_FINAL
  • #3216: Delegating @JsonCreator does not prevent unnecessary introspection of properties, leading to bogus failure
  • #3229: Existing instance of a local/anonymous Class cannot be updated
  • #3355: Deserialization fails depending on the order of deserialized objects with "Cannot construct instance (although at least one Creator exists)"
  • #3573: Inconsistent handling of nil UUID in property inclusion
  • #3591: Ignored fields not consistently exposed via BeanDescription.getIgnoredPropertyNames()
  • #3604: Allow use of JsonNode field for @JsonAnyGetter
  • #4014: No way to combine @JsonTypeInfo(include = As.PROPERTY) and @JsonIdentityInfo(generator = PropertyGenerator.class)
  • #4758: ConfigOverride using Nulls.AS_EMPTY does not work with @JsonManagedReference
  • #4983: JsonTypeInfo.Id.MINIMAL_CLASS generates invalid type on sub-package
  • #5330: @JsonPropertyon enum values with @JsonFormat(shape = JsonFormat.Shape.NUMBER) is ignored
  • #5353: Preserve order of @JsonAnySetter creator property arguments
  • #5615: JsonMapper seems to be not thread-safe when using the polymorphic JsonTypeInfo.As.PROPERTY definition (and @JsonIgnoreProperties)
  • #5727: VisibilityChecker overrides equals() without overriding hashCode()
  • #5734: DeserializationFeature.FAIL_ON_NULL_FOR_PRIMITIVES treats absent field same as explicit null
  • #5814: Enum deserialization does not respect JsonFormat.Feature.ACCEPT_CASE_INSENSITIVE_VALUES override
  • #5821: Fix dead code and side-effect bug in BeanPropertyWriter.toString()

Changes, data formats

Avro

  • #611: Remove IOException from AvroMapper.schemaFrom() method signatures

Smile

  • #674: Smile parser does not update StreamReadContext index or entry count

XML

  • #8: Serialization of List incorrect if property declared as plain java.lang.Object
  • #27: @JacksonXmlElementWrapper conflicting getter/setter definitions for property
  • #149: @JacksonXmlElementWrapper as a @JsonCreator parameter not working
  • #192: Two wrapped lists with items of same name conflict
  • #248: @JacksonXmlProperty with attributes raises an exception when used with @JsonIdentityInfo
  • #299: @JsonUnwrapped with a @JacksonXmlElementWrapper(useWrapping=false) on a collection fails reading from XML
  • #306: Can not use @JacksonXmlText for Creator property (creator parameter)
  • #334: @JacksonXmlElementWrapper(useWrapping=false) fails when using a DeserializerModifier that delegates
  • #344: Unable to (de)serialize null in polymorphic Collection -- may need to use xsi:nil handling?
  • #358: Allow skipping attributes from the http://www.w3.org/2001/XMLSchema-instance namespace (with new XmlReadFeature.SKIP_UNKNOWN_XSI_ATTRIBUTES)
  • #426: InvalidTypeIdException when parsing XML to POJO containing nested List<> , custom TypeIdResolver
  • #449: Trouble dealing with JacksonXMLText if properties are present or if element is in a collection
  • #455: Can't deserialize list in JsonSubtype when type property is visible
  • #496: Root name missing when root element has no attributes (add FromXmlParser.getRootElementName())
  • #514: Deserialisation to polymorphic class using JsonTypeInfo.Id.DEDUCTION and @JacksonXmlElementWrapper annotation fails
  • #517: XML wrapper doesn't work with java records
  • #525: Order of XML Properties trigger different behaviors with polymorphic nested objects
  • #565: Blank text is ignored in @JacksonXmlText
  • #561: Deserializing empty timestamp fields to null value doesn't work (instead becomes "empty", Epoch time)
  • #567: First element in unwrapped XML array is ignored during deserialization to base class
  • #608: Jackson fails to instantiate class when only text node is present
  • #615: Deserialization of Xml with @JacksonXmlText using @JsonCreator (into java.util.Map) fails
  • #627: Disabling wrapper on list (defaultUseWrapper = false) does not serialize/deserialize null lists as expected
  • #629: @JsonAnySetter mangles nested xml Elements and Attributes during serialization
  • #665: @JacksonXmlProperty appears to behave differently than @JsonProperty when used on java records
  • #735: Java Record with @JacksonXmlText stopped working with 2.18
  • #762: Unwrapping lists does not work inside @JsonUnwrapped
  • #767: Unwrapped lists cannot be deserialized when using JsonTypeInfo.As.EXISTING_PROPERTY
  • #795: HttpHeader object (= ) is not wrapped by the XML <property> tag
  • #802: Serialization with Polymorphisme and EXTERNAL_PROPERTY = duplicate property

Clone this wiki locally