Skip to content

Jackson Release 3.1

Jump to bottom
Tatu Saloranta edited this page Nov 23, 2025 · 21 revisions

Jackson Version 3.1 is being developed, as of October 2025.

This wiki page gives a list of links to all changes (with brief descriptions) that will eventually be included, as well as about original plans for bigger changes (and in some cases changes to plans, postponing).

Status

Version is under development (under branch 3.x)

Patches

No release yet.

Documentation

Articles, Blog posts

New Modules

Changes, packaging

Changes, compatibility

Android

Same as Jackson 3.0, SDK 34

JDK

Same as Jackson 3.0: JDK 17

Kotlin

Same as Jackson 3.0?

Changes, behavior

Missing/absent AtomicReference deserialization

With databind#5350 -- addition of DeserializationFeature.USE_NULL_FOR_MISSING_REFERENCE_VALUES -- the default deserialization behavior of AtomicReference<T> changes to same as that of Optional<T>:

  • If value is missing (absent) from incoming JSON AND AtomicReference is passed through Constructor, "empty" value (new AtomicReference<>(null)) will be deserialized instead of null (as previously).
  • Change necessary to add configurability, improves consistency.

Full Change list

Changes, core

Annotations

Streaming

  • #784: Optional leading plus sign not included in textual value of any integral nor all floating-point numbers
  • #1506: Non-blocking parser parses numbers eagerly; does not report error with missing space

Databind

  • #5350: Add DeserializationFeature.USE_NULL_FOR_MISSING_REFERENCE_VALUES for selecting null vs "empty/absent" value when deserializing missing Optional value
  • #5361: Fix Maven SBOM publishing (worked in 3.0.0-rc4 but not in rc5 or later)
  • #5413: Add/support forward reference resolution for array values
  • date-time#359: InstantDeserializer deserializes the nanosecond portion of fractional negative timestamps incorrectly
    • NOTE: ported over to embedded Java 8 Date/Time functionality

Changes, data formats

Avro

  • #619: Add isEnabled() methods for format-specific features to mappers
  • #628: Uncommon parent pom dependency configuration in Jackson 2.20/3.0

CBOR

  • #619: Add isEnabled() methods for format-specific features to mappers
  • #628: Uncommon parent pom dependency configuration in Jackson 2.20/3.0

CSV

  • #581: Add isEnabled() methods for format-specific features to mappers

Ion

  • #619: Add isEnabled() methods for format-specific features to mappers
  • #623: Upgrade ion-java dep to 1.11.11 (from 1.11.10)
  • #628: Uncommon parent pom dependency configuration in Jackson 2.20/3.0
  • #629: Unnecessary IOException in IonObjectMapper method signatures

Protobuf

  • #598: Protobuf parser state handling wrong for implicit close (END_OBJECT)
  • #628: Uncommon parent pom dependency configuration in Jackson 2.20/3.0

Smile

  • #619: Add isEnabled() methods for format-specific features to mappers
  • #628: Uncommon parent pom dependency configuration in Jackson 2.20/3.0

TOML

  • #581: Add isEnabled() methods for format-specific features to mappers

XML

  • #780: Add isEnabled() methods for format-specific features to mappers

YAML

  • #568: YAML - ScannerException on block scalar "\n"
  • #581: Add isEnabled() methods for format-specific features to mappers
  • #590: Upgrade to the latest version of SnakeYAML Engine (3.0.1)

Changes, data types

Joda Money

    • #581: Add field-level amount representation for Joda-Money (@JodaMoney annotation)

Changes, Other modules

Afterburner

  • #317: Update byte-buddy to latest (1.17.8) from 1.15.1

Mr Bean

  • #317: Update byte-buddy to latest (1.17.8) from 1.15.1
  • #320: Remove byte-buddy shading from 3.1 MrBean

Changes, other

N/A

Clone this wiki locally