Skip to content

Jackson Work in Progress

Jump to bottom
Tatu Saloranta edited this page Mar 23, 2020 · 2080 revisions

Jackson & Friends W-I-P

This page is a "living document" of on-going work, mostly by @cowtowncoder (Tatu), although other committers are welcome to update it as well.

Note that there is also a complementary set of things core developers may eventually work on but that may be better tackled by other contributors:

New Contributor Friendly Issues

Contents are divided in multiple sections, first in a few kinds of actionable (*) things:

  • Things to evaluate -- haven't yet had a chance to fully grok
  • Next up -- items to start work on (or being worked on)
  • Urgent to fix -- security problems, correctness (corruption), reliability (threading/concurrency)
  • Simple to fix -- low(er) hanging fruits that are likely relatively easily fixable (and important enough to include here)
  • Important to fix -- things that important strategically, or highly "voted", but that are more involved to fix/implement.

and then one other theoretically-actionable category:

  • Things to contemplate (not easy to fix and not even sure if behavior should change and/or if attempting to fix is worth the hassle or even possible), divided into
    1. May revisit
    2. Unlikely to revisit

as finally the "Recently Completed" addendum. Plus, I try to give "safe harbor" style guesstimate on timing of next minor (and in case of 3.0, major) releases.

Note that this page does NOT contain "Big Ideas" for Jackson 3.0: these are covered on separate JSTEP page.

(*) actionable meaning, in general, that progress is only/mostly limited by time available and not by inherent difficulty, or lack of design or ideas of how to tackle the need.

Last updates

  • 05-Jan-2020, tatu: Clean up after 2.10.2 release
  • 26-Sep-2019, tatu: 2.10.0 (final) released: clear up "recently completed" entries
  • 16-May-2019, tatu: Move now obsolete "recently completed" after 2.9.9 release, to make room
  • 29-Oct-2018, tatu: Create the initial version

When will 2.11 and 3.0 be out?

While patch releases occur somewhat frequently -- after initial minor version, usually once per month for 2 or 3, then 2-3 months after that -- minor versions have gone from "every 3 months" (with 1.x) to "every 6 months" (later 2.x) to "I don't quite know". And with 2.x -> 3.0 work being ambitious, that is even less predictable.

But, currently I think that:

  • First pre-release candidate of 2.11 could be out by mid March 2020, with release in early April.
  • 3.0 is UNLIKELY to be released BEFORE early 2020, but work on it will continue concurrently with 2.11 release.

Urgent things

Work-in-progress, misc

Possibly to add in 2.11

To evaluate

To work on

3.0

2.12

2.11

2.12?

Waiting....

Other/Misc

Important Things

3.0

2.11

Databind/annotations:

Other

Simple Things

3.0

2.11

Deferred

These entries have been evaluated but not solved (either worked without full solution, or deemed unlikely to be solved and no attempt made)

Deferred - hope to revisit (when time permits)

Deferred - for now

  • (databind) https://github.com/FasterXML/jackson-databind/issues/2283: problem with READ_ONLY, Lists
  • (databind) https://github.com/FasterXML/jackson-databind/issues/2644 -- BigDecimal coercion due to buffering
    • Would be great to resolve, perhaps by keeping numbers as Strings if coming from String source -- but not sure how to abstract that logic out, or, how to even link eventual decoding (validation has occurred already)
    • At least 3 parts: (1) does it come from textual input, (2) has number been decoded already, (3) how to decode later on (buffer has no linkage to parser)
    • Note: heuristic for using BigDecimal for certain length of decimal part might work... or maybe not. If not, probably worse than never working (more complicated, still not reliable)

Deferred - unlikely to revisit

Big Ideas

Note: many Big Ideas now included on JSTEP page.

But a scratchpad for stuff can be retained...

  • Add new JsonToken type for "Native Object Id Reference", mostly for YAML?

Documentation

(NOTE: need to include in some better way, but for now just need a place to add ideas)

Another dimension of things to work is... documentation.

  • https://github.com/FasterXML/jackson-dataformats-text/issues/133: (YAML) Document multi-doc use case, differences
  • Rewrite jackson-databind README to make it plain that JSON is NOT the only supported format: add examples, links
  • Jackson 2.10 release documentation: (PolymorphicTypeValidator, JsonNode impr done)
    1. Jackson-jr improvements: read value sequences, custom ValueReaders, ValueWriters
  • Write blog entries about:
    1. How does property introspection COMPLETELY work
    2. Simple "untyped" serialization with Guava ImmutableMap/ImmutableList
    3. Using "Config Overrides"
    4. How are JsonSerializers located, initialized
    5. How are JsonDeserializers located, initialized
    6. Null handling with XML (esp. String, List/Map)

Recently completed

Here are things since January 05, 2020 (time of 2.10.2 release)

2.10

2.11

3.0

Other

Clone this wiki locally