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.7.0-rc1 (releease candidate: API may still change for 2.7 final!)
• 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.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.6:
• 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