Goal of this Discussion

This Discussion is "uber-discussion" covering the high-level scope of what the official Jackson 3.0.0 Release should include, along with bit of status of the progress. Most of content will be links to other pages, issues, discussions in other repos (with actual Issues, for example).

Note that while most issues were planned to be addressed by 3.0.0-rc1 (the first pre-release), we also want to follow "release early, release often" to get a tight feedback loop -- i.e. not get too ambitious on specific RC release.

Jackson 3.0.0: Requirements

To reach state where we are ready to publish the final 3.0.0, we have to tackle following things.
(note: this document is work-in-progress and will continue living -- it is not a static requirements document).

RCs

Lower level details about specific release candidates are on sub-discussions:

• 3.0.0-rc1 -- released on March 7, 2025
• 3.0.0-rc2 -- released on March 28, 2025
• 3.0.0-rc3 -- released on April 13, 2025
• 3.0.0-rc4 -- released on May 10, 2025
• 3.0.0-rc5 -- released on May 22, 2025
• 3.0.0-rc6 -- released on July 18, 2025
• 3.0.0-rc7: is one more RC needed before 3.0.0 final?

JSTEPs

See JSTEP Overview for an overview what JSTEPs are. They can be thought as an effort bigger than what a single Issue can cover, and are natural way to group such efforts.

For 3.0.0 we want to tackle most of them, specifically:

Note that we can create new JTEPs and reconsider ones not completed.
Some JSTEPs are also for 2.x, not 3.0 (and others for later 3.x versions beyond initial one).

Of these, ones with specific urgency are:

• JSTEP-5 Unified/improved Data/Time handling -- much more involved, need to
  • Scope wrt "classic" java.util.Date / Java 8 Date/Time / Joda
  • -- Decide on changes to default settings (done)
  • Decide on changes to behavior in general
  • Possibly new configurability options
    • partly done with new DateTimeFeature
  • ... and implementing above
• JSTEP-14
  • Done except need to finalize classifier to use: initial proposal is "sbom-cyclonedx" (but plug-in default simple "cyclonedx")

Things to decide (polls!)

Here are things to decide on proposed changes: please vote if you have opinion on whether change suggested is desired.

You may also add comments explaining your reasoning, as well as upvote comments by others.

General

• Minimum Java Version for 3.0.0 (17 vs 21) (databind#4820)
  • DECIDED: JDK 17 is the 3.0 baseline
  • IMPLEMENTED
• Deprecate+remove Hibernate modules from 3.0.0
  • DECIDED: no 3.0 version of Hibernate modules will be created
  • IMPLEMENTED (by not creating 3.0 modules)

Changes to Feature defaults

• Poll Default for JsonWriteFeature.ESCAPE_FORWARD_SLASHES -- issue core#1200
  • DECIDED: Default will NOT be changed (that is, earlier change reverted)
• Poll Default for DeserializationFeature. FAIL_ON_NULL_FOR_PRIMITIVES -- issue databind#4858
  • DECIDED: Default WILL be changed
  • IMPLEMENTED
• Poll Default for 'DeserializationFeature.FAIL_ON_TRAILING_TOKENS' -- issue: databind#3406
  • DECIDED: Default WILL be changed
  • IMPLEMENTED
• Poll Default for 'MapperFeature.DEFAULT_VIEW_INCLUSION' -- issue: databind#1484
  • DECIDED: Default WILL be changed
  • IMPLEMENTED
• Poll Default for 'SerializationFeature.WRITE_DATES_AS_TIMESTAMPS' -- issue: databind#4845
  • DECIDED: Default WILL be changed
  • IMPLEMENTED
• Poll Default for 'SerializationFeature.WRITE_DURATIONS_AS_TIMESTAMPS' -- issue: databind#4846
  • DECIDED: Default WILL be changed
  • IMPLEMENTED

Issues to work on in jackson-databind

Aside from decisions (or in some cases, related to), there are specific issues to work on.

"Most Wanted" Jackson issues

Of all open issues, a small subset has been labeled as "most-wanted" based on upvotes.
These may be considered for inclusion in 2.x as well, but some might require bigger changes.
Because of this, it would make sense to see if any could be added in 3.0.0-SNAPSHOT:

• https://github.com/FasterXML/jackson-databind/issues?q=is%3Aissue+is%3Aopen+label%3Amost-wanted+

Issues labeled with '3.0'

Some issues have been labeled specifically as targeted to 3.0.0-SNAPSHOT release:

https://github.com/FasterXML/jackson-databind/issues?q=is%3Aissue+is%3Aopen+label%3A3.0

Issues labeled with '3.x'

Other issues have been labeled with 3.x to indicate "not possible/practical for 2.x, maybe one of 3.x releases", but not necessarily 3.0.0:

https://github.com/FasterXML/jackson-databind/issues?q=is%3Aissue+is%3Aopen+label%3A3.x

Issues/Discussion for Other Modules

Beside jackson-databind repo, there are issues in other FasterXML Jackson repositories, labeled for ideally being included in 3.0.0-SNAPSHOT:

None yet

Kotlin

• Discussion of changes to default behavior in Jackson 3.0