edu.rice.hj.continuation

Class CoIterator<E>

java.lang.Object

edu.rice.hj.continuation.CoIterator<E>

Type Parameters:

E - the element class that the Iterator returns

All Implemented Interfaces:

Iterator<E>

public abstract class CoIterator<E>
extends Object
implements Iterator<E>

A Coroutine based iterator

Author:

Matthias Mann

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	CoIterator()

Method Summary

Modifier and Type	Method and Description
boolean	hasNext()
E	next()
protected void	produce(E element) Produces the next value to be returned by the next() method.
void	remove() Always throws UnsupportedOperationException.
protected abstract void	run() This is the body of the Iterator.

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.Iterator

forEachRemaining

Constructor Detail

CoIterator

protected CoIterator()

Method Detail

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()
            throws UnsupportedOperationException

Always throws UnsupportedOperationException.

Specified by:

remove in interface Iterator<E>

Throws:

UnsupportedOperationException - always

produce

protected void produce(E element)
                throws SuspendableException

Produces the next value to be returned by the next() method.

Parameters:

element - The value that should be returned by next()

Throws:

SuspendableException - This method will suspend the execution

run

protected abstract void run()
                     throws SuspendableException

This is the body of the Iterator. This method is executed as a Coroutine to produce(E) the values of the Iterator.

Note that this method is suspended each time it calls produce. And if the consumer does not consume all values of the Iterator then this method does not get the change to finish it's execution. This also includes the finally blocks.

This method must only suspend by calling produce. Any other reason for suspension will cause a busy loop in the Iterator.

Throws:

SuspendableException