Home

Jackson Core Annotations

Licensing

Project is licensed under Apache License 2.0 (http://www.apache.org/licenses/LICENSE-2.0.txt) like all official Jackson components.

Documentation

All general-purpose annotations are explained on separate Jackson Annotations page.

Javadocs

• 2.8
• 2.7
• 2.6
• 2.5
• 2.4
• 2.3
• 2.2
• 2.1
• 2.0

Older versions:

• See 1.x Javadocs page.

Related

• FasterXML Jackson Wiki has documentation for all Jackson 1.x modules (much of which is still relevant for 2.x as well)
• Jackson-docs is the Jackson 2.x documentation hub
• Jackson Github portal contains links to all official Jackson components

Downloads

Note: only needed if using a build system that requires local jars; otherwise you can just use Maven repository.

Also note that typically minor versions of Jackson components need to match, although usually older version of annotations will work with newer core versions (assuming same major version).

• 2.8.0 (04-Jul-2016)
• 2.7.0 (10-Jan-2016)
• 2.6.0 (17-Jul-2015)
• 2.5.0 (01-Jan-2015)
• 2.4.0 (29-May-2014)
• 2.3.0 (14-Nov-2013)
• 2.2.3 (13-Aug-2013) -- note: only change from 2.2.0 is location of LICENSE file in jar
• 2.1.5 (02-May-2012)
• 2.0.6 (05-Sep-2012)

Notes on compatibility

Starting with the baseline of 2.0, here are improvements over subsequent minor releases:

• 2.8:
  • @JsonEnumDefaultValue for indicating default enum choice if no real match found
  • New enum values
    • JsonFormat.Shape.NATURAL
    • JsonFormat.Feature.ACCEPT_CASE_INSENSITIVE_PROPERTIES
    • JsonFormat.Feature#ADJUST_DATES_TO_CONTEXT_TIME_ZONE
• 2.7:
  • @JsonClassDescription to support things like JSON Schema generation
  • Add new ObjectIdGenerator implementation StringIdGenerator to allow arbitrary String Object Id usage
• 2.6:
  • New properties
    • @JsonFormat(with=Feature.xxx) to support things like DeserializationFeature.WRITE_SINGLE_ELEM_ARRAYS_UNWRAPPED on per-property basis.
    • @JsonIgnoreProperties.allowGetters, @JsonIgnoreProperties.allowSetters
    • @JsonProperty.access
  • New enum values
    • JsonInclude.Include.NON_ABSENT
• 2.5:
  • New properties
    • @JsonCreator.mode to explicitly choose between Mode.DELEGATING and Mode.PROPERTIES, for special case of 1-argument Creator methods
  • Changes to applicability
    • Allow @JsonView to be used for method parameters too
• 2.4:
  • New properties
    • @JsonProperty.index
    • @JsonRootName.namespace (mostly for XML dataformat module)
  • Allow @JsonPropertyOrder also for properties (to override class defaults for that property)
• 2.3:
  • @JsonPropertyDescription allows annotating properties for JSON Schema generation
  • @JsonFilter applicable to properties (Fields, Methods, Constructor parameters), not just Classes
• 2.2 has no new annotations or annotation properties
• 2.1:
  • Adds @JsonIdentityReference to indicate that value of annotated property should always be an Object Id, and never fully expanded reference
  • @JsonIdentityInfo.firstAsId to force use of Object Id for the annotated type, even for the first reference