Latest commit adbd333 Nov 2, 2018
Permalink
..
Failed to load latest commit information.
release-notes Fix #16 May 24, 2016
src ... Nov 2, 2018
README.md Update URL for Javadoc badge's image Nov 27, 2017
pom.xml Merge branch '2.10' Oct 9, 2018

README.md

Overview

Jackson (Java) data format module that supports reading and writing CBOR ("Concise Binary Object Representation") encoded data. Module extends standard Jackson streaming API (JsonFactory, JsonParser, JsonGenerator), and as such works seamlessly with all the higher level data abstractions (data binding, tree model, and pluggable extensions).

Status

This module is considered stable and production quality (since 2.4). Similar to JSON- and other JSON-like backends, it implementsfull support for all levels (streaming, data-binding, tree model).

Maven Central Javadoc

Limitations

Minor limitations exist with respect to advanced type-handling of CBOR format:

  • While tags are written for some types (BigDecimal, BigInteger), they are not handling on parsing

Maven dependency

To use this extension on Maven-based projects, use following dependency:

<dependency>
  <groupId>com.fasterxml.jackson.dataformat</groupId>
  <artifactId>jackson-dataformat-cbor</artifactId>
  <version>2.7.4</version>
</dependency>

(or whatever version is most up-to-date at the moment)

Usage

Basic usage is by using CborFactory in places where you would usually use JsonFactory:

CBORFactory f = new CBORFactory();
ObjectMapper mapper = new ObjectMapper(f);
// and then read/write data as usual
SomeType value = ...;
byte[] cborData = mapper.writeValueAsBytes(value);
SomeType otherValue = mapper.readValue(cborData, SomeType.class);

Implementation allows use of any of 3 main operating modes:

  • Streaming API (CBORParser and CBORGenerator)
  • Databinding (via ObjectMapper / ObjectReader / ObjectWriter)
  • Tree Model (using TreeNode, or its concrete subtype, JsonNode -- not JSON-specific despite the name)

and all the usual data-binding use cases exactly like when using JSON or Smile (2 canonical 100% supported Jackson data formats).

Documentation

  • Wiki (includes Javadocs)