de.caff.io.json

Class SimpleJsonReader.PickyArrayHandler

java.lang.Object

de.caff.io.json.SimpleJsonReader.ArrayHandler

de.caff.io.json.SimpleJsonReader.PickyArrayHandler

All Implemented Interfaces:

SimpleJsonReader.Handler, SimpleJsonReader.TemporaryHandler

Enclosing class:

SimpleJsonReader

public abstract static class SimpleJsonReader.PickyArrayHandler
extends SimpleJsonReader.ArrayHandler

An array handler which throws an IllegalStateException for each value method.

Deriving your array handler from this class is useful in cases where you expect only values of a few certain types.

See Also:

SimpleJsonReader.ObjectHandler

Constructor Summary

Constructors

Constructor and Description
PickyArrayHandler()

Method Summary

Modifier and Type	Method and Description
protected SimpleJsonReader.TemporaryHandler	arrayElement(int index) Called when the beginning of an array sub-element was read.
protected void	element(int index, boolean v) Called when a boolean element was read.
protected void	element(int index, java.lang.Number v) Called when a number value was read.
protected void	element(int index, java.lang.String v) Called when a text element was read.
protected void	nullElement(int index) Called when a null element was read.
protected SimpleJsonReader.TemporaryHandler	objectElement(int index) Called when the beginning of an object element was read.
protected void	throwException(Json.ValueType valueType) Method for throwing an IllegalStateException.

Methods inherited from class de.caff.io.json.SimpleJsonReader.ArrayHandler

beginArray, beginObject, endArray, endObject, key, nullValue, value, value, value

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.caff.io.json.SimpleJsonReader.TemporaryHandler

finish, initialize

Constructor Detail

PickyArrayHandler

public PickyArrayHandler()

Method Detail

throwException

protected void throwException(@NotNull
                              Json.ValueType valueType)

Method for throwing an IllegalStateException.

Parameters:

valueType - expected value type

Throws:

java.lang.IllegalStateException - always

objectElement

@NotNull
protected SimpleJsonReader.TemporaryHandler objectElement(int index)

Description copied from class: SimpleJsonReader.ArrayHandler

Called when the beginning of an object element was read. Expected to return a dedicated reader which is used to read the content of the object. The handler will be initialized with its SimpleJsonReader.TemporaryHandler.initialize(SimpleJsonReader) method, then be used to handle the key-value pairs inside the object. When the object is finished, the handler's SimpleJsonReader.TemporaryHandler.finish(SimpleJsonReader) method is called.

If the key is unsupported either throw an exception or return SimpleJsonReader.SKIP_HANDLER which will ignore the object.

Specified by:

objectElement in class SimpleJsonReader.ArrayHandler

Parameters:

index - index of the array element which is read

Returns:

dedicated reader for the object, usually an SimpleJsonReader.ObjectHandler

arrayElement

@NotNull
protected SimpleJsonReader.TemporaryHandler arrayElement(int index)

Description copied from class: SimpleJsonReader.ArrayHandler

Called when the beginning of an array sub-element was read. Expected to return a dedicated reader which is used to read the content of the array. The handler will be initialized with its SimpleJsonReader.TemporaryHandler.initialize(SimpleJsonReader) method, then be used to handle the key-value pairs inside the object. When the object is finished, the handler's SimpleJsonReader.TemporaryHandler.finish(SimpleJsonReader) method is called.

If the key is unsupported either throw an exception or return SimpleJsonReader.SKIP_HANDLER which will ignore the object.

Specified by:

arrayElement in class SimpleJsonReader.ArrayHandler

Parameters:

index - index of the array element which is read

Returns:

dedicated reader for the object, usually another SimpleJsonReader.ArrayHandler

nullElement

protected void nullElement(int index)

Description copied from class: SimpleJsonReader.ArrayHandler

Called when a null element was read.

Specified by:

nullElement in class SimpleJsonReader.ArrayHandler

Parameters:

index - index of the array element which is read

element

protected void element(int index,
                       @NotNull
                       java.lang.String v)

Description copied from class: SimpleJsonReader.ArrayHandler

Called when a text element was read.

Specified by:

element in class SimpleJsonReader.ArrayHandler

Parameters:

index - index of the array element which is read

v - text value

element

protected void element(int index,
                       boolean v)

Description copied from class: SimpleJsonReader.ArrayHandler

Called when a boolean element was read.

Specified by:

element in class SimpleJsonReader.ArrayHandler

Parameters:

index - index of the array element which is read

v - boolean value

element

protected void element(int index,
                       @NotNull
                       java.lang.Number v)

Description copied from class: SimpleJsonReader.ArrayHandler

Called when a number value was read.

Specified by:

element in class SimpleJsonReader.ArrayHandler

Parameters:

index - index of the array element which is read

v - number value, implementation will provide either an Integer (if fit), or a Double