Skip to content

Jackson Release 2.19

Jump to bottom
Tatu Saloranta edited this page Apr 11, 2025 · 95 revisions

Jackson Version 2.19 development is on-going in April, 2025.

This wiki page gives a list of links to all changes (with brief descriptions) that will be included, as well as about original plans for bigger changes (and in some cases changes to plans, postponing).

Status

Development closing to release: 2.19.0-rc2 being released on 07-Apr-2025.

Patches

No release yet

Documentation

Articles, Blog posts

New Modules

Javax.money datatype support

Two new datatype modules added in jackson-datatypes-misc:

Changes, compatibility

Compatibility: platform requirements

Android

Same as Jackson 2.18, SDK 26

JDK

Same as Jackson 2.18 -- mostly Java 8

Kotlin

Changes, behavior

JsonPointer

  • Handling of "orphan" tildes (~ not part of ~0 or ~1 escape sequence) changed:
    • #1361: JsonPointer parsing of '~' not followed by "0" or "1" unexpected
    • NOTE: use of such "orphan" tildes is not (well) covered by JSON Pointer specs so expected handling is not defined.
    • Old behavior used ~ as "general escape", i.e. skipped ~ and included following character
    • New behavior feels more expected: unpaired ~ will simply be included as-is

Major focus area(s)

Most wanted Features to implement

Most wanted Features implemented

  • #1467: Support @JsonUnwrapped with @JsonCreator

Most wanted Features considered but not implemented

Full Change list

Changes, core

Annotations

  • #280: Minor change to module-info.java: use "open module"
  • #281: [gradle-module-metadata-maven-plugin] update to version 1.0
  • #284: Add OptBoolean valued @JsonProperty.isRequired to (eventually) replace @JsonProperty.required

Streaming

  • #633: Allow skipping RS CTRL-CHAR to support JSON Text Sequences
  • #1144: FilteringParserDelegate can go into an infinite loop if underlying parser is non-blocking
  • #1328: Optimize handling of JsonPointer.head()
  • #1356: Make JsonGenerator::writeTypePrefix method to not write a WRAPPER_ARRAY when typeIdDef.id == null
  • #1361: JsonPointer parsing of '~' not followed by "0" or "1" unexpected
  • #1394: Wrong/misleading error for "extra" close token (] or }) when at root level
  • #1409: [gradle-module-metadata-maven-plugin] update to version 1.0

Databind

  • #1467: Support @JsonUnwrapped with @JsonCreator
  • #2145: Add JsonNode.optional(String name) and optional(int index) methods
  • #2461: Nested @JsonUnwrapped property names not correctly handled
  • #2951: Allow inverting @JsonProperty(access=) with MapperFeature.INVERSE_READ_WRITE_ACCESS to work differently on server and client side
  • #3343: Allow BeanPropertyWriter Sub-classes to Override get() (remove final)
  • #4388: Allow using @JsonPropertyOrder with "any" (@JsonAnyGetter) properties
  • #4650: PrimitiveArrayDeserializers should deal with single String value if DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY enabled
  • #4674: Allow setting global enum naming strategy similar to property naming strategy
  • #4676: Support other enum naming strategies than camelCase
  • #4680: Custom key deserialiser registered for Object.class in nested Map object is ignored when Map key type not defined
  • #4771: QName (de)serialization ignores prefix
  • #4772: Serialization and deserialization issue of sub-types used with JsonTypeInfo.Id.DEDUCTION where sub-types are Object and Array
  • #4773: SerializationFeature.ORDER_MAP_ENTRIES_BY_KEYS should not apply to Maps with uncomparable keys
  • #4801: Add JsonNodeFeature.USE_BIG_DECIMAL_FOR_FLOATS to allow overriding DeserializationFeature.USE_BIG_DECIMAL_FOR_FLOATS
  • #4849: Not able to deserialize Enum with default typing after upgrading 2.15.4 -> 2.17.1
  • #4863: Add basic Stream support in JsonNode: valueStream(), entryStream(), forEachEntry()
  • #4867: Add Optional<JsonNode> JsonNode.asOptional() convenience method
  • #4896: Coercion shouldn't be necessary for Enums specifying an empty string
  • #4915: Cannot access attributes from Converter
  • #4934: DeserializationContext.readTreeAsValue() handles null nodes differently from ObjectMapper.treeToValue()
  • #4938: Allow @JsonCreator annotated Creator to return null
  • #4953: Allow clearing all caches to avoid classloader leaks
  • #4955: Add more remove methods for ArrayNode, ObjectNode [STEP-3]
  • #4959: Add explicit deserializer for ThreadGroup
  • #4961: Serialization for JsonFormat.Shape.ARRAY does not work when there is @JsonAnyGetter
  • #4963: Serializing Map.Entry as Bean with @JsonFormat.shape = Shape.OBJECT fails on JDK 17+
  • #4979: Allow default enums with @JsonCreator
  • #4997: ObjectNode put methods should do null check for key
  • #5006: Add MapperFeature.REQUIRE_HANDLERS_FOR_JAVA8_OPTIONALS to prevent failure of java.util.Optional (de)serialization without Java 8 module
  • #5014: Add java.lang.Runnable as unsafe base type in DefaultBaseTypeLimitingValidator
  • #5020: Support new @JsonProperty.isRequired for overridable definition of "required-ness"
  • #5027: Add DeserializationFeature.FAIL_ON_SUBTYPE_CLASS_NOT_REGISTERED
  • #5052: Minor bug in FirstCharBasedValidator.forFirstNameRule(): returns null in non-default case
  • #5063: SimpleModule not registered due to getTypeId() returning an empty string
  • #5069: Add copy-constructor for MappingIterator

Changes, data formats

Avro

  • #308: Incorrect serialization for LogicalType.Decimal (Java BigDecimal)
  • #388: @JsonEnumDefaultValue not supported when using AvroMapper to generate schema from Java class
  • #422: Avro generation failed with enums containing values with special characters
  • #535: AvroSchemaGenerator: logicalType(s) never set for non-date classes
  • #536: Add Logical Type support for java.util.UUID

CBOR

  • #568: Improve ASCII decoding performance for CBORParser

CSV

  • #31: Header names seem to be trimmed (add CsvParser.Feature.TRIM_HEADER_SPACES))
  • #554: Enforce, document thread-safety of CsvSchema

Ion

  • #571: Unable to deserialize a pojo with IonStruct

Smile

  • #300: Floats are encoded with sign extension while doubles without

YAML

  • #502: Add an optional extended parser subclass (YAMLAnchorReplayingFactory) able to inline anchors
  • #537: Snakeyaml 2.4

Changes, datatypes

Guava

  • #1: Add deserialization support for Table<R, C, V>

Java 8 date/time

  • #336: Optimize InstantDeserializer addInColonToOffsetIfMissing()
  • #337: Negative Duration does not round-trip properly with WRITE_DURATIONS_AS_TIMESTAMPS enabled
  • #342: Lenient deserialization of LocalDate, LocalDateTime is not time-zone aware
  • #364: Deserialization of Month in ONE_BASED_MONTHS mode fails for value "12"

Changes, Other modules

Blackbird

  • #285: JacksonBlackbirdAccess Class access exception with Groovy Script serialization using BlackbirdModule
Paranamer
  • #290: Update Paranamer dep from 2.8 to 2.8.3

Changes, JVM Languages

Kotlin

  • #835: Remove old SingletonSupport class and unified with KotlinFeature.SingletonSupport.
  • #839: Remove useKotlinPropertyNameForGetter and unify with kotlinPropertyNameAsImplicitName.
  • #858: Minor performance improvement of findDefaultCreator in edge cases.

Scala

Changes, Providers

JAX-RS Providers

  • #200: Narrow types to format specific (e.g. CBORMapper) when resolving via JAX-RS Providers

Jakarta-RS Providers

  • #36: Narrow types to format specific (e.g. CBORMapper) when resolving via JAX-RS Providers

Changes, other

Jackson-jr

  • #171: Add a JSON.Feature.WRITE_RECORD_FIELDS_IN_DECLARATION_ORDER for retaining Serialization order of Java Records (instead of alphabetic)

Clone this wiki locally