org.jpc.query

Class CursorAdapter<AdaptedType,AdapteeType>

java.lang.Object

org.jpc.query.Cursor<AdaptedType>

org.jpc.query.CursorAdapter<AdaptedType,AdapteeType>

All Implemented Interfaces:

AutoCloseable, Iterator<AdaptedType>

public class CursorAdapter<AdaptedType,AdapteeType>
extends Cursor<AdaptedType>

Constructor Summary

Constructors

Constructor and Description
CursorAdapter(Cursor<AdapteeType> cursor)
CursorAdapter(Cursor<AdapteeType> cursor, com.google.common.base.Function<AdapteeType,AdaptedType> adapterFunction)

Method Summary

Modifier and Type	Method and Description
protected void	basicAbort()
protected List<AdaptedType>	basicAllSolutions() The adaptee cursor could have optimized its basicAllSolutions method.
protected void	basicClose()
protected AdaptedType	basicNext() Returns the next available element in the cursor.
protected AdaptedType	basicOneSolutionOrThrow() The adaptee cursor could have optimized its basicOneSolution method.
boolean	isAbortable()

Methods inherited from class org.jpc.query.Cursor

abort, adapt, allSolutions, basicSolutionsRange, cachedNext, close, filter, finalize, getState, hasNext, hasSolution, isExhausted, isOpen, isReady, iterativeAllSolutions, next, nonSynchronizedClose, nSolutions, numberOfSolutions, oneSolution, oneSolutionOrThrow, remove, setState, solutionsRange

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface java.util.Iterator

forEachRemaining

Constructor Detail

CursorAdapter

public CursorAdapter(Cursor<AdapteeType> cursor)

CursorAdapter

public CursorAdapter(Cursor<AdapteeType> cursor,
                     com.google.common.base.Function<AdapteeType,AdaptedType> adapterFunction)

Method Detail

isAbortable

public boolean isAbortable()

Specified by:

isAbortable in class Cursor<AdaptedType>

basicOneSolutionOrThrow

protected AdaptedType basicOneSolutionOrThrow()

The adaptee cursor could have optimized its basicOneSolution method. For example, a deterministic query can only open a cursor (i.e., with invocations to hasNext() and next()) bringing eagerly all the results. Therefore, this method overrides the default implementation of basicOneSolution() that makes use of hasNext() and next() and prefers to use whatever mechanism is implemented by the adaptee cursor for bringing one solution.

Overrides:

basicOneSolutionOrThrow in class Cursor<AdaptedType>

basicAllSolutions

protected List<AdaptedType> basicAllSolutions()

The adaptee cursor could have optimized its basicAllSolutions method. For example, it could have brought all the results at once instead of lazily asking for them. Therefore, this method is overridden to profit from such optimization if existing

Overrides:

basicAllSolutions in class Cursor<AdaptedType>

Returns:

a list with all solutions.

basicAbort

protected void basicAbort()

Specified by:

basicAbort in class Cursor<AdaptedType>

basicClose

protected void basicClose()

Specified by:

basicClose in class Cursor<AdaptedType>

basicNext

protected AdaptedType basicNext()

Description copied from class: Cursor

Returns the next available element in the cursor. If the cursor is exhausted it should throw a NoSuchElementException the first time it is invoked. Its behavior is undetermined if invoked more than once after the cursor has been exhausted.

Specified by:

basicNext in class Cursor<AdaptedType>

Returns: