org.yuanheng.cookjson

Class UTF8TextJsonParser

java.lang.Object

org.yuanheng.cookjson.UTF8TextJsonParser

All Implemented Interfaces:

Closeable, AutoCloseable, JsonParser, CookJsonParser

public class UTF8TextJsonParser
extends Object
implements CookJsonParser

This parser is much like TextJsonParser, except that it only works on UTF-8 InputStream. It can be several times faster than TextJsonParser.

Author:

Heng Yuan

Nested Class Summary

Nested classes/interfaces inherited from interface javax.json.stream.JsonParser

JsonParser.Event

Constructor Summary

Constructors

Constructor and Description
UTF8TextJsonParser(InputStream is) Create a JsonParser based on a UTF-8 InputStream input.
UTF8TextJsonParser(InputStream is, int bufferSize) Create a JsonParser based on a UTF-8 InputStream input and specifying the buffer size.

Method Summary

Modifier and Type	Method and Description
void	close()
BigDecimal	getBigDecimal()
byte[]	getBytes() Returns the byte[] value if the parser state is JsonParser.Event.VALUE_STRING and the data is actually a binary data.
JsonParser.Event	getEvent() Gets the current event.
int	getInt()
JsonLocation	getLocation()
long	getLong()
String	getString()
JsonValue	getValue() Based on the current event, retrieve the JsonValue.
boolean	hasNext()
boolean	isAllowComments() Gets whether parsing comments is allowed.
boolean	isBinary() Returns true if the current JSON value at the current parser state is actually a binary data.
boolean	isIntegralNumber()
JsonParser.Event	next()
void	setAllowComments(boolean allowComments) Sets to allow line and block comments to be embedded in JSON.

Methods inherited from class java.lang.Object

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

Constructor Detail

UTF8TextJsonParser

public UTF8TextJsonParser(InputStream is)

Create a JsonParser based on a UTF-8 InputStream input.

Parameters:

is - UTF-8 InputStream

UTF8TextJsonParser

public UTF8TextJsonParser(InputStream is,
                          int bufferSize)

Create a JsonParser based on a UTF-8 InputStream input and specifying the buffer size.

Parameters:

is - UTF-8 InputStream

bufferSize - the input buffer size.

Method Detail

getEvent

public JsonParser.Event getEvent()

Description copied from interface: CookJsonParser

Gets the current event.

Specified by:

getEvent in interface CookJsonParser

Returns:

the current event.

getValue

public JsonValue getValue()

Description copied from interface: CookJsonParser

Based on the current event, retrieve the JsonValue.

In case of START_OBJECT and START_ARRAY, JsonObject and JsonArray objects are returned. This feature is to allow the mixing of streaming and model based APIs.

Specified by:

getValue in interface CookJsonParser

Returns:

the JsonValue associated with the current event.

next

public JsonParser.Event next()

Specified by:

next in interface JsonParser

hasNext

public boolean hasNext()

Specified by:

hasNext in interface JsonParser

isIntegralNumber

public boolean isIntegralNumber()

Specified by:

isIntegralNumber in interface JsonParser

getInt

public int getInt()

Specified by:

getInt in interface JsonParser

getLong

public long getLong()

Specified by:

getLong in interface JsonParser

getBigDecimal

public BigDecimal getBigDecimal()

Specified by:

getBigDecimal in interface JsonParser

getLocation

public JsonLocation getLocation()

Specified by:

getLocation in interface JsonParser

getString

public String getString()

Specified by:

getString in interface JsonParser

isBinary

public boolean isBinary()

Description copied from interface: CookJsonParser

Returns true if the current JSON value at the current parser state is actually a binary data.

Specified by:

isBinary in interface CookJsonParser

Returns:

true if the String value is actually a binary.

getBytes

public byte[] getBytes()

Description copied from interface: CookJsonParser

Returns the byte[] value if the parser state is JsonParser.Event.VALUE_STRING and the data is actually a binary data.

Specified by:

getBytes in interface CookJsonParser

Returns:

the binary value.

close

public void close()

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Specified by:

close in interface JsonParser

isAllowComments

public boolean isAllowComments()

Gets whether parsing comments is allowed.

Returns:

the allowComments

setAllowComments

public void setAllowComments(boolean allowComments)

Sets to allow line and block comments to be embedded in JSON.

JSON standard does not allow JavaScript comments in JSON, so by default it is disabled.

Enabling this feature does not have any impact to parsing valid JSON files.

Parameters:

allowComments - the allowComments to set