This project is the main hub to all kinds of documentation related to Jackson JSON Processor.
For your first steps in understanding how to use Jackson, following tutorials are good places to start:
- Jackson Tutorial by StudyTrails
- Jackson in N minutes (
README
forjackson-databind
project) - Older Jackson in 5 minutes version (useful for 1.x)
Jackson project hub has links to all active Jackson projects. These projects contain plenty of project-specific documentation, such as:
- Core Annotations
- Streaming API
- On/off features: JsonFactory.Features, JsonGenerator.Features,JsonParser.Features.
- Databind
- Databind Annotations
- On/off features: DeserializationFeatures, SerializationFeatures., MapperFeatures.
Following sites are good sources for documentation:
- Old FasterXML Jackson Wiki -- will be replaced by this project!
- Jackson Users forum
- CowTalk Blog
And here are good one-off articles from around the web:
Note that there are two major Jackson versions: 1.x (1.0 - 1.9) and 2.x (2.0 - 2.3). These versions can co-exist as they are located in different Java package and use different jar naming and Maven group/artifact ids. But this means that you have to make sure that all components in use have matching major versions: specifically, Jackson 2.x code does NOT understand or support Jackson 1.x annotations, or vice versa.
Minor versions (like 2.1 and 2.2) are backwards compatible with respect to public API: old code should work without recompilation, if (but only if) it relies on external API; public methods, annotations. When overriding internal functionality, we try hard to maintain backwards compatibility between adjacent minor versions; need for changes is indicated by deprecating internal methods. Recompilation is thus recommended when extending by sub-classing, for example.
- Old Jackson home is still occasionally linked to from various places -- please DO NOT link from new documentation.
- Jackson Git Hub is the... The Hub for all stuff, including this project.