Package com.mastfrog.util.builder

Class AbstractBuilder<ElementType,CreateType>

java.lang.Object

com.mastfrog.util.builder.AbstractBuilder<ElementType,CreateType>

All Implemented Interfaces:

Builder<ElementType,CreateType,AbstractBuilder<ElementType,CreateType>>

Direct Known Subclasses:

URLBuilder

public abstract class AbstractBuilder<ElementType,CreateType>
extends Object
implements Builder<ElementType,CreateType,AbstractBuilder<ElementType,CreateType>>

A basic implementation of the builder pattern. Mutable factory for some immutable object which is composed of multiple objects of the same type.

Author:

Tim Boudreau

Field Summary

Fields

Modifier and Type	Field	Description
protected final List<ElementType>	elements

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	AbstractBuilder()

Method Summary

Modifier and Type	Method	Description
AbstractBuilder<ElementType,CreateType>	add(ElementType element)	Add an element
final AbstractBuilder<ElementType,CreateType>	add(String string)	Add an element as a string.
protected AbstractBuilder<ElementType,CreateType>	addElement(ElementType element)
protected abstract ElementType	createElement(String string)
protected List<ElementType>	elements()
protected void	onAfterAdd(ElementType element)
protected void	onBeforeAdd(ElementType toAdd)	Hook which can be overridden when an element is added.
protected int	size()

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.mastfrog.util.builder.Builder

build, create

Field Details

elements

protected final List<ElementType> elements

Constructor Details

AbstractBuilder

protected AbstractBuilder()

Method Details

add

public AbstractBuilder<ElementType,CreateType> add(ElementType element)

Description copied from interface: Builder

Add an element

May throw an exception if called after create() has been called.

Specified by:

add in interface Builder<ElementType,CreateType,AbstractBuilder<ElementType,CreateType>>

Parameters:

element - The element

Returns:

this, or a new builder (callers should not assume all implementations return this)

onAfterAdd

protected void onAfterAdd(ElementType element)

add

public final AbstractBuilder<ElementType,CreateType> add(String string)

Description copied from interface: Builder

Add an element as a string. Optional operation, may throw UnsupportedOperationException.

May throw an exception if called after create() has been called.

Specified by:

add in interface Builder<ElementType,CreateType,AbstractBuilder<ElementType,CreateType>>

Returns:

this, or a new builder (callers should not assume all implementations return this)

elements

protected List<ElementType> elements()

addElement

protected AbstractBuilder<ElementType,CreateType> addElement(ElementType element)

size

protected int size()

createElement

protected abstract ElementType createElement(String string)

onBeforeAdd

protected void onBeforeAdd(ElementType toAdd)

Hook which can be overridden when an element is added.

Parameters:

toAdd -