com.sri.emo.wizard.creation.management
Interface ICreationBeanManager

All Known Implementing Classes:

CreationBeanManager

public interface ICreationBeanManager

Interface that adapts the CompletionBean to the Webapp Session. (Or other pseudo-session depending on implementation.)

Version:

1.0

Author:

Michael Rimov

Method Summary

CreationBeans	createOrRetrieveActionForm(ExpressoRequest request) Creates or retrieves the action form.
void	destroyActionForm(ExpressoRequest request) Destroys the completion bean from the session.
CreationBeans	getActionForm(ExpressoRequest request) Retrieve an action form.
boolean	handleSessionTimeout(ExpressoRequest request, ExpressoResponse response) Checks if session has timed out and redirects to 'list wizards' state if it has.
void	setCompletionBean(ExpressoRequest request, CreationBeans wizardBeanToSave) Saves the specified completion bean to session.
ErrorCollection	validate(ExpressoRequest request, ErrorCollection errorsToAdd) Validate the bean and return any action errors.

Method Detail

createOrRetrieveActionForm

CreationBeans createOrRetrieveActionForm(ExpressoRequest request)
                                         throws ControllerException

Creates or retrieves the action form. If it doesn't exist on the session then we create it.

Parameters:

request - ControllerRequest

Returns:

CompletionBean

Throws:

ControllerException

destroyActionForm

void destroyActionForm(ExpressoRequest request)
                       throws ControllerException

Destroys the completion bean from the session. Most often done after the bean has been saved.

Parameters:

request - ControllerRequest

Throws:

ControllerException

getActionForm

CreationBeans getActionForm(ExpressoRequest request)
                            throws ControllerException

Retrieve an action form. If it doesn't exist, don't create it. Return

Parameters:

request - ControllerRequest

Returns:

CompletionBean

Throws:

ControllerException

handleSessionTimeout

boolean handleSessionTimeout(ExpressoRequest request,
                             ExpressoResponse response)
                             throws ControllerException,
                                    NonHandleableException

Checks if session has timed out and redirects to 'list wizards' state if it has.

Parameters:

request - The ControllerRequest handed to us by the framework.

response - ControllerResponse handed to us by the framework.

Returns:

boolean true if we handled a timeout. False otherwise.

Throws:

ControllerException

NonHandleableException

validate

ErrorCollection validate(ExpressoRequest request,
                         ErrorCollection errorsToAdd)
                         throws ControllerException

Validate the bean and return any action errors.

Parameters:

request - ControllerRequest

errorsToAdd - ErrorCollection

Returns:

ErrorCollection with or without any specified errors.

Throws:

ControllerException - upon error.

setCompletionBean

void setCompletionBean(ExpressoRequest request,
                       CreationBeans wizardBeanToSave)
                       throws ControllerException

Saves the specified completion bean to session.

Parameters:

request - the ExpressoRequest that contains the session.

wizardBeanToSave - CompletionBean

Throws:

ControllerException