Package org.apache.struts.chain.commands.generic

Class CopyFormToContext

java.lang.Object

org.apache.struts.chain.commands.ActionCommandBase

org.apache.struts.chain.commands.generic.CopyFormToContext

All Implemented Interfaces:

org.apache.commons.chain.Command<ActionContext>, ActionCommand

public class CopyFormToContext
extends ActionCommandBase

Subclass this command and configure it as part of a per-forward chain to perform any necessary pre-population or other preparation for a form before control is dispatched to the view layer.

Version:

$Id$

Field Summary

Fields inherited from interface org.apache.commons.chain.Command

CONTINUE_PROCESSING, PROCESSING_COMPLETE

Constructor Summary

Constructors

Constructor	Description
CopyFormToContext()

Method Summary

Modifier and Type	Method	Description
protected boolean	execute_(ActionContext actionContext)	Look up an ActionForm instance based on the configured properties of this command and copy it into the Context.
protected ActionForm	findOrCreateForm(ActionContext context)	Based on the properties of this command and the given ActionContext, find or create an ActionForm instance for preparation.
protected ActionForm	findOrCreateForm(ActionContext ctx, String effectiveFormName, String effectiveScope)	Actually find or create an instance of ActionForm configured under the form-bean-name effectiveFormName, looking in in the ActionContext's scope as identified by effectiveScope.
String	getActionPath()	Return ActionPath property.
String	getFormName()	Return FormName property.
String	getScope()	Return Scope property.
String	getToKey()	Return ToKey property.
void	setActionPath(String actionPath)	Set ActionPath property.
void	setFormName(String formName)	Set FormName property
void	setScope(String scope)	Set Scope property.
void	setToKey(String toKey)	Set ToKey property.

Methods inherited from class org.apache.struts.chain.commands.ActionCommandBase

execute

Methods inherited from class java.lang.Object

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

Constructor Details

CopyFormToContext

public CopyFormToContext()

Method Details

getActionPath

public String getActionPath()

Return ActionPath property.

Returns:

ActionPath property

setActionPath

public void setActionPath(String actionPath)

Set ActionPath property.

Parameters:

actionPath - New value for ActionPath

getFormName

public String getFormName()

Return FormName property.

Returns:

FormName property

setFormName

public void setFormName(String formName)

Set FormName property

Parameters:

formName - New value for FormName

getScope

public String getScope()

Return Scope property.

Returns:

Scope property

setScope

public void setScope(String scope)

Set Scope property.

Parameters:

scope - New value for Scope

getToKey

public String getToKey()

Return ToKey property.

Returns:

ToKey property

setToKey

public void setToKey(String toKey)

Set ToKey property.

Parameters:

toKey - New value for FormName

execute_

protected boolean execute_(ActionContext actionContext)
                    throws Exception

Look up an ActionForm instance based on the configured properties of this command and copy it into the Context. After this command successfully executes, an ActionForm instance will exist in the specified scope and will be available, for example for backing fields in an HTML form. It will also be in the ActionContext available for another command to do pre-population of values or other preparation.

Specified by:

execute_ in class ActionCommandBase

Parameters:

actionContext - Our ActionContext

Returns:

TRUE if processing should halt

Throws:

Exception - on any error

findOrCreateForm

protected ActionForm findOrCreateForm(ActionContext context)
                               throws InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException,
NoSuchMethodException,
SecurityException,
ClassNotFoundException

Based on the properties of this command and the given ActionContext, find or create an ActionForm instance for preparation.

Parameters:

context - ActionContextBase class that we are processing

Returns:

ActionForm instance

Throws:

InstantiationException - If ActionContext is not subclass of ActionContextBase

IllegalAccessException - On failed instantiation

IllegalArgumentException - On ActionConfig not found

InvocationTargetException - if the underlying constructor throws an exception

NoSuchMethodException - if a matching method is not found

SecurityException - if there is a security-exception

ClassNotFoundException - if the specified class cannot be loaded

findOrCreateForm

protected ActionForm findOrCreateForm(ActionContext ctx,
 String effectiveFormName,
 String effectiveScope)
                               throws InstantiationException,
IllegalAccessException,
IllegalArgumentException,
InvocationTargetException,
NoSuchMethodException,
SecurityException,
ClassNotFoundException

Actually find or create an instance of ActionForm configured under the form-bean-name effectiveFormName, looking in in the ActionContext's scope as identified by effectiveScope. If a form is created, it will also be stored in that scope.

NOTE: This specific method depends on the instance of ActionContext which is passed being a subclass of ActionContextBase, which implements the utility method findOrCreateActionForm.

Parameters:

ctx - The ActionContext we are processing

effectiveFormName - the target form name

effectiveScope - The target scope

Returns:

ActionForm instance, storing in scope if created

Throws:

InstantiationException - If ActionContext is not subclass of ActionContextBase or object cannot be created

IllegalAccessException - On failed instantiation

IllegalArgumentException - On form not found in scope

InvocationTargetException - if the underlying constructor throws an exception

NoSuchMethodException - if a matching method is not found

SecurityException - if there is a security-exception

ClassNotFoundException - if the specified class cannot be loaded