json-simple


JSON.simple - A simple Java toolkit for JSON

GitHub

https://github.com/fangyidong/json-simple

Overview

JSON.simple is a simple Java toolkit for JSON. You can use JSON.simple to encode or decode JSON text.

Features

  • Full compliance with JSON specification (RFC4627) and reliable (see compliance testing)

  • Provides multiple functionalities such as encode, decode/parse and escape JSON text while keeping the library lightweight

  • Flexible, simple and easy to use by reusing Map and List interfaces

  • Supports streaming output of JSON text

  • Stoppable SAX-like interface for streaming input of JSON text (learn more)

  • Heap based parser

  • High performance (see performance testing)

  • No dependency on external libraries

  • Both of the source code and the binary are JDK1.2 compatible

Getting Started

Note: You need to put the latest json-simple-1.1.1.jar in your CLASSPATH before compiling and running the example codes.

  • Encoding Examples
  • Decoding Examples
  • Escaping Examples
  • JSP and AJAX Examples

Mapping Between JSON and Java Entities

| JSON | Java | |:---------|:---------| | string | java.lang.String | | number | java.lang.Number | | true|false | java.lang.Boolean | | null | null | | array | java.util.List | | object | java.util.Map |

JSON.simple maps entities from the left side to the right side while decoding or parsing, and maps entities from the right to the left while encoding. While decoding, default concrete class of java.util.List is org.json.simple.JSONArray and default concrete class of java.util.Map is org.json.simple.JSONObject. While encoding, other classes that are not listed on the right side of the table need to implement JSONAware or JSONStreamAware (streaming only) to customize JSON outputs. In such cases, JSON.simple calls JSONAware.toJSONString() or JSONStreamAware.writeJSONString() to determine the resulting JSON text.

Maven Repository

  • JSON.simple in central maven repository

Developer's Guide

  • Build With Ant
  • Build With Eclipse
  • The JSON Lexer

JSON.simple in Projects/Products

JSON.simple in Fedora

JSON.simple in Ubuntu

JSON.simple in Publications

Next Steps

  • Auto marshalling and unmarshalling utils for Java Beans

Links

About me

Yidong Fang

Acknowledgment

http://www.yourkit.com/images/yklogo.png
YourKit is kindly supporting this open source project with its full-featured Java Profiler.
YourKit, LLC is the creator of innovative and intelligent tools for profiling Java and .NET applications. Take a look at YourKit's leading software products:

  • http://www.yourkit.com/java/profiler/index.jsp'>YourKit Java Profiler
  • http://www.yourkit.com/.net/profiler/index.jsp'>YourKit .NET Profiler

  • Project Information

    Labels:
    JSON JSON.simple Java parser encode decode marshal unmarshal json_simple ajax library tutorial SAX-like stoppable streaming