Package ej.json

Class JSONReader

java.lang.Object

ej.json.JSONReader

public class JSONReader
extends Object

A JSONReader takes a source InputStream and extracts characters and tokens from it.

Field Summary

Fields

Modifier and Type	Field	Description
static Object	NULL	It is sometimes more convenient and less ambiguous to have a NULL object than to use Java's null value.

Constructor Summary

Constructors

Constructor	Description
JSONReader(InputStream is)	Construct a JSONReader from an InputStream.

Method Summary

Modifier and Type	Method	Description
void	arrayEnd()	End an array.
void	arrayStart()	Start an array.
void	mapEnd()	End a map.
void	mapStart()	Start a map.
String	nextKey()	Get the next key as String.
Object	nextValue()	Get the next value.
char	peek()	Get the first character of the next token.

Methods inherited from class java.lang.Object

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

Field Detail

NULL

public static final Object NULL

It is sometimes more convenient and less ambiguous to have a NULL object than to use Java's null value. NULL.equals(null) returns true. NULL.toString() returns "null".

Constructor Detail

JSONReader

public JSONReader(InputStream is)

Construct a JSONReader from an InputStream.

Parameters:

is - the InputStream.

Method Detail

peek

public char peek()
          throws JSONException

Get the first character of the next token.

Returns:

the first character or 0 on EOF.

Throws:

JSONException - on I/O error

nextKey

public String nextKey()
               throws JSONException

Get the next key as String.

Returns:

A String

Throws:

JSONException - If syntax error.

arrayStart

public void arrayStart()
                throws JSONException

Start an array.

Throws:

JSONException - If syntax error.

arrayEnd

public void arrayEnd()
              throws JSONException

End an array.

Throws:

JSONException - If syntax error.

mapStart

public void mapStart()
              throws JSONException

Start a map.

Throws:

JSONException - If syntax error.

mapEnd

public void mapEnd()
            throws JSONException

End a map.

Throws:

JSONException - If syntax error.

nextValue

public Object nextValue()
                 throws JSONException

Get the next value. The value can be a Boolean, Double, Integer, Long, or String, or the JSONReader.Null object.

Returns:

An object or null if the beginning of array or a map is reached.

Throws:

JSONException - If syntax error.