org.kuali.rice.krad.uif.element
Class Action

java.lang.Object
  org.kuali.rice.krad.uif.component.ConfigurableBase
      org.kuali.rice.krad.uif.component.ComponentBase
          org.kuali.rice.krad.uif.element.ContentElementBase
              org.kuali.rice.krad.uif.element.Action

All Implemented Interfaces:

Serializable, Component, Configurable, ScriptEventSupport, ContentElement, org.springframework.core.Ordered

Direct Known Subclasses:

AjaxAction

public class Action
extends ContentElementBase

Field that presents an action that can be taken on the UI such as submitting the form or invoking a script

Author:

Kuali Rice Team (rice.collab@kuali.org)

See Also:

Serialized Form

Field Summary

Fields inherited from interface org.kuali.rice.krad.uif.component.Ordered

INITIAL_ORDER_VALUE

Fields inherited from interface org.springframework.core.Ordered

HIGHEST_PRECEDENCE, LOWEST_PRECEDENCE

Constructor Summary

Action()

Method Summary

void	addActionParameter(String parameterName, String parameterValue) Convenience method to add a parameter to the action parameters Map
String	getActionEvent() Name of the event that will be set when the action is invoked
Image	getActionImage() Image to use for the action
String	getActionImagePlacement()
String	getActionLabel() Label text for the action
String	getActionParameter(String parameterName) Get an actionParameter by name
Map<String,String>	getActionParameters() Parameters that should be sent when the action is invoked
String	getActionScript() Client side javascript to be executed when this actionField is clicked.
ActionSecurity	getComponentSecurity() Action Field Security object that indicates what authorization (permissions) exist for the action
protected Class<? extends ComponentSecurity>	getComponentSecurityClass() Returns the security class that is associated with the component (used for initialization and validation)
List<Component>	getComponentsForLifecycle() List of components that are contained within the component and should be sent through the lifecycle
String	getDisabledReason() If the action field is disabled, gives a reason for why which will be displayed as a tooltip on the action field (button)
String	getErrorCallback() Getter for errorCallback.
String	getFocusOnIdAfterSubmit() The id of the field to place focus on in the new page after the new page is retrieved.
String	getJumpToIdAfterSubmit()
String	getJumpToNameAfterSubmit() The name to jump to in the next page, the element with this name will be jumped to automatically when the new page is retrieved after a submit.
String	getLoadingMessageText() get loading message used by action's blockUI
String	getMethodToCall() Name of the method that should be called when the action is selected
String	getNavigateToPageId() For an Action that is part of a NavigationGroup
String	getPreSubmitCall() Gets the script which needs to be invoked before the form is submitted.
String	getSuccessCallback() Getter for successCallback property.
String	getUpdatingMessageText() get updating message used by action's blockUI
boolean	isAjaxSubmit() When this property is set to true it will submit the form using Ajax instead of the browser submit.
boolean	isDisabled() Indicates whether the action (input or button) is disabled (doesn't allow interaction)
boolean	isPerformClientSideValidation() Indicates whether the form data should be validated on the client side return true if validation should occur, false otherwise
boolean	isPerformDirtyValidation()
void	performFinalize(View view, Object model, Component parent) The following finalization is performed: Add methodToCall action parameter if set and setup event code for setting action parameters
void	setActionEvent(String actionEvent) Setter for the action event
void	setActionImage(Image actionImage) Setter for the action image field
void	setActionImagePlacement(String actionImagePlacement) Set to TOP, BOTTOM, LEFT, RIGHT to position image at that location within the button.
void	setActionLabel(String actionLabel) Setter for the actions label
void	setActionParameters(Map<String,String> actionParameters) Setter for the action parameters
void	setActionScript(String actionScript)
void	setAjaxSubmit(boolean ajaxSubmit) Setter for ajaxSubmit
void	setComponentSecurity(ComponentSecurity componentSecurity) Override to assert a ActionSecurity instance is set
void	setDisabled(boolean disabled) Setter for the disabled indicator
void	setDisabledReason(String disabledReason) Setter for the disabled reason text
void	setErrorCallback(String errorCallback) Setter for errorCallback
void	setFocusOnIdAfterSubmit(String focusOnIdAfterSubmit)
void	setJumpToIdAfterSubmit(String jumpToIdAfterSubmit) The id to jump to in the next page, the element with this id will be jumped to automatically when the new page is retrieved after a submit.
void	setJumpToNameAfterSubmit(String jumpToNameAfterSubmit)
void	setLoadingMessageText(String loadingMessageText) When this property is set, it is used in place of the loading message text used by the blockUI
void	setMethodToCall(String methodToCall) Setter for the actions method to call
void	setNavigateToPageId(String navigateToPageId) Setter for the navigate to page id
void	setPerformClientSideValidation(boolean performClientSideValidation) Setter for the client side validation flag
void	setPerformDirtyValidation(boolean performDirtyValidation)
void	setPreSubmitCall(String preSubmitCall) Setter for preSubmitCall
void	setSuccessCallback(String successCallback) Setter for successCallback
void	setUpdatingMessageText(String updatingMessageText) When this property is set, it is used in place of the updating message text used by the blockUI

Methods inherited from class org.kuali.rice.krad.uif.element.ContentElementBase

getComponentTypeName

Methods inherited from class org.kuali.rice.krad.uif.component.ComponentBase

addDataAttribute, addStyleClass, appendToStyle, getAlign, getAllDataAttributesJs, getBaseId, getColSpan, getComplexDataAttributesJs, getComponentModifiers, getComponentPrototypes, getConditionalRefresh, getConditionalRefreshConditionJs, getConditionalRefreshControlNames, getContext, getCssClasses, getDataAttributes, getDataMetaAttribute, getDataRoleAttribute, getDataTypeAttribute, getFinalizeMethodAdditionalArguments, getFinalizeMethodInvoker, getFinalizeMethodToCall, getId, getMethodToCallOnRefresh, getOnBlurScript, getOnChangeScript, getOnClickScript, getOnCloseScript, getOnDblClickScript, getOnDocumentReadyScript, getOnFocusScript, getOnKeyDownScript, getOnKeyPressScript, getOnKeyUpScript, getOnLoadScript, getOnMouseDownScript, getOnMouseMoveScript, getOnMouseOutScript, getOnMouseOverScript, getOnMouseUpScript, getOnSubmitScript, getOnUnloadScript, getOrder, getProgressiveDisclosureConditionJs, getProgressiveDisclosureControlNames, getProgressiveRender, getPropertyReplacerComponents, getPropertyReplacers, getRefreshWhenChangedPropertyNames, getRenderedHtmlOutput, getRequired, getRowSpan, getSimpleDataAttributes, getStyle, getStyleClassesAsString, getTemplate, getTemplateName, getTemplateOptions, getTemplateOptionsJSString, getTitle, getToolTip, getValign, getWidth, isDisableSessionPersistence, isForceSessionPersistence, isHidden, isProgressiveRenderAndRefresh, isProgressiveRenderViaAJAX, isReadOnly, isRefreshedByAction, isRender, isResetDataOnRefresh, isSelfRendered, isSkipInTabOrder, performApplyModel, performInitialization, pushAllToContext, pushObjectToContext, pushToPropertyReplacerContext, setAlign, setBaseId, setColSpan, setComponentModifiers, setConditionalRefresh, setContext, setCssClasses, setDataAttributes, setDataMetaAttribute, setDataRoleAttribute, setDataTypeAttribute, setDisableSessionPersistence, setFinalizeMethodAdditionalArguments, setFinalizeMethodInvoker, setFinalizeMethodToCall, setForceSessionPersistence, setHidden, setId, setMethodToCallOnRefresh, setOnBlurScript, setOnChangeScript, setOnClickScript, setOnCloseScript, setOnDblClickScript, setOnDocumentReadyScript, setOnFocusScript, setOnKeyDownScript, setOnKeyPressScript, setOnKeyUpScript, setOnLoadScript, setOnMouseDownScript, setOnMouseMoveScript, setOnMouseOutScript, setOnMouseOverScript, setOnMouseUpScript, setOnSubmitScript, setOnUnloadScript, setOrder, setProgressiveRender, setProgressiveRenderAndRefresh, setProgressiveRenderViaAJAX, setPropertyReplacers, setReadOnly, setRefreshedByAction, setRefreshWhenChangedPropertyNames, setRender, setRenderedHtmlOutput, setRequired, setResetDataOnRefresh, setRowSpan, setSelfRendered, setSkipInTabOrder, setStyle, setTemplate, setTemplateName, setTemplateOptions, setTemplateOptionsJSString, setTitle, setToolTip, setValign, setWidth

Methods inherited from class org.kuali.rice.krad.uif.component.ConfigurableBase

getExpressionGraph, getPropertyExpression, getPropertyExpressions, getRefreshExpressionGraph, setExpressionGraph, setPropertyExpressions, setRefreshExpressionGraph

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.kuali.rice.krad.uif.component.Component

addDataAttribute, addStyleClass, appendToStyle, getAllDataAttributesJs, getBaseId, getColSpan, getComplexDataAttributesJs, getComponentModifiers, getComponentPrototypes, getConditionalRefresh, getConditionalRefreshConditionJs, getConditionalRefreshControlNames, getContext, getCssClasses, getDataAttributes, getFinalizeMethodAdditionalArguments, getFinalizeMethodInvoker, getFinalizeMethodToCall, getId, getOrder, getProgressiveDisclosureConditionJs, getProgressiveDisclosureControlNames, getProgressiveRender, getPropertyReplacerComponents, getPropertyReplacers, getRefreshWhenChangedPropertyNames, getRenderedHtmlOutput, getRequired, getRowSpan, getSimpleDataAttributes, getStyle, getTemplate, getTemplateOptions, getTemplateOptionsJSString, getTitle, getToolTip, isDisableSessionPersistence, isForceSessionPersistence, isHidden, isProgressiveRenderAndRefresh, isProgressiveRenderViaAJAX, isReadOnly, isRefreshedByAction, isRender, isResetDataOnRefresh, isSelfRendered, performApplyModel, performInitialization, pushAllToContext, pushObjectToContext, setBaseId, setColSpan, setComponentModifiers, setConditionalRefresh, setContext, setCssClasses, setDataAttributes, setDisableSessionPersistence, setForceSessionPersistence, setHidden, setId, setOrder, setProgressiveRender, setProgressiveRenderAndRefresh, setProgressiveRenderViaAJAX, setPropertyReplacers, setReadOnly, setRefreshedByAction, setRefreshWhenChangedPropertyNames, setRender, setRenderedHtmlOutput, setRequired, setResetDataOnRefresh, setRowSpan, setSelfRendered, setStyle, setTemplate, setTemplateOptions, setTemplateOptionsJSString, setTitle, setToolTip

Methods inherited from interface org.kuali.rice.krad.uif.component.Configurable

getExpressionGraph, getPropertyExpression, getPropertyExpressions, getRefreshExpressionGraph, setExpressionGraph, setPropertyExpressions, setRefreshExpressionGraph

Methods inherited from interface org.kuali.rice.krad.uif.component.ScriptEventSupport

getOnBlurScript, getOnChangeScript, getOnClickScript, getOnCloseScript, getOnDblClickScript, getOnDocumentReadyScript, getOnFocusScript, getOnKeyDownScript, getOnKeyPressScript, getOnKeyUpScript, getOnLoadScript, getOnMouseDownScript, getOnMouseMoveScript, getOnMouseOutScript, getOnMouseOverScript, getOnMouseUpScript, getOnSubmitScript, getOnUnloadScript, setOnBlurScript, setOnLoadScript

Constructor Detail

Action

public Action()

Method Detail

performFinalize

public void performFinalize(View view,
                            Object model,
                            Component parent)

The following finalization is performed:

• Add methodToCall action parameter if set and setup event code for setting action parameters

Specified by:

performFinalize in interface Component

Overrides:

performFinalize in class ComponentBase

Parameters:

view - - view instance that should be finalized for rendering

model - - top level object containing the data

parent - - parent component

See Also:

ComponentBase.performFinalize(org.kuali.rice.krad.uif.view.View, java.lang.Object, org.kuali.rice.krad.uif.component.Component)

getComponentsForLifecycle

public List<Component> getComponentsForLifecycle()

Description copied from interface: Component

List of components that are contained within the component and should be sent through the lifecycle

Used by ViewHelperService for the various lifecycle callbacks

Specified by:

getComponentsForLifecycle in interface Component

Overrides:

getComponentsForLifecycle in class ComponentBase

Returns:

List child components

See Also:

ComponentBase.getComponentsForLifecycle()

getMethodToCall

public String getMethodToCall()

Name of the method that should be called when the action is selected

For a server side call (clientSideCall is false), gives the name of the method in the mapped controller that should be invoked when the action is selected. For client side calls gives the name of the script function that should be invoked when the action is selected

Returns:

String name of method to call

setMethodToCall

public void setMethodToCall(String methodToCall)

Setter for the actions method to call

Parameters:

methodToCall -

getActionLabel

public String getActionLabel()

Label text for the action

The label text is used by the template renderers to give a human readable label for the action. For buttons this generally is the button text, while for an action link it would be the links displayed text

Returns:

String label for action

setActionLabel

public void setActionLabel(String actionLabel)

Setter for the actions label

Parameters:

actionLabel -

getActionImage

public Image getActionImage()

Image to use for the action

When the action image component is set (and render is true) the image will be used to present the action as opposed to the default (input submit). For action link templates the image is used for the link instead of the action link text

Returns:

Image action image

setActionImage

public void setActionImage(Image actionImage)

Setter for the action image field

Parameters:

actionImage -

getNavigateToPageId

public String getNavigateToPageId()

For an Action that is part of a NavigationGroup Support exists in the UifControllerBase for handling navigation between pages

Returns:

String id of page that should be rendered when the action item is selected

setNavigateToPageId

public void setNavigateToPageId(String navigateToPageId)

Setter for the navigate to page id

Parameters:

navigateToPageId -

getActionEvent

public String getActionEvent()

Name of the event that will be set when the action is invoked

Action events can be looked at by the view or components in order to render differently depending on the action requested.

Returns:

String action event name

See Also:

UifConstants.ActionEvents

setActionEvent

public void setActionEvent(String actionEvent)

Setter for the action event

Parameters:

actionEvent -

getActionParameters

public Map<String,String> getActionParameters()

Parameters that should be sent when the action is invoked

Action renderer will decide how the parameters are sent for the action (via script generated hiddens, or script parameters, ...)

Can be set by other components such as the CollectionGroup to provide the context the action is in (such as the collection name and line the action applies to)

Returns:

Map action parameters

setActionParameters

public void setActionParameters(Map<String,String> actionParameters)

Setter for the action parameters

Parameters:

actionParameters -

addActionParameter

public void addActionParameter(String parameterName,
                               String parameterValue)

Convenience method to add a parameter to the action parameters Map

Parameters:

parameterName - - name of parameter to add

parameterValue - - value of parameter to add

getActionParameter

public String getActionParameter(String parameterName)

Get an actionParameter by name

getComponentSecurity

public ActionSecurity getComponentSecurity()

Action Field Security object that indicates what authorization (permissions) exist for the action

Specified by:

getComponentSecurity in interface Component

Overrides:

getComponentSecurity in class ComponentBase

Returns:

ActionSecurity instance

See Also:

Component.getComponentSecurity()

setComponentSecurity

public void setComponentSecurity(ComponentSecurity componentSecurity)

Override to assert a ActionSecurity instance is set

Specified by:

setComponentSecurity in interface Component

Overrides:

setComponentSecurity in class ComponentBase

Parameters:

componentSecurity - - instance of ActionSecurity

See Also:

Component.setComponentSecurity(org.kuali.rice.krad.uif.component.ComponentSecurity)

getComponentSecurityClass

protected Class<? extends ComponentSecurity> getComponentSecurityClass()

Description copied from class: ComponentBase

Returns the security class that is associated with the component (used for initialization and validation)

Overrides:

getComponentSecurityClass in class ComponentBase

Returns:

Class

getJumpToIdAfterSubmit

public String getJumpToIdAfterSubmit()

Returns:

the jumpToIdAfterSubmit

setJumpToIdAfterSubmit

public void setJumpToIdAfterSubmit(String jumpToIdAfterSubmit)

The id to jump to in the next page, the element with this id will be jumped to automatically when the new page is retrieved after a submit. Using "TOP" or "BOTTOM" will jump to the top or the bottom of the resulting page. Passing in nothing for both jumpToIdAfterSubmit and jumpToNameAfterSubmit will result in this Action being jumped to by default if it is present on the new page. WARNING: jumpToIdAfterSubmit always takes precedence over jumpToNameAfterSubmit, if set.

Parameters:

jumpToIdAfterSubmit - the jumpToIdAfterSubmit to set

getJumpToNameAfterSubmit

public String getJumpToNameAfterSubmit()

The name to jump to in the next page, the element with this name will be jumped to automatically when the new page is retrieved after a submit. Passing in nothing for both jumpToIdAfterSubmit and jumpToNameAfterSubmit will result in this Action being jumped to by default if it is present on the new page. WARNING: jumpToIdAfterSubmit always takes precedence over jumpToNameAfterSubmit, if set.

Returns:

the jumpToNameAfterSubmit

setJumpToNameAfterSubmit

public void setJumpToNameAfterSubmit(String jumpToNameAfterSubmit)

Parameters:

jumpToNameAfterSubmit - the jumpToNameAfterSubmit to set

getFocusOnIdAfterSubmit

public String getFocusOnIdAfterSubmit()

The id of the field to place focus on in the new page after the new page is retrieved. Passing in "FIRST" will focus on the first visible input element on the form. Passing in the empty string will result in this Action being focused.

Returns:

the focusOnAfterSubmit

setFocusOnIdAfterSubmit

public void setFocusOnIdAfterSubmit(String focusOnIdAfterSubmit)

Parameters:

focusOnIdAfterSubmit - the focusOnAfterSubmit to set

isPerformClientSideValidation

public boolean isPerformClientSideValidation()

Indicates whether the form data should be validated on the client side return true if validation should occur, false otherwise

setPerformClientSideValidation

public void setPerformClientSideValidation(boolean performClientSideValidation)

Setter for the client side validation flag

Parameters:

performClientSideValidation -

getActionScript

public String getActionScript()

Client side javascript to be executed when this actionField is clicked. This overrides the default action for this Action so the method called must explicitly submit, navigate, etc. through js, if necessary. In addition, this js occurs AFTER onClickScripts set on this field, it will be the last script executed by the click event. Sidenote: This js is always called after hidden actionParameters and methodToCall methods are written by the js to the html form.

Returns:

the actionScript

setActionScript

public void setActionScript(String actionScript)

Parameters:

actionScript - the actionScript to set

setPerformDirtyValidation

public void setPerformDirtyValidation(boolean performDirtyValidation)

Parameters:

performDirtyValidation - the blockValidateDirty to set

isPerformDirtyValidation

public boolean isPerformDirtyValidation()

Returns:

the blockValidateDirty

isDisabled

public boolean isDisabled()

Indicates whether the action (input or button) is disabled (doesn't allow interaction)

Returns:

boolean true if the action field is disabled, false if not

setDisabled

public void setDisabled(boolean disabled)

Setter for the disabled indicator

Parameters:

disabled -

getDisabledReason

public String getDisabledReason()

If the action field is disabled, gives a reason for why which will be displayed as a tooltip on the action field (button)

Returns:

String disabled reason text

See Also:

#isDisabled()}

setDisabledReason

public void setDisabledReason(String disabledReason)

Setter for the disabled reason text

Parameters:

disabledReason -

getActionImagePlacement

public String getActionImagePlacement()

setActionImagePlacement

public void setActionImagePlacement(String actionImagePlacement)

Set to TOP, BOTTOM, LEFT, RIGHT to position image at that location within the button. For the subclass ActionLinkField only LEFT and RIGHT are allowed. When set to blank/null/IMAGE_ONLY, the image itself will be the Action, if no value is set the default is ALWAYS LEFT, you must explicitly set blank/null/IMAGE_ONLY to use ONLY the image as the Action.

getPreSubmitCall

public String getPreSubmitCall()

Gets the script which needs to be invoked before the form is submitted. The script should return a boolean indicating if the form should be submitted or not.

Returns:

String script text that will be invoked before form submission

setPreSubmitCall

public void setPreSubmitCall(String preSubmitCall)

Setter for preSubmitCall

Parameters:

preSubmitCall -

isAjaxSubmit

public boolean isAjaxSubmit()

When this property is set to true it will submit the form using Ajax instead of the browser submit. Will default to updating the page contents

Returns:

boolean

setAjaxSubmit

public void setAjaxSubmit(boolean ajaxSubmit)

Setter for ajaxSubmit

Parameters:

ajaxSubmit -

getLoadingMessageText

public String getLoadingMessageText()

get loading message used by action's blockUI

setLoadingMessageText

public void setLoadingMessageText(String loadingMessageText)

When this property is set, it is used in place of the loading message text used by the blockUI

Parameters:

loadingMessageText -

getUpdatingMessageText

public String getUpdatingMessageText()

get updating message used by action's blockUI

setUpdatingMessageText

public void setUpdatingMessageText(String updatingMessageText)

When this property is set, it is used in place of the updating message text used by the blockUI

Parameters:

updatingMessageText -

getSuccessCallback

public String getSuccessCallback()

Getter for successCallback property. This will be invoked for successful ajax calls

Returns:

String

setSuccessCallback

public void setSuccessCallback(String successCallback)

Setter for successCallback

Parameters:

successCallback -

getErrorCallback

public String getErrorCallback()

Getter for errorCallback. This will be invoked for failed ajax calls

Returns:

setErrorCallback

public void setErrorCallback(String errorCallback)

Setter for errorCallback

Parameters:

errorCallback -