This is a multi-module umbrella project for Jackson standard binary dataformat backends.
Dataformat backends are used to support format alternatives to JSON, using general-purpose Jackson API. Formats included allow access using all 3 API styles (streaming, databinding, tree model).
For Jackson 2.x this is done by sub-classing Jackson core abstractions of:
- All backends sub-class
JsonFactory, which is factory for:
JsonParserfor reading data (decoding data encoding in supported format)
JsonGeneratorfor writing data (encoding data using supported format)
- Some backends sub-class
ObjectMapperfor additional support for databinding
there will be some changes (such as introduction of format-specific
sub-classes) in Jackson 3.0.
master branch is for developing the next major Jackson version -- 3.0 -- but there
are active maintenance branches in which much of development happens:
2.10is for developing the next (and possibly last) minor 2.x version
2.9are for backported fixes for 2.8/2.9 patch versions
Older branches are usually not changed but are available for historic reasons.
All released versions have matching git tags (
Note that since individual format modules used to live in their own repositories, older branches (before 2.8) and tags do not exist in this repository.
Binary formats included
Currently included backends are:
All modules are licensed under Apache License 2.0.
To use these format backends Maven-based projects, use following dependency:
<dependency> <groupId>com.fasterxml.jackson.dataformat</groupId> <artifactId>jackson-dataformat-[FORMAT]</artifactId> <version>2.9.9</version> </dependency>
[FORMAT] is one of supported modules (
Other Jackson binary backends
In addition to binary format backends hosted by FasterXML in this repo, there are other known Jackson backends for binary data formats. For example:
- bson4jackson for BSON
- EXIficient for Efficient XML Interchange
- jackson-dataformat-msgpack for MessagePack (aka
See Wiki for more information (javadocs).