jsimple.json

Class Json

java.lang.Object

jsimple.json.Json

public final class Json
extends java.lang.Object

Constructor Summary

Constructors

Constructor and Description
Json()

Method Summary

Modifier and Type	Method and Description
static JsonObjectOrArray	parse(Reader reader) Parse the specified JSON text, returning a JsonObject or JsonArray, depending on what the outermost container type is in the JSON.
static JsonArray	parseArray(Reader reader) Parse the specified JSON text, returning a JsonArray.
static JsonObject	parseObject(Reader reader) Parse the specified JSON text, returning a JsonObject.
static java.lang.Object	read(Reader reader) Return a JsonObjectReader or a JsonArrayReader for the specified JSON text, depending on what the outermost container type is in the JSON.
static JsonArrayReader	readArray(Reader reader) Assuming the JSON text is an array, return a JsonArrayReader, to iteratively parse through the items in the array one by one, to process each as it's parsed.
static JsonObjectReader	readObject(Reader reader) Assuming the JSON text is an object, return a JsonObjectReader, to iteratively read through the name/value pairs in the object one by one, to process each as it's parsed.
static long	toLong(java.lang.Object value)
static JsonArrayWriter	writeArray(Writer writer) Serialize a JSON array, item by item.
static JsonObjectWriter	writeObject(Writer writer) Serialize a JSON array, item by item.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Json

public Json()

Method Detail

parse

public static JsonObjectOrArray parse(Reader reader)

Parse the specified JSON text, returning a JsonObject or JsonArray, depending on what the outermost container type is in the JSON. Per JSON spec, the root element in a JSON text is either an array or an object.

Parameters:

reader - JSON text

Returns:

JSON object tree, either a JsonObject or JsonArray object; use instanceof to distinguish

parseObject

public static JsonObject parseObject(Reader reader)

Parse the specified JSON text, returning a JsonObject. If the JSON isn't an object (e.g. is actually an array), then an exception is thrown.

Parameters:

reader - JSON text

Returns:

JsonObject object tree

parseArray

public static JsonArray parseArray(Reader reader)

Parse the specified JSON text, returning a JsonArray. If the JSON isn't an array (e.g. is actually a JsonObject), then an exception is thrown.

Parameters:

reader - JSON text

Returns:

JsonArray object tree

read

public static java.lang.Object read(Reader reader)

Return a JsonObjectReader or a JsonArrayReader for the specified JSON text, depending on what the outermost container type is in the JSON. The caller can use instanceof to determine which it is.

Parameters:

reader - JSON text

Returns:

JsonObjectReader or JsonArrayReader

readObject

public static JsonObjectReader readObject(Reader reader)

Assuming the JSON text is an object, return a JsonObjectReader, to iteratively read through the name/value pairs in the object one by one, to process each as it's parsed. If the object is big (normally always because it has descendant objects that can contain big arrays), this can be more efficient than parsing the whole JSON text into memory at once. If text isn't a JSON object (e.g. is a JSON array), a class cast exception is thrown.

Parameters:

reader - JSON text, which should be a JSON array

Returns:

array reader, to read through the array

readArray

public static JsonArrayReader readArray(Reader reader)

Assuming the JSON text is an array, return a JsonArrayReader, to iteratively parse through the items in the array one by one, to process each as it's parsed. If the array is big this can be more efficient than parsing the whole JSON text into memory at once. If text isn't a JSON array (e.g. is a JSON object), a class cast exception is thrown.

Parameters:

reader - JSON text, which should be a JSON array

Returns:

array reader, to read through the array

writeObject

public static JsonObjectWriter writeObject(Writer writer)

Serialize a JSON array, item by item. When an array is large and the root of a JSON text, this method is more memory efficient than creating a single JsonArray (including all items inside of it) in memory all at once and serializing that.

Returns:

JsonArrayWriter, to serialize each item

writeArray

public static JsonArrayWriter writeArray(Writer writer)

Serialize a JSON array, item by item. When an array is large and the root of a JSON text, this method is more memory efficient than creating a single JsonArray (including all items inside of it) in memory all at once and serializing that.

Returns:

JsonArrayWriter, to serialize each item

toLong

public static long toLong(java.lang.Object value)