Description

JSON4Java is a set of Java libraries and tools for manipulating JSON. Some of the the technologies supported include:

JSON text document parser
Support for parsing and serializing to Java primitives (strings, numbers, booleans, and List/Map collections)
Compatibility for parsing and serializing to the "json.org" library
Schema validation support for JSON documents
Java object binding through xml configuration or annotations.

The architecture of JSON4Java is based on components which emit or consume streams of JSON events, similar to how XML pull parsers work. This allows for more efficient operations, as well as arbitrary conversions between different representations.

The core parser is also based directly on RFC 4627, the informational RFC describing the JSON format. The code for parsing is based on the specification and the Ragel code generator, which makes it both highly efficient and conformant to the RFC. A wide variety of pass/fail tests and data validating unit tests are also in place.

Getting JSON4Java

JSON4Java is currently in pre-1.0 development; while the core and compatibility projects are fully written, the API is still in flux as Schema validation and object binding are being created. Files are however available within the snapshot maven repository at http://json4java.googlecode.com/svn/maven/snapshots, either for use with the (recommended) maven tool, or for manual download/installation. The files can be included in a maven project by using the lines

<dependency>
  <groupId>com.alkalinesolutions.json</groupId>
  <artifactId>json4java-core</artifactId>
  <version>1.0-SNAPSHOT</version>
</dependency>
<dependency>
  <groupId>com.alkalinesolutions.json</groupId>
  <artifactId>json4java-org.json</artifactId>
  <version>1.0-SNAPSHOT</version>
</dependency>

as well as adding the snapshot repository:

<repositories>
  <repository>
    <id>json4java.snapshots</id>
    <name>JSON4Java Snapshot Repository</name>
    <url>http://json4java.googlecode.com/svn/maven/snapshots</url>
  </repository>
</repositories>