com.puresoltechnologies.streaming.AbstractIterator Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of streaming Show documentation

The newest version!

package com.puresoltechnologies.streaming;

import java.util.Iterator;
import java.util.NoSuchElementException;

/**
 * This is an abstract implementation of an iterator to be used as base class
 * for complex iterators to assure the {@link Iterator} contract.
 * 
 * @author Rick-Rainer Ludwig
 *
 * @param 
 *            is the element type of the iterator.
 */
public abstract class AbstractIterator implements Iterator, PeekingIterator {

    private T next = null;

    /**
     * This method looks for the next entry to be returned. If no further entry
     * is found, null is returned.
     * 
     * @return An object of T is returned representing the next entry to be
     *         returned by the iterator. null is returned in case
     *         no more entries are available.
     */
    protected abstract T findNext();

    @Override
    public final boolean hasNext() {
	if (next == null) {
	    next = findNext();
	}
	return next != null;
    }

    @Override
    public final T next() {
	if (!hasNext()) {
	    throw new NoSuchElementException("No more elements in this iterator.");
	}
	T result = next;
	next = null;
	return result;
    }

    @Override
    public final T peek() {
	if (!hasNext()) {
	    throw new NoSuchElementException("No more elements in this iterator.");
	}
	return next;
    }

}