Class RangeIntersectionIterator.BounceIntersectionIterator<K extends Comparable<K>,D extends CombinedValue<K>>
java.lang.Object
org.apache.cassandra.utils.AbstractGuavaIterator<T>
org.apache.cassandra.index.sasi.utils.RangeIterator<K,D>
org.apache.cassandra.index.sasi.utils.RangeIntersectionIterator.BounceIntersectionIterator<K,D>
- Type Parameters:
K- The type used to sort ranges.D- The container type which is going to be returned byIterator.next().
- All Implemented Interfaces:
com.google.common.collect.PeekingIterator<D>,Closeable,AutoCloseable,Iterator<D>
- Enclosing class:
- RangeIntersectionIterator
protected static class RangeIntersectionIterator.BounceIntersectionIterator<K extends Comparable<K>,D extends CombinedValue<K>>
extends RangeIterator<K,D>
Iterator which performs intersection of multiple ranges by using bouncing (merge-join) technique to identify
common elements in the given ranges. Aforementioned "bounce" works as follows: range queue is poll'ed for the
range with the smallest current token (main loop), that token is used to
RangeIterator.skipTo(Comparable)
other ranges, if token produced by RangeIterator.skipTo(Comparable) is equal to current "candidate" token,
both get merged together and the same operation is repeated for next range from the queue, if returned token
is not equal than candidate, candidate's range gets put back into the queue and the main loop gets repeated until
next intersection token is found or at least one iterator runs out of tokens.
This technique is every efficient to jump over gaps in the ranges.-
Nested Class Summary
Nested classes/interfaces inherited from class org.apache.cassandra.index.sasi.utils.RangeIterator
RangeIterator.Builder<K extends Comparable<K>,D extends CombinedValue<K>> Nested classes/interfaces inherited from class org.apache.cassandra.utils.AbstractGuavaIterator
AbstractGuavaIterator.State -
Field Summary
FieldsFields inherited from class org.apache.cassandra.utils.AbstractGuavaIterator
next, state -
Method Summary
Modifier and TypeMethodDescriptionvoidclose()protected DReturns the next element.protected voidperformSkipTo(K nextToken) Methods inherited from class org.apache.cassandra.index.sasi.utils.RangeIterator
getCount, getCurrent, getMaximum, getMinimum, isOverlapping, isOverlapping, recomputeNext, skipTo, tryToComputeNextMethods inherited from class org.apache.cassandra.utils.AbstractGuavaIterator
endOfData, hasNext, next, peek, removeMethods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitMethods inherited from interface java.util.Iterator
forEachRemaining
-
Field Details
-
ranges
protected final PriorityQueue<RangeIterator<K extends Comparable<K>,D extends CombinedValue<K>>> ranges
-
-
Method Details
-
computeNext
Description copied from class:AbstractGuavaIteratorReturns the next element. Note: the implementation must callAbstractGuavaIterator.endOfData()when there are no elements left in the iteration. Failure to do so could result in an infinite loop.The initial invocation of
AbstractGuavaIterator.hasNext()orAbstractGuavaIterator.next()calls this method, as does the first invocation ofhasNextornextfollowing each successful call tonext. Once the implementation either invokesendOfDataor throws an exception,computeNextis guaranteed to never be called again.If this method throws an exception, it will propagate outward to the
hasNextornextinvocation that invoked this method. Any further attempts to use the iterator will result in anIllegalStateException.The implementation of this method may not invoke the
hasNext,next, orAbstractGuavaIterator.peek()methods on this instance; if it does, anIllegalStateExceptionwill result.- Specified by:
computeNextin classAbstractGuavaIterator<D extends CombinedValue<K>>- Returns:
- the next element if there was one. If
endOfDatawas called during execution, the return value will be ignored.
-
performSkipTo
- Specified by:
performSkipToin classRangeIterator<K extends Comparable<K>,D extends CombinedValue<K>>
-
close
- Throws:
IOException
-