org.json

Class JSONStrictTokener

java.lang.Object

org.json.Scanner

org.json.JSONTokener

org.json.JSONStrictTokener

public class JSONStrictTokener
extends JSONTokener

A JSONStrictTokener takes a source stream and extracts characters and tokens from it. It is used by the JSONObject and JSONArray constructors to parse JSON source streams as strictly according to the specification as possible.

For a lenient parse, use JSONTokener.

Nested Class Summary

Nested classes/interfaces inherited from class org.json.JSONTokener

JSONTokener.JSONToken

Constructor Summary

Constructors

Constructor and Description
JSONStrictTokener(java.io.InputStream inputStream, java.nio.charset.Charset charset) Construct a JSONStrictTokener from an InputStream and supplied Charset.
JSONStrictTokener(java.io.Reader reader) Construct a JSONStrictTokener from a Reader.
JSONStrictTokener(java.lang.String s) Construct a JSONStrictTokener from a string.

Method Summary

Modifier and Type	Method and Description
char	nextClean() Get the next char in the stream, skipping insignificant whitespace.
protected JSONArray	nextJSONArray() Parse a JSON array strictly according to the JSON specification.
protected JSONObject	nextJSONObject() Parse a JSON object strictly according to the JSON specification.
java.lang.String	nextKey() Get the next key.
protected java.lang.Number	nextNumber() Parse a number strictly according to the JSON specification.
java.lang.String	nextString(char quote) Return the characters up to the next close quote character.
JSONTokener.JSONToken	nextTokenType() Get the type of the next token in the stream, skipping whitespace.
java.lang.Object	nextValue() Get the next value.
static JSONArray	parseJSONArray(java.io.InputStream inputStream, java.nio.charset.Charset charset) Construct a JSONArray from an InputStream and supplied Charset.
static JSONArray	parseJSONArray(java.io.Reader reader) Construct a JSONArray from a Reader.
static JSONArray	parseJSONArray(java.lang.String s) Construct a JSONArray from a string.
static JSONObject	parseJSONObject(java.io.InputStream inputStream, java.nio.charset.Charset charset) Construct a JSONObject from an InputStream and supplied Charset.
static JSONObject	parseJSONObject(java.io.Reader reader) Construct a JSONObject from a Reader.
static JSONObject	parseJSONObject(java.lang.String s) Construct a JSONObject from a string.
static java.lang.Object	parseJSONValue(java.io.InputStream inputStream, java.nio.charset.Charset charset) Construct a JSON value from an InputStream and supplied Charset.
static java.lang.Object	parseJSONValue(java.io.Reader reader) Construct a JSON value from a Reader.
static java.lang.Object	parseJSONValue(java.lang.String s) Construct a JSON value from a string.

Methods inherited from class org.json.JSONTokener

pooledKey, toString

Methods inherited from class org.json.Scanner

back, dehexchar, end, more, next, next, next, nextTo, nextTo, parsePosition, skipTo, syntaxError, syntaxError, syntaxError

Methods inherited from class java.lang.Object

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

Constructor Detail

JSONStrictTokener

public JSONStrictTokener(java.io.Reader reader)

Construct a JSONStrictTokener from a Reader.

Parameters:

reader - A reader.

JSONStrictTokener

public JSONStrictTokener(java.io.InputStream inputStream,
                         java.nio.charset.Charset charset)

Construct a JSONStrictTokener from an InputStream and supplied Charset.

Parameters:

inputStream - an input stream from which to tokenize the JSON text

charset - the character set with which to interpret the input stream

JSONStrictTokener

public JSONStrictTokener(java.lang.String s)

Construct a JSONStrictTokener from a string.

Parameters:

s - A source string.

Method Detail

nextClean

public char nextClean()
               throws JSONException

Get the next char in the stream, skipping insignificant whitespace. Control characters less than U+0020, apart from newline and carriage return, result in an error.

Overrides:

nextClean in class JSONTokener

Returns:

A character, or 0 if there are no more characters.

Throws:

JSONException - there was a problem tokenizing the JSON text

nextTokenType

public JSONTokener.JSONToken nextTokenType()
                                    throws JSONException

Get the type of the next token in the stream, skipping whitespace. This parses the literal separators only.

Overrides:

nextTokenType in class JSONTokener

Returns:

the Token type representing the next token type

Throws:

JSONException

See Also:

JSONTokener.JSONToken

nextString

public java.lang.String nextString(char quote)
                            throws JSONException

Return the characters up to the next close quote character. Backslash processing is done. The formal JSON format only allows strings in double quotes.

Overrides:

nextString in class JSONTokener

Parameters:

quote - The quoting character, must be " (double quote).

Returns:

A String.

Throws:

JSONException - Unterminated string.

nextKey

public java.lang.String nextKey()
                         throws JSONException

Get the next key. This must be a quoted String value.

Overrides:

nextKey in class JSONTokener

Returns:

An object.

Throws:

JSONException - If syntax error.

nextValue

public java.lang.Object nextValue()
                           throws JSONException

Get the next value. The value can be a Boolean, Double, Integer, JSONArray, JSONObject, Long, or String, or the JSONObject.NULL object.

Overrides:

nextValue in class JSONTokener

Returns:

An object.

Throws:

JSONException - If syntax error.

nextJSONObject

protected JSONObject nextJSONObject()

Parse a JSON object strictly according to the JSON specification.

Returns:

the JSON object represented by the token sequence

nextJSONArray

protected JSONArray nextJSONArray()

Parse a JSON array strictly according to the JSON specification.

Returns:

the JSON array represented by the token sequence

nextNumber

protected java.lang.Number nextNumber()

Parse a number strictly according to the JSON specification.

Returns:

the number represented by the token sequence

parseJSONObject

public static JSONObject parseJSONObject(java.io.Reader reader)
                                  throws JSONException

Construct a JSONObject from a Reader.

Parameters:

reader - the source reader

Returns:

a JSONObject containing the parsed data

Throws:

JSONException - there was a parse error

parseJSONObject

public static JSONObject parseJSONObject(java.io.InputStream inputStream,
                                         java.nio.charset.Charset charset)

Construct a JSONObject from an InputStream and supplied Charset.

Parameters:

inputStream - the input stream containing the byte sequences to parse

charset - the character set for interpreting the byte sequence

Returns:

a JSONObject containing the parsed data

Throws:

JSONException - there was a parse error

parseJSONObject

public static JSONObject parseJSONObject(java.lang.String s)

Construct a JSONObject from a string.

Parameters:

s - A source string.

Returns:

a JSONObject containing the parsed data

Throws:

JSONException - there was a parse error

parseJSONArray

public static JSONArray parseJSONArray(java.io.Reader reader)
                                throws JSONException

Construct a JSONArray from a Reader.

Parameters:

reader - the source reader

Returns:

a JSONArray containing the parsed data

Throws:

JSONException - there was a parse error

parseJSONArray

public static JSONArray parseJSONArray(java.io.InputStream inputStream,
                                       java.nio.charset.Charset charset)
                                throws JSONException

Construct a JSONArray from an InputStream and supplied Charset.

Parameters:

inputStream - the input stream containing the byte sequences to parse

charset - the character set for interpreting the byte sequence

Returns:

a JSONArray containing the parsed data

Throws:

JSONException - there was a parse error

parseJSONArray

public static JSONArray parseJSONArray(java.lang.String s)
                                throws JSONException

Construct a JSONArray from a string.

Parameters:

s - A source string.

Returns:

a JSONArray containing the parsed data

Throws:

JSONException - there was a parse error

parseJSONValue

public static java.lang.Object parseJSONValue(java.io.Reader reader)
                                       throws JSONException

Construct a JSON value from a Reader.

Parameters:

reader - the source reader

Returns:

an Object containing the parsed data

Throws:

JSONException - there was a parse error

parseJSONValue

public static java.lang.Object parseJSONValue(java.io.InputStream inputStream,
                                              java.nio.charset.Charset charset)
                                       throws JSONException

Construct a JSON value from an InputStream and supplied Charset.

Parameters:

inputStream - the input stream containing the byte sequences to parse

charset - the character set for interpreting the byte sequence

Returns:

an Object containing the parsed data

Throws:

JSONException - there was a parse error

parseJSONValue

public static java.lang.Object parseJSONValue(java.lang.String s)
                                       throws JSONException

Construct a JSON value from a string.

Parameters:

s - A source string.

Returns:

an Object containing the parsed data

Throws:

JSONException - there was a parse error