shiver.me.timbers.building

Interface Builder<T>

All Superinterfaces:

Iterable<T>

All Known Implementing Classes:

CollectionBuilder, IterableBuilder, QueueBuilder, StackBuilder

public interface Builder<T>
extends Iterable<T>

Build up operations by adding Blocks that can then be built.

Author:

Karl Bennett

Method Summary

Methods

Modifier and Type	Method and Description
Builder<T>	add(Block<T> block) Add a new Block to be built.
T	build() Build all the blocks into a final result.
boolean	isEmpty()
Iterable<T>	iterable(int iterations) Creates an iterable for this builder that will iterate the supplied number of times.

Methods inherited from interface java.lang.Iterable

iterator

Method Detail

add

Builder<T> add(Block<T> block)

Add a new Block to be built.

isEmpty

boolean isEmpty()

Returns:

true if no blocks have been added, otherwise false.

build

T build()

Build all the blocks into a final result.

iterable

Iterable<T> iterable(int iterations)

Creates an iterable for this builder that will iterate the supplied number of times.

If the supplied number of iterations is less than the number of Blocks then only that number of blocks will be built and have their results returned.

If the supplied number of iterations is greater than the number of Blocks then all blocks will be built and the final result of the built Blocks will be passed back into the first Block where they will be iterated through again until the supplied number of iterations is reached.