Bug: 199275786

Clone this repo:
  1. 62e4340 Escaping double quotes inside the JSON quoted string am: b704857c91 by Sadaf Ebrahimi · 3 months ago master
  2. b704857 Escaping double quotes inside the JSON quoted string by Sadaf Ebrahimi · 3 months ago
  3. 5d22d53 Update OWNERS am: 4ff45e5b8e am: 478bc23883 am: d99432702a am: 9d1ad0d7a5 am: cfebd35318 by Neil Fuller · 12 months ago android13-dev android13-frc-adbd-release android13-frc-art-release android13-frc-cellbroadcast-release android13-frc-conscrypt-release aml_uwb_330810010 t_frc_adb_330444000 t_frc_art_330443060 t_frc_ase_330444010 t_frc_cbr_330443000 t_frc_con_330443020
  4. cfebd35 Update OWNERS am: 4ff45e5b8e am: 478bc23883 am: d99432702a am: 9d1ad0d7a5 by Neil Fuller · 12 months ago
  5. 9d1ad0d Update OWNERS am: 4ff45e5b8e am: 478bc23883 am: d99432702a by Neil Fuller · 12 months ago

Overview

This project contains core low-level incremental (“streaming”) parser and generator abstractions used by 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. It is licensed under Apache License 2.0. For additional/alternative licensing questions, please contact info@fasterxml.com: affordable commercial licenses available for use cases like Android app development.

Alternate data format implementations (like Smile (binary JSON), XML, CSV) and CBOR also build on this base package, implementing the core interfaces, making it possible to use standard data-binding package regardless of underlying data format.

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

Build Status Maven Central Javadoc Coverage Status

Get it!

Maven

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

To use the package, you need to use following Maven dependency:

<dependency>
  <groupId>com.fasterxml.jackson.core</groupId>
  <artifactId>jackson-core</artifactId>
  <version>${jackson-core-version}</version>
</dependency>

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

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

Non-Maven

For non-Maven use cases, you download jars from Central Maven repository or Wiki.

Core jar is also a functional OSGi bundle, with proper import/export declarations, so it can be use on OSGi container as is.


Use it!

General

Usage typically starts with creation of a reusable (and thread-safe, once configured) JsonFactory instance:

JsonFactory factory = new JsonFactory();
// configure, if necessary:
factory.enable(JsonParser.Feature.ALLOW_COMMENTS);

Alternatively, you have a ObjectMapper (from Jackson Databind package) handy; if so, you can do:

JsonFactory factory = objectMapper.getFactory();

Usage, simple reading

All reading is by using JsonParser (or its sub-classes, in case of data formats other than JSON), instance of which is constructed by JsonFactory.

An example can be found from Reading and Writing Event Streams

Usage, simple writing

All writing is by using JsonGenerator (or its sub-classes, in case of data formats other than JSON), instance of which is constructed by JsonFactory:

An example can be found from Reading and Writing Event Streams


Further reading

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)

Links