Class AbstractFindIdListActionSupport<M extends Serializable,K extends Serializable,F extends AbstractForm>
java.lang.Object
org.apache.struts2.ActionSupport
com.opensymphony.xwork2.ActionSupport
name.matthewgreet.strutscommons.action.AbstractActionSupport
name.matthewgreet.strutscommons.action.AbstractFormDrivenActionSupport<F>
name.matthewgreet.strutscommons.action.AbstractFindIdListActionSupport<M,K,F>
- All Implemented Interfaces:
com.opensymphony.xwork2.Action
,com.opensymphony.xwork2.interceptor.ValidationAware
,com.opensymphony.xwork2.LocaleProvider
,com.opensymphony.xwork2.ModelDriven<F>
,com.opensymphony.xwork2.TextProvider
,com.opensymphony.xwork2.Validateable
,Serializable
,BrowserTabAware
,BrowserTabAware2
,FormDriven<F>
,org.apache.struts2.action.Action
,org.apache.struts2.action.ServletRequestAware
,org.apache.struts2.interceptor.ValidationAware
,org.apache.struts2.ModelDriven<F>
,org.apache.struts2.Validateable
public abstract class AbstractFindIdListActionSupport<M extends Serializable,K extends Serializable,F extends AbstractForm>
extends AbstractFormDrivenActionSupport<F>
Template class for creating Command objects that load an id list in the ListCache
used by the target,
viewer action.
Concrete subclasses must implement getFindIdListConfig()
, which defines the list being displayed from the
ListCache
and a list index. Subclasses will override getFindCommand(M)
to generate a Command object
that implements IdListFinder
.
- M
- Record type of master list cache if loading a slave list or Object otherwise.
- K
- Primary key type of list cache.
- F
- Type of Struts action form used by this action or NullForm if Struts forms aren't used.
- See Also:
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic class
Configures list to be loaded by Struts, finder action and whether empty lists means search parameters must be rejected.static class
AbstractFindIdListActionSupport.FindIdListResponse<M extends Serializable,
K extends Serializable> Nested classes/interfaces inherited from interface com.opensymphony.xwork2.interceptor.ValidationAware
com.opensymphony.xwork2.interceptor.ValidationAware.LegacyAdapter
-
Field Summary
Fields inherited from class org.apache.struts2.ActionSupport
container
Fields inherited from interface org.apache.struts2.action.Action
ERROR, INPUT, LOGIN, NONE, SUCCESS
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionexecute()
protected abstract AbstractFindIdListActionSupport.FindIdListResponse
<M, K> getFindCommand
(M selectedMaster) Overridden by subclasses to return Command object for retrieving list (configured with any search parameters) and forwarding in the case of success.protected abstract AbstractFindIdListActionSupport.FindIdListConfig
Written by subclasses to configure behaviour of find action.getListCache
(javax.servlet.http.HttpSession session) Written by subclasses to return list cache that is being populated.getMasterListCache
(javax.servlet.http.HttpSession session) Written by subclasses to return master list cache or null if the list cache is the master list.protected String
translateFinderException
(IdListFinder<M, K> finderCommand, Exception e) May be overridden by subclasses to translate an exception thrown by a list finder Command into a Struts message key, so a message is displayed to the user.Methods inherited from class name.matthewgreet.strutscommons.action.AbstractFormDrivenActionSupport
formValidationFailed, getForm, getModel, makeForm, setForm, validate
Methods inherited from class name.matthewgreet.strutscommons.action.AbstractActionSupport
getBrowserTabSession, getLogger, getServletRequest, getTabId, setBrowserTabSession, setTabId, withServletRequest
Methods inherited from class org.apache.struts2.ActionSupport
addActionError, addActionMessage, addFieldError, clearActionErrors, clearErrors, clearErrorsAndMessages, clearFieldErrors, clearMessages, clone, getActionErrors, getActionMessages, getContainer, getFieldErrors, getFormatted, getLocale, getLocaleProvider, getText, getText, getText, getText, getText, getText, getText, getText, getText, getTextProvider, getTexts, getTexts, hasActionErrors, hasActionMessages, hasErrors, hasFieldErrors, hasKey, input, isValidLocale, isValidLocaleString, pause, setActionErrors, setActionMessages, setContainer, setFieldErrors, toLocale
Methods inherited from class java.lang.Object
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface name.matthewgreet.strutscommons.action.BrowserTabAware2
copyAttributesFromOldTabToNewTab, handleAttributeFailures
Methods inherited from interface org.apache.struts2.interceptor.ValidationAware
addActionError, addActionMessage, addFieldError, getActionErrors, getActionMessages, getFieldErrors, hasActionErrors, hasActionMessages, hasErrors, hasFieldErrors, setActionErrors, setActionMessages, setFieldErrors
-
Constructor Details
-
AbstractFindIdListActionSupport
public AbstractFindIdListActionSupport()
-
-
Method Details
-
getFindCommand
protected abstract AbstractFindIdListActionSupport.FindIdListResponse<M,K> getFindCommand(M selectedMaster) throws Exception Overridden by subclasses to return Command object for retrieving list (configured with any search parameters) and forwarding in the case of success.- Parameters:
selectedMaster
- Selected record of master list or null if loading master list.- Throws:
Exception
-
getFindIdListConfig
Written by subclasses to configure behaviour of find action. -
getListCache
Written by subclasses to return list cache that is being populated. -
getMasterListCache
Written by subclasses to return master list cache or null if the list cache is the master list. -
translateFinderException
May be overridden by subclasses to translate an exception thrown by a list finder Command into a Struts message key, so a message is displayed to the user. May return null to default to a generic error message key.- Parameters:
finderCommand
- List finder Command.e
- Exception thrown byIdListFinder.getIds(M)
function.
-
execute
- Specified by:
execute
in interfaceorg.apache.struts2.action.Action
- Overrides:
execute
in classorg.apache.struts2.ActionSupport
- Throws:
Exception
-