• JacksonDocumentation

Jackson Documentation

General

• Jackson Tutorial: the best place to start; covers basic processing approaches and covers common usage patterns.

• Jackson FAQ covers many common questions regarding typical usage.

• Jackson JavaDocs has extensive and detailed coverage of all the features: what is available, where, how. But you do need to know where to look.

• Jackson User Group is a site/group/social network dedicated to all things Jackson, for sharing knowledge about how to use Jackson efficiently.

Features, general

To learn more about how to configure Jackson, check out:

• Jackson annotation guide (related: support for JAXB annotations)

• Simple on/off Features

• Configuration settings for handling "non-standard JSON"

(New) Features by Release

New functionality is being introduced with new releases, and sometimes it is useful to know what is the minimum version that has specific set of functionality you need; or to evaluate whether upgrade to a new version would make sense. To help with this, there are separate release pages for recent (and sometimes upcoming) Jackon releases:

• 1.5 Features (Mar 2009)

• 1.4 Features (Dec 2009)

• 1.3 Features (Oct 2009)

• 1.2 Features (Aug 2009)

• 1.1 Features (Jun 2009)

• Planned 1.6 Features (work in progress)

HOW-TOs, samples

Here is some sample code, contributed by Jackson users on mailing lists. It is not intended to define official or canonical way of doing things, but showing possible alternatives -- and if you do end up finding better ways, or have incremental improvement suggestions, please let us know so we can update samples!

• How-to Ignore Unknown properties in JSON content?

• Basic:

  • Servlet/javascript sample code

  • Simple POJO mappper

• Intermediate:

  • Custom date handling

• Advanced:

  • Jackson Type Proxy for extremely dynamic generation of types

  • Quoting JSON String characters -- in case your clients can not handle all legal Unicode characters.

  • Custom JSON View implementation (contributed by Andrei V)

Best Practices

• Thread-safety

• Performance

Forward-looking

• TODO list

• Known Issues (higher level ones: for bugs and feature requests, check out Jackson Jira at Codehaus)

External docs

General:

• "Easy JSON with Jackson"

• "JSON Strings and Java Objects"

Jackson with frameworks:

• "Using JSON bindings with iBeans" (iBeans/Mule)

• Jackson extension for Restlet (Restlet)

Performance:

• Performance comparison of Protocol Buffers, JSON et al formats, libs.

• Basic JSON parsing performance in Java (Cowtowncoder.com)

• JSON data binding performance with 3 JSON data binding libs: Jackson, Google-gson, Json-lib (Cowtowncoder.com)

• Jackson performance on Android (relative to Protocol Buffers)

CategoryJackson