com.bigdata.relation.accesspath

Class MultiSourceSequentialCloseableIterator<E>

java.lang.Object

com.bigdata.relation.accesspath.MultiSourceSequentialCloseableIterator<E>

All Implemented Interfaces:

IMultiSourceCloseableIterator<E>, ICloseable, ICloseableIterator<E>, Iterator<E>

public class MultiSourceSequentialCloseableIterator<E>
extends Object
implements IMultiSourceCloseableIterator<E>

Class allows new sources to be attached dynamically. If the existing sources are drained then the iterator will close() itself so that new sources can no longer be attached.

Version:

$Id$

Author:

Bryan Thompson

Constructor Summary

Constructors

Constructor and Description
MultiSourceSequentialCloseableIterator(ICloseableIterator<E> src)

Method Summary

Methods

Modifier and Type	Method and Description
boolean	add(ICloseableIterator<E> src) Add a source.
void	close() Closes the iterator, releasing any associated resources.
boolean	hasNext()
E	next()
void	remove()

Methods inherited from class java.lang.Object

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

Constructor Detail

MultiSourceSequentialCloseableIterator

public MultiSourceSequentialCloseableIterator(ICloseableIterator<E> src)

Method Detail

close

public void close()

Description copied from interface: ICloseableIterator

Closes the iterator, releasing any associated resources. This method MAY be invoked safely if the iterator is already closed. Implementations of this interface MUST invoke ICloseableIterator.close() if Iterator.hasNext() method returns false to ensure that the iterator is closed (and its resources release) as soon as it is exhausted.

Note: Implementations that support Iterator.remove() MUST NOT eagerly close the iterator when it is exhausted since that would make it impossible to remove the last visited statement. Instead they MUST wait for an explicit ICloseableIterator.close() by the application.

Specified by:

close in interface ICloseable

Specified by:

close in interface ICloseableIterator<E>

add

public boolean add(ICloseableIterator<E> src)

Description copied from interface: IMultiSourceCloseableIterator

Add a source. If the iterator already reports that it is closed then the new source can not be added and this method will return false.

Specified by:

add in interface IMultiSourceCloseableIterator<E>

Parameters:

src - The source.

Returns:

true iff the source could be added.

hasNext

public boolean hasNext()

Specified by:

hasNext in interface Iterator<E>

next

public E next()

Specified by:

next in interface Iterator<E>

remove

public void remove()

Specified by:

remove in interface Iterator<E>