-
Notifications
You must be signed in to change notification settings - Fork 6
Jackson Work in Progress
2024-03-31: Out-of-Date / Deprecated
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. Specific breakdown varies but is along lines of:
- Things to evaluate -- haven't yet had a chance to fully grok
- Actively worked on -- 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
- May revisit
- 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.
(updated on daily basis so only some of major updates mentioned)
- 31-Mar-2024, tatu: Another minor clean up
- 13-Feb-2023, tatu: Minor clean up; haven't been updating recently
- 04-Oct-2022, tatu: Had a quick look after
2.14.0-rc1
release (no changes) - 01-Oct-2021, tatu: Clean up after
2.13.0
release - 01-Dec-2020, tatu: Clean up after
2.12.0
release - 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 - 29-Oct-2018, tatu: Create the initial version
Over time the goal of getting 3.0 out has been moving along with 2.x work. Now that Jackson 2.18 is out and FINALLY did teh Major Property Introspection rewrite, we can and need to focus again on making 3.0 a near future thing.
With that, the hope is that:
- 3.0: limited progress during Q3/2024, so far in Q4/2024, but ideally 3.0.0-rc1 out during Q1 2025. Maybe even by end of January 2025
- (yaml) https://github.com/FasterXML/jackson-dataformats-text/issues/296 -- YAML anchor?
- (databind) https://github.com/FasterXML/jackson-databind/issues/3355 -- Deserialization, order of
@JsonIgnoreProperties
- (JAXB) https://github.com/FasterXML/jackson-modules-base/issues/144 -- complicated Type ID handling thing
- (databind) https://github.com/FasterXML/jackson-databind/issues/3079 -- Record types,
ObjectMapper.updateValue()
- Requires separate
RecordDeserializer
, subtype ofBeanDeserializerBase
(sibling ofBeanDeserializer
)
- Requires separate
- Core:
- (streaming) https://github.com/FasterXML/jackson-core/issues/355 -- Allow registering "string-converter hook", for low-level coercion or String mutation
- (streaming) https://github.com/FasterXML/jackson-core/issues/679 -- Number parsing, multiple dots
- Databind
- (databind) https://github.com/FasterXML/jackson-databind/issues/2977 -- Incompatible FAIL_ON_MISSING_PRIMITIVE_PROPERTIES and field level @JsonProperty
- Avro
- (PR) (avro): https://github.com/FasterXML/jackson-dataformats-binary/pull/133 -- Logical types
- (avro) https://github.com/FasterXML/jackson-dataformats-binary/issues/164 -- reader/writer schema, union
- (avro) https://github.com/FasterXML/jackson-dataformats-binary/issues/165 -- missing default value for
Map
- CBOR
- (cbor) https://github.com/FasterXML/jackson-dataformats-binary/issues/166 -- feature to force use of length-prefix for all String values (waiting for possible PR)
- (cbor) https://github.com/FasterXML/jackson-dataformats-binary/issues/230 -- tagged types for
Date
etc
- CSV:
- (csv) https://github.com/FasterXML/jackson-dataformats-text/issues/10 -- missing
null
values - (csv / PR) https://github.com/FasterXML/jackson-dataformats-text/pull/97 -- nested values (old PR)
- (csv) https://github.com/FasterXML/jackson-dataformats-text/issues/176 -- Allow skipping first line of input file
- (csv) https://github.com/FasterXML/jackson-dataformats-text/issues/198 -- Numbers as (quoted) Strings always
- (csv) https://github.com/FasterXML/jackson-dataformats-text/issues/207 --
CsvSchema
introspection not working with Builder - (csv) https://github.com/FasterXML/jackson-dataformats-text/issues/210 -- Quote surrounding space?
- (csv) https://github.com/FasterXML/jackson-dataformats-text/issues/264 -- Records, alphabetic ordering
- (csv) https://github.com/FasterXML/jackson-dataformats-text/issues/10 -- missing
- Protobuf
- (protobuf) https://github.com/FasterXML/jackson-dataformats-binary/pull/220 -- Schema generation
- Need tests, questions about API compatibility
- (protobuf) https://github.com/FasterXML/jackson-dataformats-binary/issues/73: (
protobuf
) References to nested types - (protobuf) Consider changing Schema-reading to use
Wire-schema
library: https://github.com/square/wire/tree/master/wire-library/wire-schema
- (protobuf) https://github.com/FasterXML/jackson-dataformats-binary/pull/220 -- Schema generation
- XML
- (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/114 -- XML,
JsonParser.Feature.STRICT_DUPLICATE_DETECTION
not implemented - (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/150 -- Add DOCTYPE element
- similarly, different XML declaration (
standalone
) -- closure/function of "write document beginning"
- similarly, different XML declaration (
- (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/247 -- Root name (local name) not validated
- (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/114 -- XML,
- YAML
- (yaml) https://github.com/FasterXML/jackson-dataformats-text/issues/36 -- emit comments
- (yaml) https://github.com/FasterXML/jackson-dataformats-text/issues/215 -- Doc start marker being written via
ObjectWriter
(done in constructor) - (yaml) https://github.com/FasterXML/jackson-dataformats-text/pull/242 -- Add
FlowStyleResolver
to enable custom YAML node style resolution- Waits for CLA, some questions on interface definition
- (yaml) https://github.com/FasterXML/jackson-dataformats-text/issues/252 -- Redesign
StringQuotingChecker
- Jackson-jr
- (jackson-jr) https://github.com/FasterXML/jackson-jr/issues/78 -- Nulls for wrappers
- alas, rather tricky to do since current serialize does not have primitive/wrapper distinction
- (jackson-jr) https://github.com/FasterXML/jackson-jr/issues/78 -- Nulls for wrappers
- (external) https://github.com/infobip/infobip-jackson-extension -- multi-level type resolution
- (classmate) https://github.com/FasterXML/java-classmate/issues/57 -- return type co-variance
- (classmate) https://github.com/FasterXML/java-classmate/issues/50 -- Add a convenience method for the full set of types for a type
- PRs:
- Databind, important, "most wanted":
- (databind) https://github.com/FasterXML/jackson-databind/issues/2968 -- Deserialization of
@JsonTypeInfo
annotated type fails with missing type id even for explicit concrete subtypes - (databind) https://github.com/FasterXML/jackson-databind/issues/2045 --
@PreSerialize
/@PostDeserialize
method annotations - (databind) https://github.com/FasterXML/jackson-databind/issues/2971 -- Allow registering a hook to modify/pre-process String values read
- (core) Matching issue for ^^^ https://github.com/FasterXML/jackson-core/issues/355
- (databind) https://github.com/FasterXML/jackson-databind/issues/2968 -- Deserialization of
- Databind, important, other:
- (databind) https://github.com/FasterXML/jackson-databind/issues/2803 --
@JsonIgnoreProperties
, cyclic types- Nasty, but not easy to fix, may have to wait....
- (databind) https://github.com/FasterXML/jackson-databind/issues/2803 --
Important
- (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/75 -- Support
CharacterEscapes
using Stax (Woodstox/Aalto) functionality
Other
- (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/356 -- Root name for Collection types
- Finish partial rewrite of
JsonFormat.Shape
handling to support ALL changes (POJO to/from non-POJO), for types AND properties -
https://github.com/FasterXML/jackson-core/issues/485: Add
vanilla
version for generators, to optimize handling- f.ex. one with no
PrettyPrinter
, using standard quoting
- f.ex. one with no
- (databind) Introspection callbacks ("json schema"): simplify String-type callbacks etc
- Annotations
-
https://github.com/FasterXML/jackson-annotations/pull/149: Use
@Repeated
on annotations likeJsonSubtypes.Type
-
https://github.com/FasterXML/jackson-annotations/pull/149: Use
- Streaming
- Remove mutability of
JsonGenerator
: NOTE,CharacterEscapes
hard (due to JSONP), max-non-escaped easy too? Features?
- Remove mutability of
- Databind
- https://github.com/FasterXML/jackson-databind/issues/1687: JsonView with JsonNode (convenience method)
These entries have been evaluated but not solved (either worked without full solution, or deemed unlikely to be solved and no attempt made)
- Databind
- (databind) https://github.com/FasterXML/jackson-databind/issues/2624 -- Config override for "with"-prefix (builders).
- (databind) https://github.com/FasterXML/jackson-databind/issues/2686 --
@JsonBackReference
, Builder -
https://github.com/FasterXML/jackson-databind/issues/1986:
Throwable
, self-reference (NOTE: probably not really simple to solve, but need to evaluate)
- JSON Schema: https://github.com/FasterXML/jackson-module-jsonSchema/issues/136 --
ClassDescription
not used?
(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
- Write blog entries about:
- How does property introspection COMPLETELY work
- Using "Config Overrides"
- How are
JsonSerializer
s located, initialized - How are
JsonDeserializer
s located, initialized - Null handling with XML (esp.
String
,List
/Map
) - Writing complete
- Scalar serializer
- Scalar deserializer
- Converting serializer
- Converting deserializer
- Note: already blogged about
- Simple "untyped" serialization with Guava ImmutableMap/ImmutableList: https://cowtowncoder.medium.com/casual-json-generation-with-jackson-191abfa1f7dc