org.nuxeo.ecm.core.api
Interface IterableQueryResult

All Superinterfaces:

Iterable<Map<String,Serializable>>

All Known Implementing Classes:

ResultSetQueryResult

public interface IterableQueryResult
extends Iterable<Map<String,Serializable>>

An iterable query result based on a cursor.

The close() method MUST be called when the query result is no more needed, otherwise underlying resources will be leaked. There is no auto-closing at the end of the iteration.

Method Summary

void	close() Closes the query result and releases the underlying resources held by the cursor.
long	pos() Gets the current position in the iterator.
long	size() Gets the total size of the query result.
void	skipTo(long pos) Skips to a given position in the iterator.

Methods inherited from interface java.lang.Iterable

iterator

Method Detail

close

void close()

Closes the query result and releases the underlying resources held by the cursor.

This MUST be called when the query result is no more needed, otherwise underlying resources will be leaked. There is no auto-closing at the end of the iteration.

size

long size()

Gets the total size of the query result.

Note that this may be costly, and that some backends may not be able to do this operation, in which case -1 will be returned.

Returns:

the size, or -1 for an unknown size

pos

long pos()

Gets the current position in the iterator.

Positions start at 0.

Returns:

the position

skipTo

void skipTo(long pos)

Skips to a given position in the iterator.

Positions start at 0.