Module de.ralleytn.simple.json

Package de.ralleytn.simple.json

Class JSONParser

java.lang.Object

de.ralleytn.simple.json.JSONParser

public class JSONParser
extends Object

Parses JSON data (not thread-safe).

Since:

1.0.0

Version:

2.1.0

Author:

FangYidong(fangyidong@yahoo.com.cn), Ralph Niemitz/RalleYTN(ralph.niemitz@gmx.de)

Constructor Summary

Constructors

Constructor	Description
JSONParser()

Method Summary

Modifier and Type	Method	Description
int	getPosition()
Object	parse(Reader reader)	Parses JSON data from a Reader.
Object	parse(Reader reader, boolean strict)	Parses JSON data from a Reader.
void	parse(Reader reader, JSONContentHandler contentHandler)	Goes over JSON data step by step using a JSONContentHandler.
void	parse(Reader reader, JSONContentHandler contentHandler, boolean resume)	Goes over JSON data step by step using a JSONContentHandler.
void	parse(Reader reader, JSONContentHandler contentHandler, boolean resume, boolean strict)	Goes over JSON data step by step using a JSONContentHandler.
Object	parse(String json)	Parses JSON data.
Object	parse(String json, boolean strict)	Parses JSON data.
void	parse(String string, JSONContentHandler contentHandler)	Goes over a JSON string step by step using a JSONContentHandler.
void	parse(String string, JSONContentHandler contentHandler, boolean resume)	Goes over a JSON string step by step using a JSONContentHandler.
void	reset()	Resets the parser to the initial state without resetting the underlying reader.
void	reset(Reader reader)	Resets the parser to the initial state with a new character reader.

Methods inherited from class java.lang.Object

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

Constructor Details

JSONParser

public JSONParser()

Method Details

reset

public void reset()

Resets the parser to the initial state without resetting the underlying reader.

Since:

1.0.0

reset

public void reset(Reader reader)

Resets the parser to the initial state with a new character reader.

Parameters:

reader - the new character reader

Since:

1.0.0

getPosition

public int getPosition()

Returns:

the position where the current token begins

Since:

1.0.0

parse

public Object parse(String json)
             throws JSONParseException

Parses JSON data.

Parameters:

json - the JSON data

Returns:

An instance of:

• JSONObject
• JSONArray
• String
• Number
• Boolean
• null

Throws:

JSONParseException - if the JSON is invalid

Since:

1.0.0

parse

public Object parse(String json,
 boolean strict)
             throws JSONParseException

Parses JSON data.

Parameters:

json - the JSON data

strict - true for strict validation of JSON data; false if missing colons and commas should be tolerated

Returns:

An instance of:

• JSONObject
• JSONArray
• String
• Number
• Boolean
• null

Throws:

JSONParseException - if the JSON is invalid

Since:

2.1.0

parse

public Object parse(Reader reader)
             throws IOException,
JSONParseException

Parses JSON data from a Reader.

Parameters:

reader - the Reader

Returns:

An instance of:

• JSONObject
• JSONArray
• String
• Number
• Boolean
• null

Throws:

IOException - if an I/O error occurs

JSONParseException - if the JSON is invalid

Since:

1.0.0

parse

public Object parse(Reader reader,
 boolean strict)
             throws IOException,
JSONParseException

Parses JSON data from a Reader.

Parameters:

reader - the Reader

strict - true for strict validation of JSON data; false if missing colons and commas should be tolerated

Returns:

An instance of:

• JSONObject
• JSONArray
• String
• Number
• Boolean
• null

Throws:

IOException - if an I/O error occurs

JSONParseException - if the JSON is invalid

Since:

2.1.0

parse

public void parse(String string,
 JSONContentHandler contentHandler)
           throws JSONParseException

Goes over a JSON string step by step using a JSONContentHandler.

Parameters:

string - the JSON string

contentHandler - the JSONContentHandler

Throws:

JSONParseException - if the JSON is invalid or the JSONContentHandler throws it

Since:

1.0.0

parse

public void parse(String string,
 JSONContentHandler contentHandler,
 boolean resume)
           throws JSONParseException

Goes over a JSON string step by step using a JSONContentHandler.

Parameters:

string - the JSON string

contentHandler - the JSONContentHandler

resume - Indicates if the previous parsing operation should be continued.

Throws:

JSONParseException - if the JSON is invalid or the JSONContentHandler throws it

Since:

1.0.0

parse

public void parse(Reader reader,
 JSONContentHandler contentHandler)
           throws IOException,
JSONParseException

Goes over JSON data step by step using a JSONContentHandler.

Parameters:

reader - the Reader

contentHandler - the JSONContentHandler

Throws:

IOException - if an I/O error occurs or the JSONContentHandler throws it

JSONParseException - if the JSON is invalid or the JSONContentHandler throws it

Since:

1.0.0

parse

public void parse(Reader reader,
 JSONContentHandler contentHandler,
 boolean resume)
           throws IOException,
JSONParseException

Goes over JSON data step by step using a JSONContentHandler.

Parameters:

reader - the Reader

contentHandler - the JSONContentHandler

resume - Indicates if the previous parsing operation should be continued.

Throws:

IOException - if an I/O error occurs or the JSONContentHandler throws it

JSONParseException - if the JSON is invalid or the JSONContentHandler throws it

Since:

1.0.0

See Also:

• JSONContentHandler

parse

public void parse(Reader reader,
 JSONContentHandler contentHandler,
 boolean resume,
 boolean strict)
           throws IOException,
JSONParseException

Goes over JSON data step by step using a JSONContentHandler.

Parameters:

reader - the Reader

contentHandler - the JSONContentHandler

resume - Indicates if the previous parsing operation should be continued.

strict - true for strict validation of JSON data; false if missing colons and commas should be tolerated

Throws:

IOException - if an I/O error occurs or the JSONContentHandler throws it

JSONParseException - if the JSON is invalid or the JSONContentHandler throws it

Since:

2.1.0

See Also:

• JSONContentHandler