org.springframework.webflow.definition
Interface FlowDefinition

All Superinterfaces:

Annotated

All Known Implementing Classes:

Flow

public interface FlowDefinition
extends Annotated

The definition of a flow, a program that when executed carries out the orchestration of a task on behalf of a single client.

A flow definition is a reusable, self-contained controller module that defines a blue print for an executable user task. Flows typically orchestrate controlled navigations or dialogs within web applications to guide users through fulfillment of a business process/goal that takes place over a series of steps, modeled as states.

Structurally a flow definition is composed of a set of states. A state is a point in a flow where a behavior is executed; for example, showing a view, executing an action, spawning a subflow, or terminating the flow. Different types of states execute different behaviors in a polymorphic fashion. Most states are transitionable states, meaning they can respond to events by taking the flow from one state to another.

Each flow has exactly one start state which defines the starting point of the program.

This interface exposes the flow's identifier, states, and other definitional attributes. It is suitable for introspection by tools as well as user-code at flow execution time.

Flow definitions may be annotated with attributes.

Author:

Keith Donald, Erwin Vervaet

Method Summary

java.lang.String	getId() Returns the unique id of this flow.
StateDefinition	getStartState() Return this flow's starting point.
StateDefinition	getState(java.lang.String id) Returns the state definition with the specified id.

Methods inherited from interface org.springframework.webflow.definition.Annotated

getAttributes, getCaption, getDescription

Method Detail

getId

java.lang.String getId()

Returns the unique id of this flow.

Returns:

the flow id

getStartState

StateDefinition getStartState()

Return this flow's starting point.

Returns:

the start state

getState

StateDefinition getState(java.lang.String id)
                         throws java.lang.IllegalArgumentException

Returns the state definition with the specified id.

Parameters:

id - the state id

Returns:

the state definition

Throws:

java.lang.IllegalArgumentException - if a state with this id does not exist