Class JsonEnumerator
- All Implemented Interfaces:
AutoCloseable,Enumerator<@Nullable Object[]>
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidclose()Closes this enumerable and releases resources.Object[]current()Gets the current element in the collection.booleanmoveNext()Advances the enumerator to the next element of the collection.voidreset()Sets the enumerator to its initial position, which is before the first element in the collection.
-
Constructor Details
-
JsonEnumerator
-
-
Method Details
-
current
Description copied from interface:EnumeratorGets the current element in the collection.After an enumerator is created or after the
Enumerator.reset()method is called, theEnumerator.moveNext()method must be called to advance the enumerator to the first element of the collection before reading the value of thecurrentproperty; otherwise,currentis undefined.This method also throws
NoSuchElementExceptionif the last call tomoveNextreturnedfalse, which indicates the end of the collection.This method does not move the position of the enumerator, and consecutive calls to
currentreturn the same object until eithermoveNextorresetis called.An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated. The next call to
moveNextorresetmay, at the discretion of the implementation, throw aConcurrentModificationException. If the collection is modified betweenmoveNextandcurrent,currentreturns the element that it is set to, even if the enumerator is already invalidated.- Specified by:
currentin interfaceEnumerator<@Nullable Object[]>- Returns:
- Current element
-
moveNext
public boolean moveNext()Description copied from interface:EnumeratorAdvances the enumerator to the next element of the collection.After an enumerator is created or after the
resetmethod is called, an enumerator is positioned before the first element of the collection, and the first call to themoveNextmethod moves the enumerator over the first element of the collection.If
moveNextpasses the end of the collection, the enumerator is positioned after the last element in the collection andmoveNextreturnsfalse. When the enumerator is at this position, subsequent calls tomoveNextalso returnfalseuntil#resetis called.An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated. The next call to
moveNextorEnumerator.reset()may, at the discretion of the implementation, throw aConcurrentModificationException.- Specified by:
moveNextin interfaceEnumerator<@Nullable Object[]>- Returns:
trueif the enumerator was successfully advanced to the next element;falseif the enumerator has passed the end of the collection
-
reset
public void reset()Description copied from interface:EnumeratorSets the enumerator to its initial position, which is before the first element in the collection.An enumerator remains valid as long as the collection remains unchanged. If changes are made to the collection, such as adding, modifying, or deleting elements, the enumerator is irrecoverably invalidated. The next call to
Enumerator.moveNext()orresetmay, at the discretion of the implementation, throw aConcurrentModificationException.This method is optional; it may throw
UnsupportedOperationException.Notes to Implementers
All calls to Reset must result in the same state for the enumerator. The preferred implementation is to move the enumerator to the beginning of the collection, before the first element. This invalidates the enumerator if the collection has been modified since the enumerator was created, which is consistent with
Enumerator.moveNext()andEnumerator.current().- Specified by:
resetin interfaceEnumerator<@Nullable Object[]>
-
close
public void close()Description copied from interface:EnumeratorCloses this enumerable and releases resources.This method is idempotent. Calling it multiple times has the same effect as calling it once.
- Specified by:
closein interfaceAutoCloseable- Specified by:
closein interfaceEnumerator<@Nullable Object[]>
-