Skip to content

Jackson Work in Progress

Jump to bottom
Tatu Saloranta edited this page May 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

  • 26-Apr-2020, tatu: Clean up after 2.11.0 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.12 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 "hard to say" (with 2.10 taking 2 years!). And with 2.x -> 3.0 work being ambitious, that is even less predictable.

But, currently I think that:

  • 2.11.0 was released in April 202, 2.12 should be released by end of 2020
  • 3.0 could get close to release candidates towards end of 2020.

Urgent things

Work-in-progress

Jackson

Misc non-Jackson:

To evaluate

To work on

2.12

2.12 / streaming

2.12 / databind

2.12, XML

Easyish? (evaluate)

Regression/Partial fixes

Evaluated, other:

Important

Other

Deferred:

2.12, other dataformats

2.x

Waiting....

Other/Misc

Important Things

3.0

Simple Things

3.0

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/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 April 26, 2020 (time of 2.11.0 release)

2.10

2.11

2.12

3.0

Other

Clone this wiki locally