commit	165c9fe482a2efe09dc053ac799d5d9eb766d694	[log] [tgz]
author	android-build-team Robot <android-build-team-robot@google.com>	Wed Feb 17 03:14:16 2021 +0000
committer	android-build-team Robot <android-build-team-robot@google.com>	Wed Feb 17 03:14:16 2021 +0000
tree	093e7f4e8b99e937aada1dad8d1512cbd6b3b9f3
parent	6fe119cbcad5036893ae53fabf6b4588ad92e960 [diff]
parent	00c4a382dd3810f9c1b363eaad339cff34a3f6fe [diff]

tree: 093e7f4e8b99e937aada1dad8d1512cbd6b3b9f3

README.md

cbor-java

A Java 7 implementation of RFC 7049: Concise Binary Object Representation (CBOR)

Features

Encodes and decodes all examples described in RFC 7049
Provides a fluent interface builder for CBOR messages
Supports semantic tags
Supports 64-bit integer values
Passes all CPD, PMD and FindBugs tests

Documentation

Maven Dependency

Add this to the dependencies section of your pom.xml file:

<dependency>
    <groupId>co.nstant.in</groupId>
    <artifactId>cbor</artifactId>
    <version>0.8</version>
</dependency>

Usage

Encoding Example

ByteArrayOutputStream baos = new ByteArrayOutputStream();
new CborEncoder(baos).encode(new CborBuilder()
    .add("text")                // add string
    .add(1234)                  // add integer
    .add(new byte[] { 0x10 })   // add byte array
    .addArray()                 // add array
        .add(1)
        .add("text")
        .end()
    .build());
byte[] encodedBytes = baos.toByteArray();

Decoding Example

ByteArrayInputStream bais = new ByteArrayInputStream(encodedBytes);
List<DataItem> dataItems = new CborDecoder(bais).decode();
for(DataItem dataItem : dataItems) {
    // process data item
}

Streaming Decoding Example

ByteArrayInputStream bais = new ByteArrayInputStream(encodedBytes);
new CborDecoder(bais).decode(new DataItemListener() {

    @Override
    public void onDataItem(DataItem dataItem) {
        // process data item
    }

});

Contribution Process

This project uses the C4 process for all code changes.

License

Copyright 2013-2017 Constantin Rack

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.