Jackson 2.18.2 · com.fasterxml.jackson.jr.ob.ValueIterator

Field Summary

Modifier and Type	Field and Description
protected final boolean	_closeParser Flag that indicates whether input `JsonParser` should be closed when we are done or not; generally only called when caller did not pass JsonParser.
protected final int	_mode Mode: kind of values we are iterating over
protected final JsonParser	_parser Underlying parser used for reading content to bind.
protected final JSONReader	_reader Context for deserialization, needed to pass through to deserializer
protected final JsonStreamContext	_seqContext Context to resynchronize to, in case an exception is encountered but caller wants to try to read more elements.
protected int	_state State of the iterator
protected final TreeCodec	_treeCodec If "Tree" values are read, codec we need to use for binding
protected final Class<?>	_type Type to bind individual elements to.
protected static final ValueIterator<?>	EMPTY_ITERATOR
protected static final int	MODE_ANY Mode in which values are read as "Simple" content, `java.util.Map`s, `java.util.List`s, `String`s, `Number`s and `Boolean`s.
protected static final int	MODE_BEAN Mode in which values are read as POJOs/Beans.
protected static final int	MODE_TREE Mode in which values are read as "Tree" values, as bound by registered `TreeCodec`.
protected static final int	STATE_CLOSED State in which iterator is closed
protected static final int	STATE_HAS_VALUE State in which "hasNextValue()" has been successfully called and deserializer can be called to fetch value
protected static final int	STATE_MAY_HAVE_VALUE State in which no recovery is needed, but "hasNextValue()" needs to be called first
protected static final int	STATE_NEED_RESYNC State in which value read failed

Constructor Summary

Access	Constructor and Description
protected	ValueIterator(int mode, Class<?> type, JsonParser p, JSONReader reader, TreeCodec treeCodec, boolean Whether we "own" the `JsonParser` passed or not: if true, it was created by `Json` and code here needs to close it; if false, it was passed by calling code and should not be closed by iterator. managedParser)

Method Summary

Modifier and Type	Method and Description
protected <R> R	_handleIOException(IOException e)
protected <R> R	_handleMappingException(JSONObjectException e)
protected void	_resync()
protected <R> R	_throwNoSuchElement()
public void	close() Implements java.io.Closeable.close. Closes this stream and releases any system resources associated with it.
public JsonLocation	Returns: Location of the input stream of the underlying parser currentLocation() Convenience method, functionally equivalent to: `iterator.getParser().getCurrentLocation()`
protected static <T> ValueIterator<T>	emptyIterator()
public JsonLocation	getCurrentLocation() Deprecated Since 2.17 use `currentLocation()` instead
public JsonParser	getParser() Accessor for getting underlying parser this iterator uses.
public boolean	hasNext() Implements java.util.Iterator.hasNext. Returns `true` if the iteration has more elements.
public boolean	hasNextValue() Equivalent of `next` but one that may throw checked exceptions from Jackson due to invalid input.
public T	next() Implements java.util.Iterator.next. Returns the next element in the iteration.
public T	nextValue()
public List<T>	Returns: List of entries read readAll() Convenience method for reading all entries accessible via this iterator; resulting container will be a `java.util.ArrayList`.
public <L extends List<? super T>> L	Returns: List of entries read (same as passed-in argument) readAll(L resultList) Convenience method for reading all entries accessible via this iterator
public <C extends Collection<? super T>> C	readAll(C results) Convenience method for reading all entries accessible via this iterator
public void	remove() Overrides default java.util.Iterator.remove. Removes from the underlying collection the last element returned by this iterator (optional operation).

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

_closeParser	back to summary
protected final boolean _closeParser Flag that indicates whether input `JsonParser` should be closed when we are done or not; generally only called when caller did not pass JsonParser.

_mode	back to summary
protected final int _mode Mode: kind of values we are iterating over

_parser	back to summary
protected final JsonParser _parser Underlying parser used for reading content to bind. Initialized as not `null` but set as `null` when iterator is closed, to denote closing.

_reader	back to summary
protected final JSONReader _reader Context for deserialization, needed to pass through to deserializer

_seqContext	back to summary
protected final JsonStreamContext _seqContext Context to resynchronize to, in case an exception is encountered but caller wants to try to read more elements.

_state	back to summary
protected int _state State of the iterator

_treeCodec	back to summary
protected final TreeCodec _treeCodec If "Tree" values are read, codec we need to use for binding

_type	back to summary
protected final Class<?> _type Type to bind individual elements to.

EMPTY_ITERATOR	back to summary
protected static final ValueIterator<?> EMPTY_ITERATOR

MODE_ANY	back to summary
protected static final int MODE_ANY Mode in which values are read as "Simple" content, `java.util.Map`s, `java.util.List`s, `String`s, `Number`s and `Boolean`s.

MODE_BEAN	back to summary
protected static final int MODE_BEAN Mode in which values are read as POJOs/Beans.

MODE_TREE	back to summary
protected static final int MODE_TREE Mode in which values are read as "Tree" values, as bound by registered `TreeCodec`.

STATE_CLOSED	back to summary
protected static final int STATE_CLOSED State in which iterator is closed

STATE_HAS_VALUE	back to summary
protected static final int STATE_HAS_VALUE State in which "hasNextValue()" has been successfully called and deserializer can be called to fetch value

STATE_MAY_HAVE_VALUE	back to summary
protected static final int STATE_MAY_HAVE_VALUE State in which no recovery is needed, but "hasNextValue()" needs to be called first

STATE_NEED_RESYNC	back to summary
protected static final int STATE_NEED_RESYNC State in which value read failed

Constructor Detail

ValueIterator	back to summary
protected ValueIterator(int mode, Class<?> type, JsonParser p, JSONReader reader, TreeCodec treeCodec, boolean managedParser) Parameters managedParser:boolean Whether we "own" the `JsonParser` passed or not: if true, it was created by `Json` and code here needs to close it; if false, it was passed by calling code and should not be closed by iterator.

Method Detail

_handleIOException	back to summary
protected <R> R _handleIOException(IOException e)

_handleMappingException	back to summary
protected <R> R _handleMappingException(JSONObjectException e)

_resync	back to summary
protected void _resync() throws IOException

_throwNoSuchElement	back to summary
protected <R> R _throwNoSuchElement()

close back to summary

close	back to summary
public void close() throws IOException Implements java.io.Closeable.close. Doc from java.io.Closeable.close. Closes this stream and releases any system resources associated with it. If the stream is already closed then invoking this method has no effect. As noted in `AutoCloseable#close()`, cases where the close may fail require careful attention. It is strongly advised to relinquish the underlying resources and to internally mark the `Closeable` as closed, prior to throwing the `IOException`. Annotations @Override Exceptions IOException: if an I/O error occurs

public void close() throws IOException

Implements java.io.Closeable.close.

Doc from java.io.Closeable.close.

Closes this stream and releases any system resources associated with it. If the stream is already closed then invoking this method has no effect.

As noted in AutoCloseable#close(), cases where the close may fail require careful attention. It is strongly advised to relinquish the underlying resources and to internally mark the Closeable as closed, prior to throwing the IOException.

Annotations

@Override

Exceptions

IOException:: if an I/O error occurs

currentLocation back to summary

currentLocation	back to summary
public JsonLocation currentLocation() Convenience method, functionally equivalent to: `iterator.getParser().getCurrentLocation()` Returns:JsonLocation Location of the input stream of the underlying parser Since 2.17

public JsonLocation currentLocation()

Convenience method, functionally equivalent to: iterator.getParser().getCurrentLocation()

Returns:JsonLocation: Location of the input stream of the underlying parser
Since: 2.17

emptyIterator	back to summary
protected static <T> ValueIterator<T> emptyIterator() Annotations @SuppressWarnings:unchecked

getCurrentLocation	back to summary
public JsonLocation getCurrentLocation() Deprecated Since 2.17 use `currentLocation()` instead Annotations @Deprecated

getParser	back to summary
public JsonParser getParser() Accessor for getting underlying parser this iterator uses.

hasNext back to summary

hasNext	back to summary
public boolean hasNext() Implements java.util.Iterator.hasNext. Doc from java.util.Iterator.hasNext. Returns `true` if the iteration has more elements. (In other words, returns `true` if `next` would return an element rather than throwing an exception.) Returns:boolean `true` if the iteration has more elements Annotations @Override

public boolean hasNext()

Implements java.util.Iterator.hasNext.

Doc from java.util.Iterator.hasNext.

Returns true if the iteration has more elements. (In other words, returns true if next would return an element rather than throwing an exception.)

Returns:boolean

true if the iteration has more elements

Annotations

@Override

hasNextValue	back to summary
public boolean hasNextValue() throws IOException Equivalent of `next` but one that may throw checked exceptions from Jackson due to invalid input.

next	back to summary
public T next() Implements java.util.Iterator.next. Doc from java.util.Iterator.next. Returns the next element in the iteration. Returns:T the next element in the iteration Annotations @SuppressWarnings:unchecked @Override

back to summary

public T next()

Implements java.util.Iterator.next.

Doc from java.util.Iterator.next.

Returns the next element in the iteration.

Returns:T

the next element in the iteration

Annotations

@SuppressWarnings:unchecked
@Override

nextValue	back to summary
public T nextValue() throws IOException

readAll back to summary

readAll	back to summary
public List<T> readAll() throws IOException Convenience method for reading all entries accessible via this iterator; resulting container will be a `java.util.ArrayList`. Returns:List<T> List of entries read

public List<T> readAll() throws IOException

Convenience method for reading all entries accessible via this iterator; resulting container will be a java.util.ArrayList.

Returns:List<T>: List of entries read

readAll	back to summary
public <L extends List<? super T>> L readAll(L resultList) throws IOException Convenience method for reading all entries accessible via this iterator Returns:L List of entries read (same as passed-in argument)

readAll

back to summary

public <L extends List<? super T>> L readAll(L resultList) throws IOException

Convenience method for reading all entries accessible via this iterator

Returns:L: List of entries read (same as passed-in argument)

readAll	back to summary
public <C extends Collection<? super T>> C readAll(C results) throws IOException Convenience method for reading all entries accessible via this iterator

remove back to summary

remove	back to summary
public void remove() Overrides default java.util.Iterator.remove. Doc from java.util.Iterator.remove. Removes from the underlying collection the last element returned by this iterator (optional operation). This method can be called only once per call to `next`. The behavior of an iterator is unspecified if the underlying collection is modified while the iteration is in progress in any way other than by calling this method, unless an overriding class has specified a concurrent modification policy. The behavior of an iterator is unspecified if this method is called after a call to the `forEachRemaining` method. Annotations @Override

public void remove()

Overrides default java.util.Iterator.remove.

Doc from java.util.Iterator.remove.

Removes from the underlying collection the last element returned by this iterator (optional operation). This method can be called only once per call to next.

The behavior of an iterator is unspecified if the underlying collection is modified while the iteration is in progress in any way other than by calling this method, unless an overriding class has specified a concurrent modification policy.

The behavior of an iterator is unspecified if this method is called after a call to the forEachRemaining method.

Annotations

@Override

public Class ValueIterator<T>

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail