Change legal byte value range from [-128,127] to [-128,255], for better interoperability with platforms that consider bytes unsigned.
4 files changed
tree: 574ccf41e6aa3a83bc9be7f51eb9d10700ba9a77
  1. release-notes/
  2. src/
  3. .gitignore
  4. create-test-report.sh
  5. pom.xml
  6. README.md
README.md

Overview

This project contains core low-level incremental ("streaming") parser and generator abstractions for Jackson Data Processor. It also includes the default implementation of handler types (parser, generator) that handle JSON format. The core abstractions are not JSON specific, although naming does contain 'JSON' in many places, due to historical reasons. Only packages that specifically contain word 'json' are JSON-specific.

This package is the base on which Jackson data-binding package builds on. Alternate data format implementations (like Smile (binary JSON), XML and CSV) build on this base package, implementing the core interfaces, and making it possible to use standard data-binding package.

Differences from Jackson 1.x

Project contains versions 2.0 and above: source code for earlier (1.x) versions is available from Codehaus SVN repository

Note that the main differences compared to 1.0 core jar are:

  • Maven build instead of Ant
  • Annotations carved out to a separate package (that this package depends on)
  • Java package is now com.fasterxml.jackson.core (instead of org.codehaus.jackson)

Usage, general

Maven, Java package

Functionality of this package is contained in Java package com.fasterxml.core.databind.

To use databinding, you need to use following Maven dependency:

<dependency>
  <groupId>com.fasterxml.jackson.core</groupId>
  <artifactId>jackson-core</artifactId>
  <version>2.0.0</version>
</dependency>

or download jars from Maven repository or Download page. Core jar is a functional OSGi bundle, with proper import/export declarations.

Package has no external dependencies, except for testing (which uses JUnit).


Usage, simple

(TO BE WRITTEN)


Further reading