com.arangodb

Interface ArangoCursor<T>

All Superinterfaces:

ArangoIterable<T>, ArangoIterator<T>, AutoCloseable, Closeable, Iterable<T>, Iterator<T>

All Known Subinterfaces:

ArangoCursorAsync<T>

All Known Implementing Classes:

ArangoCursorAsyncImpl, ArangoCursorImpl

public interface ArangoCursor<T>
extends ArangoIterable<T>, ArangoIterator<T>, Closeable

Author:

Mark Vollmary

Method Summary

Modifier and Type	Method and Description
List<T>	asListRemaining()
Integer	getCount()
String	getId()
String	getNextBatchId()
CursorEntity.Stats	getStats()
Class<T>	getType()
Collection<CursorEntity.Warning>	getWarnings()
boolean	isCached()
boolean	isPotentialDirtyRead()
T	next() Returns the next element in the iteration.

Methods inherited from interface com.arangodb.ArangoIterable

allMatch, anyMatch, collectInto, count, filter, first, foreach, iterator, map, noneMatch, stream

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Methods inherited from interface java.util.Iterator

forEachRemaining, hasNext, remove

Methods inherited from interface java.io.Closeable

close

Method Detail

getId

String getId()

Returns:

id of temporary cursor created on the server

getType

Class<T> getType()

Returns:

the type of the result elements

getCount

Integer getCount()

Returns:

the total number of result documents available (only available if the query was executed with the count attribute set)

getStats

CursorEntity.Stats getStats()

Returns:

extra information about the query result. For data-modification queries, the stats will contain the number of modified documents and the number of documents that could not be modified due to an error (if ignoreErrors query option is specified)

getWarnings

Collection<CursorEntity.Warning> getWarnings()

Returns:

warnings which the query could have been produced

isCached

boolean isCached()

Returns:

indicating whether the query result was served from the query cache or not

asListRemaining

List<T> asListRemaining()

Returns:

the remaining results as a List

isPotentialDirtyRead

boolean isPotentialDirtyRead()

Returns:

true if the result is a potential dirty read

Since:

ArangoDB 3.10

getNextBatchId

String getNextBatchId()

Returns:

The ID of the batch after the current one. The first batch has an ID of 1 and the value is incremented by 1 with every batch. Only set if the allowRetry query option is enabled.

Since:

ArangoDB 3.11

next

T next()

Returns the next element in the iteration.

If the cursor allows retries (see AqlQueryOptions.allowRetry(Boolean)), then it is safe to retry invoking this method in case of I/O exceptions (which are actually thrown as ArangoDBException with cause IOException).

If the cursor does not allow retries (default), then it is not safe to retry invoking this method in case of I/O exceptions, since the request to fetch the next batch is not idempotent (i.e. the cursor may advance multiple times on the server).

Specified by:

next in interface Iterator<T>

Returns:

the next element in the iteration

Throws:

NoSuchElementException - if the iteration has no more elements