net.pwall.json.stream

Interface JSONBuilder

All Known Implementing Classes:

JSONArrayBuilder, JSONKeywordBuilder, JSONNumberBuilder, JSONObjectBuilder, JSONStringBuilder, JSONValueBuilder

public interface JSONBuilder

Interface implemented by all JSONXxxxBuilder classes, which consume a stream of characters representing a JSON value and return the parsed value.

Author:

Peter Wall

Method Summary

Modifier and Type	Method and Description
boolean	acceptChar(int ch) Accept a character as part of the JSON, and return true if the character has been consumed.
static void	checkWhitespace(int ch)
default void	close() Close the builder.
net.pwall.json.JSONValue	getResult() Get the JSONValue result.
boolean	isComplete() Test whether the JSON being parsed by this builder is complete.
static boolean	isWhitespace(int ch) Test a character for whitespace.

Method Detail

isComplete

boolean isComplete()

Test whether the JSON being parsed by this builder is complete.

Returns:

true if the JSON is complete

getResult

net.pwall.json.JSONValue getResult()

Get the JSONValue result.

Returns:

the result

Throws:

net.pwall.json.JSONException - if the JSON is not complete

acceptChar

boolean acceptChar(int ch)

Accept a character as part of the JSON, and return true if the character has been consumed. The character is in the form of a Unicode code point; since all of the syntactic elements of JSON fall within the ASCII subset, the only place this is relevant is inside strings.

Parameters:

ch - the character

Returns:

true if the character has been consumed

Throws:

net.pwall.json.JSONException - if the character is not valid

close

default void close()

Close the builder. The default implementation throws an exception if the JSON is not complete.

Throws:

net.pwall.json.JSONException - if the JSON is not complete

isWhitespace

static boolean isWhitespace(int ch)

Test a character for whitespace.

Parameters:

ch - the character

Returns:

true if the character is whitespace

checkWhitespace

static void checkWhitespace(int ch)