de.team33.patterns.building.elara

Class Charger<T,B extends Charger<T,B>>

java.lang.Object

de.team33.patterns.building.elara.BuilderBase<B>

de.team33.patterns.building.elara.Charger<T,B>

Type Parameters:

T - The target type: an instance of that type is associated with the builder instance to hold the data to be collected during the build process. That type is expected to be mutable, at least in the scope of the concrete builder implementation.

B - The builder type: the intended effective type of the concrete builder implementation.

All Implemented Interfaces:

Setup<T,B>

public class Charger<T,B extends Charger<T,B>>
extends BuilderBase<B>
implements Setup<T,B>

Serves as a base class for builder-like implementations <B> and as such provides a model that separates basic builder concepts from the actual target data model <T>.

This implementation can be used as a base if an instance of the target type should be associated with the builder instance from the start and also be used as the result of the build process.

An instance of this builder type is limited to single use. Once the terminating release() method has been used, subsequent calls to setup() throw an IllegalStateException.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Charger(T target, Class<B> builderClass) Initializes a new instance.

Method Summary

Modifier and Type	Method and Description
T	charged() Returns the associated target instance.
T	release() Deprecated. use charged() instead.
B	setup(Consumer<T> consumer) Accepts a Consumer as modifying operation to be performed on a target instance immediately or no later than the final build() operation and returns the builder instance itself.

Methods inherited from class de.team33.patterns.building.elara.BuilderBase

THIS

Methods inherited from class java.lang.Object

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

Constructor Detail

Charger

protected Charger(T target,
                  Class<B> builderClass)

Initializes a new instance.

Parameters:

target - The target instance to be associated with the builder. The implementation assumes that it is exclusively available to the builder for the course of the build process.

builderClass - The Class representation of the intended effective builder type.

Throws:

IllegalArgumentException - if the specified builder class does not represent the instance to create.

Method Detail

setup

public final B setup(Consumer<T> consumer)

Accepts a Consumer as modifying operation to be performed on a target instance immediately or no later than the final build() operation and returns the builder instance itself.

This implementation applies the given consumer directly to the associated target.

Specified by:

setup in interface Setup<T,B extends Charger<T,B>>

charged

public final T charged()

Returns the associated target instance.

Subsequent calls of setup(Consumer) will lead to an IllegalStateException.

release

@Deprecated
public final T release()

Deprecated. use charged() instead.