org.springframework.webflow.engine.builder
Interface FlowBuilder

All Known Implementing Classes:

AbstractFlowBuilder, BaseFlowBuilder, XmlFlowBuilder

public interface FlowBuilder

Builder interface used to build a flow definition. The process of building a flow consists of the following steps:

1. Initialize this builder, creating the initial flow definition, by calling init(String, AttributeMap).
2. Call buildVariables() to create any variables of the flow and add them to the flow definition.
3. Call buildInputMapper() to create and set the input mapper for the flow.
4. Call buildStartActions() to create and add any start actions to the flow.
5. Call buildInlineFlows() to create any inline flows encapsulated by the flow and add them to the flow definition.
6. Call buildStates() to create the states of the flow and add them to the flow definition.
7. Call buildGlobalTransitions() to create the any transitions shared by all states of the flow and add them to the flow definition.
8. Call buildEndActions() to create and add any end actions to the flow.
9. Call buildOutputMapper() to create and set the output mapper for the flow.
10. Call buildExceptionHandlers() to create the exception handlers of the flow and add them to the flow definition.
11. Call getFlow() to return the fully-built Flow definition.
12. Dispose this builder, releasing any resources allocated during the building process by calling dispose().

Implementations should encapsulate flow construction logic, either for a specific kind of flow, for example, an OrderFlowBuilder built in Java code, or a generic flow builder strategy, like the XmlFlowBuilder, for building flows from an XML-definition.

Flow builders are used by the FlowAssembler, which acts as an assembler (director). Flow Builders may be reused, however, exercise caution when doing this as these objects are not thread safe. Also, for each use be sure to call init, followed by the build* methods, getFlow, and dispose completely in that order.

This is an example of the classic GoF builder pattern.

Author:

Keith Donald, Erwin Vervaet

See Also:

Flow, FlowAssembler, AbstractFlowBuilder, XmlFlowBuilder

Method Summary

void	buildEndActions() Builds any end actions to execute when the flow ends.
void	buildExceptionHandlers() Creates and adds all exception handlers to the flow built by this builder.
void	buildGlobalTransitions() Builds any transitions shared by all states of the flow.
void	buildInlineFlows() Builds any "in-line" flows encapsulated by the flow.
void	buildInputMapper() Builds the input mapper responsible for mapping flow input on start.
void	buildOutputMapper() Builds the output mapper responsible for mapping flow output on end.
void	buildStartActions() Builds any start actions to execute when the flow starts.
void	buildStates() Builds the states of the flow.
void	buildVariables() Builds any variables initialized by the flow when it starts.
void	dispose() Shutdown the builder, releasing any resources it holds.
Flow	getFlow() Get the fully constructed and configured Flow object - called by the builder's assembler (director) after assembly.
void	init(java.lang.String flowId, AttributeMap attributes) Initialize this builder.

Method Detail

init

void init(java.lang.String flowId,
          AttributeMap attributes)
          throws FlowBuilderException

Initialize this builder. This could cause the builder to open a stream to an externalized resource representing the flow definition, for example.

Parameters:

flowId - the identifier to assign to the flow

attributes - custom attributes to assign to the flow

Throws:

FlowBuilderException - an exception occured building the flow

buildVariables

void buildVariables()
                    throws FlowBuilderException

Builds any variables initialized by the flow when it starts.

Throws:

FlowBuilderException - an exception occured building the flow

buildInputMapper

void buildInputMapper()
                      throws FlowBuilderException

Builds the input mapper responsible for mapping flow input on start.

Throws:

FlowBuilderException - an exception occured building the flow

buildStartActions

void buildStartActions()
                       throws FlowBuilderException

Builds any start actions to execute when the flow starts.

Throws:

FlowBuilderException - an exception occured building the flow

buildInlineFlows

void buildInlineFlows()
                      throws FlowBuilderException

Builds any "in-line" flows encapsulated by the flow.

Throws:

FlowBuilderException - an exception occured building the flow

buildStates

void buildStates()
                 throws FlowBuilderException

Builds the states of the flow.

Throws:

FlowBuilderException - an exception occured building the flow

buildGlobalTransitions

void buildGlobalTransitions()
                            throws FlowBuilderException

Builds any transitions shared by all states of the flow.

Throws:

FlowBuilderException - an exception occured building the flow

buildEndActions

void buildEndActions()
                     throws FlowBuilderException

Builds any end actions to execute when the flow ends.

Throws:

FlowBuilderException - an exception occured building the flow

buildOutputMapper

void buildOutputMapper()
                       throws FlowBuilderException

Builds the output mapper responsible for mapping flow output on end.

Throws:

FlowBuilderException - an exception occured building the flow

buildExceptionHandlers

void buildExceptionHandlers()
                            throws FlowBuilderException

Creates and adds all exception handlers to the flow built by this builder.

Throws:

FlowBuilderException - an exception occured building this flow

getFlow

Flow getFlow()

Get the fully constructed and configured Flow object - called by the builder's assembler (director) after assembly. When this method is called by the assembler, it is expected flow construction has completed and the returned flow is ready for use.

dispose

void dispose()

Shutdown the builder, releasing any resources it holds. A new flow construction process should start with another call to the init(String, AttributeMap) method.