com.fasterxml.jackson.jr.ob.api

Class ValueReader

java.lang.Object

com.fasterxml.jackson.jr.ob.api.ValueReader

Direct Known Subclasses:

AnyReader, ArrayReader, BeanReader, CollectionReader, EnumReader, MapReader, SimpleValueReader

public abstract class ValueReader
extends Object

API and base class for all "deserializer" implementations used to actually read values of Java types from (JSON) input.

Field Summary

Fields

Modifier and Type	Field and Description
protected Class<?>	_valueType Type of values this reader will read

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ValueReader(Class<?> valueType)

Method Summary

Modifier and Type	Method and Description
static String	_tokenDesc(JsonParser p) Helper method for getting description of the token parser currently points to, for use in descriptions and exception messages.
static String	_tokenDesc(JsonParser p, JsonToken t) Helper method for getting description of given token for use in descriptions and exception messages.
abstract Object	read(JSONReader reader, JsonParser p) Method called to deserialize value of type supported by this reader, using given parser.
Object	readNext(JSONReader reader, JsonParser p) Method called to deserialize value of type supported by this reader, using given parser.
Class<?>	valueType() Accessor for non-generic (type-erased) type of values this reader produces from input.

Methods inherited from class java.lang.Object

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

Field Detail

_valueType

protected final Class<?> _valueType

Type of values this reader will read

Since:

2.10

Constructor Detail

ValueReader

protected ValueReader(Class<?> valueType)

Method Detail

read

public abstract Object read(JSONReader reader,
                            JsonParser p)
                     throws IOException

Method called to deserialize value of type supported by this reader, using given parser. Parser is already positioned to the (first) token of the value to read.

Parameters:

reader - Context object that allows calling other read methods for contained values of different types (for example for collection readers).

p - Underlying parser used for reading decoded token stream

Throws:

IOException

readNext

public Object readNext(JSONReader reader,
                       JsonParser p)
                throws IOException

Method called to deserialize value of type supported by this reader, using given parser. Parser is not yet positioned to the (first) token of the value to read and needs to be advanced.

Default implementation simply calls `p.nextToken()` first, then calls {#link read(JSONReader, JsonParser), but some implementations may decide to implement this differently to use (slightly) more efficient accessor in JsonParser, like JsonParser.nextIntValue(int).

Parameters:

reader - Context object that allows calling other read methods for contained values of different types (for example for collection readers).

p - Underlying parser used for reading decoded token stream

Throws:

IOException

valueType

public Class<?> valueType()

Accessor for non-generic (type-erased) type of values this reader produces from input.

Since:

2.10

_tokenDesc

public static String _tokenDesc(JsonParser p)
                         throws IOException

Helper method for getting description of the token parser currently points to, for use in descriptions and exception messages.

Throws:

IOException

_tokenDesc

public static String _tokenDesc(JsonParser p,
                                JsonToken t)
                         throws IOException

Helper method for getting description of given token for use in descriptions and exception messages.

Throws:

IOException