Jackson JSON Processor Wiki
Inspired by the quality and variety of XML tooling available for the Java platform (StAX, JAXB, etc.), the Jackson is a multi-purpose Java library for processing JSON data format. Jackson aims to be the best possible combination of fast, correct, lightweight, and ergonomic for developers.
Introduction
First things first:
Jackson Tutorial gives you reasonable overview of basic usage
Licensing page outlines what Open Source licenses are used with Jackson (ASL, LGPL)
Jackson FAQ covers various other aspects, including common usage cases.
Documentation hub -- place where most new documentation should be added, esp. links to external documentation, and presentations by Jackson development team and community.
Download page is where you can find downloadable artifacts and related info (Maven group, artifact ids)
Jackson Users Group is the place to learn even more about Jackson community, things other users do and share, as well as future development plans.
- Project pages:
Jackson 2.x home pages are at GitHub; most notably:
Jackson Core contains streaming parser, generator
Jackson Annotations for annotation-based configuration (used by data-bind)
Jackson databind for data binding, tree model (builds on streaming core)
LEGACY: Jackson 1.x project home page remains at Codehaus -- NOTE: do NOT link to this any more, unless specifically referring to Jackson 1.x versions.
Testimonials
After introduction, you may want to know who is already using Jackson for production work:
Sampling of current users gives an idea of Jackson adoption
Get it!
And then it may be time to check Jackson out:
Download page has the artifacts (jars, sources) you need; specifically, 2.2 which is the latest official version.
Project
In addition to the core project pages (listed above), there are numerous extensions that provide additional functionality and support for third-party libraries and data types:
Jackson Modules are pluggable components that extend out-of-box functionality to support additional data types or JVM languages. Check out Module projects page for complete listing of known module projects.
There are also projects that offer support for alternative data formats beyond JSON (like XML, BSON); see Jackson outside of JSON page to learn more.
Bug reports and requests for new features are handled via:
- For Jackson 2.x, sub-projects have their own Issue trackers; for example:
Jackson-core Issues (basic Streaming API)
Jackson-databind Issues (data-binding functionality)
Jackson 1.x Jira for Jackson 1.x issues
More to Learn
And if (when!) this all looks good, there is plenty more to learn:
Jackson Documentation has plenty more to guide you through more advance usage
TODO covers areas that could use contributions from new contributors...
Future plans: work towards version 2.1 (big backwards-incompatible changes -- but happily co-exists with Jackson 1.x)
Other
Beyond these first steps, you may want to investigate these resources:
CowTalk Blog has blog entries related to Jackson usage, development.
Jackson Users Group site has discussion forums, additional blogs.