org.mule.runtime.core.internal.streaming.object.iterator

Class AbstractConsumer<T,P>

java.lang.Object

org.mule.runtime.core.internal.streaming.object.iterator.AbstractConsumer<T,P>

Type Parameters:

T - the type that the consumer will return

P - the type that the producer generates

All Implemented Interfaces:

Closeable, AutoCloseable, org.mule.runtime.api.streaming.HasSize, Consumer<T>

Direct Known Subclasses:

ListConsumer, SimpleConsumer

public abstract class AbstractConsumer<T,P>
extends Object
implements Consumer<T>

Base implementation of Consumer. This template class takes care of the contract's subtleties like returning fast when closed and throwing the correct types of exceptions

Since:

3.5.0

Field Summary

Fields

Modifier and Type	Field and Description
protected Producer<P>	producer

Constructor Summary

Constructors

Constructor and Description
AbstractConsumer(Producer<P> producer)

Method Summary

Modifier and Type	Method and Description
protected abstract boolean	checkConsumed() Implement this method to actualy check for the Producer being fully consumed without worrying about it being closed or throwing any exceptions
void	close()
T	consume() Retrieves the next available item.
protected abstract T	doConsume() Implement this method to actually consume the producer without worrying about exception types or checking fo this consumer to be closed.
int	getSize()
boolean	isConsumed() Returns true if no more items are available or if the consumer was closed.

Methods inherited from class java.lang.Object

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

Field Detail

producer

protected final Producer<P> producer

Constructor Detail

AbstractConsumer

public AbstractConsumer(Producer<P> producer)

Method Detail

doConsume

protected abstract T doConsume()
                        throws NoSuchElementException

Implement this method to actually consume the producer without worrying about exception types or checking fo this consumer to be closed. If the producer is consumed then simply return null

Returns:

a new item or null

Throws:

NoSuchElementException

checkConsumed

protected abstract boolean checkConsumed()

Implement this method to actualy check for the Producer being fully consumed without worrying about it being closed or throwing any exceptions

Returns:

whether the Producer has been consumed or not

consume

public final T consume()
                throws NoSuchElementException

Retrieves the next available item.

Specified by:

consume in interface Consumer<T>

Returns:

an object of type T if available. null otherwise

Throws:

NoSuchElementException

isConsumed

public final boolean isConsumed()

Returns true if no more items are available or if the consumer was closed. When this method returns true, implementors of this class are require to invoke the Closeable.close() method before returning in order to release resources as quickly as possible. Users of this component who no longer need this require before it is fully consumed are also required to close it.

Specified by:

isConsumed in interface Consumer<T>

Returns:

true if no more items are available. false otherwise

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

getSize

public int getSize()

Specified by:

getSize in interface org.mule.runtime.api.streaming.HasSize