org.apache.commons.functor.generator
Interface Generator<E>

All Known Implementing Classes:

BaseGenerator, FilteredGenerator, GenerateUntil, GenerateWhile, IntegerRange, IteratorToGeneratorAdapter, LongRange, TransformedGenerator, UntilGenerate, WhileGenerate

public interface Generator<E>

The Generator interface defines a number of useful actions applying UnaryFunctors to each in a series of argument Objects.

Version:

$Revision: 665786 $ $Date: 2008-06-09 12:17:39 -0500 (Mon, 09 Jun 2008) $

Author:

Jason Horman (jason@jhorman.org), Rodney Waldhoff

Method Summary

boolean	isStopped() Check if the generator is stopped.
void	run(UnaryProcedure<? super E> proc) Generators must implement this method.
void	stop() Stop the generator.
java.util.Collection<? super E>	to(java.util.Collection<? super E> collection) Same as to(new CollectionTransformer(collection)).
<Z> Z	to(UnaryFunction<Generator<? extends E>,? extends Z> transformer) Transforms this generator using the passed in transformer.
java.util.Collection<? super E>	toCollection() Same as to(new CollectionTransformer()).

Method Detail

run

void run(UnaryProcedure<? super E> proc)

Generators must implement this method.

Parameters:

proc - UnaryProcedure to run

stop

void stop()

Stop the generator. Will stop the wrapped generator if one was set.

isStopped

boolean isStopped()

Check if the generator is stopped.

Returns:

true if stopped

to

<Z> Z to(UnaryFunction<Generator<? extends E>,? extends Z> transformer)

Transforms this generator using the passed in transformer. An example transformer might turn the contents of the generator into a Collection of elements.

Parameters:

transformer - UnaryFunction to apply to this

Returns:

transformation result

to

java.util.Collection<? super E> to(java.util.Collection<? super E> collection)

Same as to(new CollectionTransformer(collection)).

Parameters:

collection - Collection to which my elements should be added

Returns:

collection

toCollection

java.util.Collection<? super E> toCollection()

Same as to(new CollectionTransformer()).

Returns:

Collection