StandardExpressionBuilder (Evaluating Software Design Patterns

Overview

Package

Class

Use

Tree

Index

Help

Evaluating Software Design Patterns
— the "Gang of Four" patterns implemented in Java 6

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

dk.rode.thesis.builder
Class StandardExpressionBuilder<E>

java.lang.Object
  dk.rode.thesis.builder.AbstractExpressionBuilder<E>
      dk.rode.thesis.builder.StandardExpressionBuilder<E>


Type Parameters:: E - The type of value the evaluation of constructed expressions produces.

All Implemented Interfaces:: ExpressionBuilder<E>, Copyable<ExpressionBuilder<E>>, StrictCopyable<ExpressionBuilder<E>>

Direct Known Subclasses:: CountingExpressionBuilder, StandardComparableExpressionBuilder

@Participant(value="ConcreteBuilder") public class StandardExpressionBuilder<E>
extends AbstractExpressionBuilder<E>
implements ExpressionBuilder<E>
extends AbstractExpressionBuilder<E>
implements ExpressionBuilder<E>

A standard expression builder construct various Expression types having no bounds on the values produced by constructed expressions.

The constructed terminal expressions will all manipulate the same sequence instance.

A standard expression builder uses a context to register all unique instances of constructed variables and store all created constants.

Implementation notes:
This builder does not use covariant return types to comply with the canonical "Gang of Four" examples, but the TypedExpressionBuilder class does use covariant return types.

Author:: Gunni Rode / rode.dk
See Also:: ComparableExpressionBuilder

Field Summary

Fields inherited from class dk.rode.thesis.builder.AbstractExpressionBuilder
`context, root, sequence`

Constructor Summary
`StandardExpressionBuilder(Context context, Sequence<? extends E> sequence)` Constructor.
`StandardExpressionBuilder(Sequence<? extends E> sequence)` Constructor.
`StandardExpressionBuilder(StandardExpressionBuilder<E> builder)` Copy constructor.

Method Summary
`Expression<Boolean>`	`buildAndExpression(Expression<Boolean> first, Expression<Boolean> second)` Builds a new short-circuit AND expression.
`Expression<E>`	`buildAssignmentExpression(VariableExpression<E> variable, Expression<? extends E> expression)` Builds a new ASSIGNMENT expression.
`Expression<E>`	`buildBreakExpression(TypedExpression<E> expression)` Builds a new BREAK expression.
`Expression<E>`	`buildConditionalExpression(Expression<Boolean> condition, Expression<? extends E> first, Expression<? extends E> second)` Builds a new CONDITIONAL expression.
`Expression<E>`	`buildCurrentExpression()` Builds a new CURRENT expression.
`Expression<Boolean>`	`buildEqualExpression(Expression<?> first, Expression<?> second)` Builds a new EQUAL expression.
`FlowExpression<E>`	`buildFlowExpression()` Builds a new `uninitialised` FLOW expression.
`Expression<E>`	`buildInitialisedFlowExpression(Expression<? extends E>... expressions)` Builds a new `initialised` FLOW expression.
`Expression<E>`	`buildNextExpression(Expression<? extends Number> count)` Builds a new NEXT expression.
`Expression<Boolean>`	`buildNonShortCircuitAndExpression(Expression<Boolean> first, Expression<Boolean> second)` Builds a new non short-circuit AND expression.
`Expression<Boolean>`	`buildNonShortCircuitOrExpression(Expression<Boolean> first, Expression<Boolean> second)` Builds a new non short-circuit OR expression.
`Expression<Boolean>`	`buildNotExpression(Expression<Boolean> expression)` Builds a new NOT expression.
`Expression<Boolean>`	`buildOrExpression(Expression<Boolean> first, Expression<Boolean> second)` Builds a new short-circuit OR expression.
`Expression<E>`	`buildResetExpression()` Builds a new RESET expression.
`Expression<Boolean>`	`buildReverseExpression(Expression<Boolean> reverse)` Builds a new REVERSE expression.
`StandardExpressionBuilder<E>`	`copy()` Returns a deep copy of this object.

Methods inherited from class dk.rode.thesis.builder.AbstractExpressionBuilder
`buildConstantExpression, buildExpression, buildVariableExpression, equals, getContext, getRootExpression, getSequence, hashCode, initialiseExpressions, toString`

Methods inherited from class java.lang.Object
`clone, finalize, getClass, notify, notifyAll, wait, wait, wait`

Methods inherited from interface dk.rode.thesis.builder.ExpressionBuilder
`buildConstantExpression, buildExpression, buildVariableExpression, getRootExpression, getSequence`

Constructor Detail

StandardExpressionBuilder

public StandardExpressionBuilder(Context context,
                                 Sequence<? extends E> sequence)

Constructor.

The context supplied as context is used to register created variables and store constants.

Parameters:: context - The context to use; cannot be null.; sequence - The sequence to be manipulated by constructed terminal expressions; cannot be null.
Throws:: NullPointerException - If either argument is null.
See Also:: AbstractExpressionBuilder.getContext()

StandardExpressionBuilder

public StandardExpressionBuilder(Sequence<? extends E> sequence)

Constructor.

A local context is used to register created variables and store constants.

Parameters:: sequence - The sequence to be manipulated by constructed terminal expressions; cannot be null.
Throws:: NullPointerException - If sequence is null.
See Also:: AbstractExpressionBuilder.getContext()

StandardExpressionBuilder

public StandardExpressionBuilder(StandardExpressionBuilder<E> builder)

Copy constructor.

The same context and sequence as used by builder will be used by this builder.

The root expression from builder is not copied. Hence, this builder is ready to construct new expressions, and return a unique root expression from AbstractExpressionBuilder.getRootExpression().

Parameters:: builder - The builder to copy; cannot be null.
Throws:: NullPointerException - If builder is null.

Method Detail