public static enum RecordCursor.NoNextReason extends Enum<RecordCursor.NoNextReason>
RecordCursor.hasNext()
returned false
.Enum Constant and Description |
---|
BYTE_LIMIT_REACHED
The limit on the number of bytes to scan was reached.
|
RETURN_LIMIT_REACHED
The limit on the number record to return was reached.
|
SCAN_LIMIT_REACHED
The limit on the number of records to scan was reached.
|
SOURCE_EXHAUSTED
The underlying scan, irrespective of any limit, has reached the end.
|
TIME_LIMIT_REACHED
The limit on the amount of time that a scan can take was reached.
|
Modifier and Type | Method and Description |
---|---|
boolean |
isLimitReached()
Does this reason indicate that some limit was reached?
This includes both the in-band returned row limit and the out-of-band time and other resource limits.
|
boolean |
isOutOfBand()
Does this reason represent an out-of-band (that is, not solely dependent on the records returned) completion?
In general, when an out-of-band reason is encountered, the entire cursor tree unwinds and returns to the
client to start over fresh with a new cursor.
|
boolean |
isSourceExhausted()
Does this reason indicate that there is no more data available?
These are the cases in which
RecordCursor.getContinuation() would return null . |
static RecordCursor.NoNextReason |
valueOf(String name)
Returns the enum constant of this type with the specified name.
|
static RecordCursor.NoNextReason[] |
values()
Returns an array containing the constants of this enum type, in
the order they are declared.
|
public static final RecordCursor.NoNextReason SOURCE_EXHAUSTED
RecordCursor.getContinuation()
should return null
.public static final RecordCursor.NoNextReason RETURN_LIMIT_REACHED
ExecuteProperties.setReturnedRowLimit(int)
of by an implicit
limit based on a predicate for continuing, as in MapWhileCursor
.
RecordCursor.getContinuation()
may return a continuation for after the requested limit.public static final RecordCursor.NoNextReason TIME_LIMIT_REACHED
RecordCursor.getContinuation()
may return a continuation for resuming the scan.
Note that is it possible for TIME_LIMIT_REACHED
to be returned before
any actual records if a complex scan takes a lot of work to reach the requested records,
such as a query that does filtering.public static final RecordCursor.NoNextReason SCAN_LIMIT_REACHED
RecordCursor.getContinuation()
may return a continuation for resuming the scan.
Note that it is possible for SCAN_LIMIT_REACHED
to be returned before any actual records if
a scan retrieves many records that are discarded, such as by a filter or type filter.public static final RecordCursor.NoNextReason BYTE_LIMIT_REACHED
RecordCursor.getContinuation()
may return a continuation for resuming the scan.
Note that it is possible for BYTE_LIMIT_REACHED
to be returned before any actual records if
a scan retrieves many bytes for records that are discarded, such as by a filter or type filter.public static RecordCursor.NoNextReason[] values()
for (RecordCursor.NoNextReason c : RecordCursor.NoNextReason.values()) System.out.println(c);
public static RecordCursor.NoNextReason valueOf(String name)
name
- the name of the enum constant to be returned.IllegalArgumentException
- if this enum type has no constant with the specified nameNullPointerException
- if the argument is nullpublic boolean isOutOfBand()
true
if this cursor stopped earlypublic boolean isSourceExhausted()
RecordCursor.getContinuation()
would return null
.true
if the source of this cursor is completely exhausted and no completion is possiblepublic boolean isLimitReached()
true
if this cursor stopped due to any kind of limit being reached