Class JSONEventReader

java.lang.Object

com.leastfixedpoint.json.JSONEventReader

public class JSONEventReader
extends Object

SAX-style event-emitting JSON parser. Only needed in advanced situations. Usually, JSONReader will be what you're looking for.

If you do decide you want SAX-style events rather than finished, ready-to-use JSON-representing objects from JSONReader.read() or JSONReader.readValue(), then instantiate this class and call next() repeatedly until you're done or it returns null. It will return tokens as follows:

• Strings, numbers, booleans, and null JSON values are returned directly, following the type mapping documented in the class comment for JSONReader.
• An object will be presented as JSONReader.Lexeme.OBJECT_START. Subsequent calls to next() will alternate between returning keys (strings) and values (possibly complex token sequences) until the object is closed by JSONReader.Lexeme.OBJECT_END.
• Similarly, an array appears as JSONReader.Lexeme.ARRAY_START followed by values (as possibly complex token sequences) until the end of the array, signalled by JSONReader.Lexeme.ARRAY_END.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static enum	JSONEventReader.State

Field Summary

Fields

Modifier and Type	Field	Description
protected JSONReader	jsonReader
protected JSONEventReader.State	state
protected List<JSONEventReader.State>	stateStack

Constructor Summary

Constructors

Constructor	Description
JSONEventReader(JSONReader jsonReader)

Method Summary

Modifier and Type	Method	Description
boolean	atBoundary()	Returns true iff the parser is not mid-way through some object; that is, we are at a boundary between JSON values.
protected void	gotoState(JSONEventReader.State newState)
protected void	maybeEnterNested(Object token)
Object	next()	Yields the next JSON token.
protected void	pop()
protected void	pushAndGoto(JSONEventReader.State newState)

Methods inherited from class java.lang.Object

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

Field Details

jsonReader

protected JSONReader jsonReader

stateStack

protected List<JSONEventReader.State> stateStack

state

protected JSONEventReader.State state

Constructor Details

JSONEventReader

public JSONEventReader(JSONReader jsonReader)

Method Details

next

public Object next()
            throws IOException

Yields the next JSON token. Returns null at the end of the input (and thus differs from the behaviour of JSONReader.nextLexeme()).

Throws:

IOException

atBoundary

public boolean atBoundary()

Returns true iff the parser is not mid-way through some object; that is, we are at a boundary between JSON values.

maybeEnterNested

protected void maybeEnterNested(Object token)
                         throws JSONSyntaxError

Throws:

JSONSyntaxError

gotoState

protected void gotoState(JSONEventReader.State newState)

pushAndGoto

protected void pushAndGoto(JSONEventReader.State newState)

pop

protected void pop()