-
Notifications
You must be signed in to change notification settings - Fork 3
Jackson Work in Progress
This page is a "living document" of on-going work, mostly by @cowtowncoder (Tatu), although other committers are welcome to update it as well.
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
- 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.
- 31-Aug-2019, tatu:
2.10.0.pr2released, possibly last pre-release, 2.10.0 is nigh - 19-Jul-2019, tatu:
2.10.0.pr1released, work towards 2.10.0 continues - 30-May-2019, tatu: Reorder "important" before "simple" (because, yeah...)
- 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
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 (2.10.0.pr1) was released mid-July 2019, with 2.10.0.pr2 likely by end of August; final 2.10.0 thereby possible by end of September
- 3.0 is UNLIKELY to be released BEFORE end of 2019: work is mostly on hold until
2.10is out, but should pick up after that gets released.
- (afterburner) https://github.com/FasterXML/jackson-modules-base/issues/82 -- Java 12 problem (also, Java 8 date/time)
- Databind:
-
https://github.com/FasterXML/jackson-databind/issues/2309 -- Enum,
nulls
-
https://github.com/FasterXML/jackson-databind/issues/2309 -- Enum,
- Dataformats
- (PR) (avro): https://github.com/FasterXML/jackson-dataformats-binary/pull/133 -- Logical types
- (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/325: XML polymorphic ids
- (streaming) https://github.com/FasterXML/jackson-core/issues/455 -- wrong location for EOF
- (databind) https://github.com/FasterXML/jackson-databind/pull/2432: Module Bundles
- (databind) https://github.com/FasterXML/jackson-databind/issues/2113: Leniency vs scalars (Boolean)
- XML
- (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/356 -- Root name for Collection types
- (CSV) https://github.com/FasterXML/jackson-dataformats-text/issues/10 -- missing
nullvalues - (mixed) * https://github.com/FasterXML/jackson-modules-java8/issues/80 -- case-insensitive values; annotation, java 8 date/time
- Databind
- (3.0) https://github.com/FasterXML/jackson-databind/issues/2405: SQL date, default timezone
- https://github.com/FasterXML/jackson-databind/issues/2438 -- Duplicate property value Creator vs field/setter
- Jackson-jr
-
https://github.com/FasterXML/jackson-jr/issues/32: Support subset of Jackson annotations (
@JsonPropertyet al)
-
https://github.com/FasterXML/jackson-jr/issues/32: Support subset of Jackson annotations (
- Formats
- (avro) https://github.com/FasterXML/jackson-dataformats-binary/issues/165 -- missing default value for
Map - (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/358 -- XSI namespace in general
- (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/360 -- write
xsi:nil
- (avro) https://github.com/FasterXML/jackson-dataformats-binary/issues/165 -- missing default value for
- (streaming) https://github.com/FasterXML/jackson-core/issues/559: Replace
JsonReadContextwithSimpleTokenReadContextfor non-JSON backends. - Finish partial rewrite of
JsonFormat.Shapehandling to support ALL changes (POJO to/from non-POJO), for types AND properties -
https://github.com/FasterXML/jackson-databind/issues/2246: "Iterable"
JavaTypeforStream,Iteratoretc -
https://github.com/FasterXML/jackson-core/issues/485: Add
vanillaversion for generators, to optimize handling- f.ex. one with no
PrettyPrinter, using standard quoting
- f.ex. one with no
-
https://github.com/FasterXML/jackson-databind/issues/2418: Offer
BeanDescriptionviaSupplier(or something) - (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/359 -- Test fail wrt String
nullvs ""
Databind
- https://github.com/FasterXML/jackson-core/issues/500: allow "optional padding" for base64 (not just required/not-allowed choices)
-
https://github.com/FasterXML/jackson-databind/issues/1983:
MapperFeature.ACCEPT_CASE_INSENSITIVE_PROPERTIES, type id case
Other
-
https://github.com/FasterXML/jackson-dataformats-text/issues/115: (CSV)
JsonProperty.indexis not honored byCsvSchemabuilder - (avro) https://github.com/FasterXML/jackson-dataformats-binary/issues/164 -- reader/writer schema, union
- Annotations
-
https://github.com/FasterXML/jackson-annotations/pull/149: Use
@Repeatedon annotations likeJsonSubtypes.Type
-
https://github.com/FasterXML/jackson-annotations/pull/149: Use
- Streaming
- Remove mutability of
JsonGenerator: NOTE,CharacterEscapeshard (due to JSONP), max-non-escaped easy too? Features? - Remove
JsonParser.setSchema() - https://github.com/FasterXML/jackson-core/issues/507: Escape forward slash in Strings by default (but also allow change)
- Remove mutability of
- Databind
- https://github.com/FasterXML/jackson-databind/issues/1687: JsonView with JsonNode (convenience method)
- Databind
-
https://github.com/FasterXML/jackson-databind/issues/2253: support multiple properties with
@JsonRootName, unwap; -
https://github.com/FasterXML/jackson-databind/issues/1114:
@JsonFormat, number formatting -- can useJsonGenerator.canWriteFormattedNumbers()(added in 2.8)
-
https://github.com/FasterXML/jackson-databind/issues/2253: support multiple properties with
- Dataformats, binary
-
https://github.com/FasterXML/jackson-dataformats-binary/issues/73: (
protobuf) References to nested types
-
https://github.com/FasterXML/jackson-dataformats-binary/issues/73: (
- Collections
- Java 8
- (date/time) https://github.com/FasterXML/jackson-modules-java8/issues/114 -- empty String "" as
nullDate/Time (or not)
- (date/time) https://github.com/FasterXML/jackson-modules-java8/issues/114 -- empty String "" as
These entries have been evaluated but not solved (either worked without full solution, or deemed unlikely to be solved and no attempt made)
- (Smile) https://github.com/FasterXML/jackson-dataformats-binary/issues/158 --
BigDecimal,NaN(need test case) - (Guava) https://github.com/FasterXML/jackson-datatypes-collections/pull/50: Guava,
RangeSethandling (PR) (need CLA) - (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)
- Databind
-
https://github.com/FasterXML/jackson-databind/issues/1986:
Throwable, self-reference (NOTE: probably not really simple to solve, but need to evaluate) -
https://github.com/FasterXML/jackson-databind/issues/2382: Support
AutoClosable(NOTE: not as trivial to implement as I thought) -
https://github.com/FasterXML/jackson-databind/issues/2087: Performance improvement for
BigDecimal(see the end of comment section) - https://github.com/FasterXML/jackson-databind/issues/1196: Collect multiple errors
-
https://github.com/FasterXML/jackson-databind/issues/1986:
- (Java 8 / datatypes) https://github.com/FasterXML/jackson-modules-java8/issues/86 --
Optional, polymorphic types -- bug it seems, but hard to reason about. - (Java 8 date/time) https://github.com/FasterXML/jackson-modules-java8/issues/109:
Instant, integer/nanoseconds -- probably NOT a bug, but need to verify - Jackson-jr
-
https://github.com/FasterXML/jackson-jr/issues/62: Support
atwithJsonPointer(but what abstraction?JSONprobably, otherwise too many overloads) - problem, noObjectWriterequivalent for jackson-jr
-
https://github.com/FasterXML/jackson-jr/issues/62: Support
- JSON Schema: https://github.com/FasterXML/jackson-module-jsonSchema/issues/136 --
ClassDescriptionnot used? - Formats:
- (CSV) https://github.com/FasterXML/jackson-dataformats-text/issues/7 -- Support coercion of empty strings to null objects
- (CSV) https://github.com/FasterXML/jackson-dataformats-text/issues/45 -- trailing linefeed
- (PR) ^^^ https://github.com/FasterXML/jackson-dataformats-text/pull/46 -- ideally rewrite
- (databind) https://github.com/FasterXML/jackson-databind/issues/2283: problem with
READ_ONLY,Lists- PR: https://github.com/FasterXML/jackson-databind/pull/2284 -- sizable changes, not sure what to think
- (avro) https://github.com/FasterXML/jackson-dataformats-binary/issues/167 -- Apache Avro lib 1.8/1.9 problem
- Databind
- https://github.com/FasterXML/jackson-databind/pull/2180 -- order of Constructor / Factory method lookup for KEY deserializers (change order from current)
-
https://github.com/FasterXML/jackson-databind/issues/2305: problem with
@JsonCreator, single string argument- Due to "all implicit" vs "all explicit": not sure if should change
- (Java8) https://github.com/FasterXML/jackson-modules-java8/issues/111: Java8 module(s), serializability
-
java.time.format.DateTimeFormatterNOT beingjava.io.Serializable. Failing test added. - Unfortunately, while fixed for 3.0, difficult to fix for
2.10due to
-
Note: many Big Ideas now included on JSTEP page.
But a scratchpad for stuff can be retained...
- Add new
JsonTokentype for "Native Object Id Reference", mostly for YAML?
(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-databindREADMEto make it plain that JSON is NOT the only supported format: add examples, links - Write blog entries about:
- How does property introspection COMPLETELY work
- Simple "untyped" serialization with Guava ImmutableMap/ImmutableList
- Using "Config Overrides"
- 2.10 features pre-sneak
Here are things since August 31, 2019 (after 2.10.0.pr2)
- (guava) https://github.com/FasterXML/jackson-datatypes-collections/issues/56: Property naming for
Range(04-Sep-2019) - (guava) https://github.com/FasterXML/jackson-datatypes-collections/issues/58: Drop support for pre-v14 Guava (04-Sep-2019)
- (date/time): https://github.com/FasterXML/jackson-modules-java8/issues/51 -- Year key deserializer (04-Sep-2019)
- (databind) https://github.com/FasterXML/jackson-databind/issues/2378 --
@JsonCreator, alias (05-Sep-2019) - (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/242 -- Attribute order (05-Sep-2019)
- (databind) https://github.com/FasterXML/jackson-databind/issues/2442 --
nulls viaArrayNode.addAll()(06-Sep-2019) - (jackson-jr) https://github.com/FasterXML/jackson-jr/issues/66 -- add
Json.mapOfFrom()? (09-Sep-2019) - (xml) https://github.com/FasterXML/jackson-dataformat-xml/issues/326 -- force Repairing Mode for output (09-Sep-2019)
- (protobuf) https://github.com/FasterXML/jackson-dataformats-binary/issues/148 -- add an overload for schema generation (09-Sep-2019)
- (cbor) https://github.com/FasterXML/jackson-dataformats-binary/pull/178 -- fix a problem with offsets (09-Sep-2019)
- (yaml) https://github.com/FasterXML/jackson-dataformats-text/issues/83 -- Context/location incorrect (09-Sep-2019)
- (databind) https://github.com/FasterXML/jackson-databind/issues/2446 -- Java 7 support vs JDK 11 (module info) (09-Sep-2019)