com.haulmont.cuba.gui.components.actions

Class BaseAction

java.lang.Object

com.haulmont.cuba.gui.components.AbstractAction

com.haulmont.cuba.gui.components.actions.BaseAction

All Implemented Interfaces:

Action, Action.HasTarget, Action.UiPermissionAware

Direct Known Subclasses:

AddAction, CreateAction, DeclarativeAction, DialogAction, ExcelAction, ItemTrackingAction, PickerField.StandardAction, RefreshAction, RelatedAction, ShowInfoAction

public class BaseAction
extends AbstractAction
implements Action.HasTarget, Action.UiPermissionAware

Action that can change its enabled and visible properties depending on the user permissions and current context.

The BaseAction is visible if the following conditions are met:

• setVisible(false) method was not called;
• there is no "hide" UI permission for this action.

The action is enabled if the following conditions are met:

• setEnabled(false) method was not called;
• there are no "hide" and "read-only" UI permissions for this action;
• isPermitted() method returns true;
• isApplicable() method returns true;
• all BaseAction.EnabledRules (if any) return true.

Descendants may override isPermitted() and isApplicable() methods to define conditions in which action will be enabled. Also, you can use fluent API to create instances of BaseAction and assign handlers to them:

     Action action = new BaseAction("printAll")
             .withCaption("Print all")
             .withIcon("icons/print.png")
             .withHandler(event -> {
                 // action logic here
              });
     docsTable.addAction(action);
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	BaseAction.EnabledRule Callback interface which is invoked by the action to determine its enabled state.

Nested classes/interfaces inherited from interface com.haulmont.cuba.gui.components.Action

Action.ActionPerformedEvent, Action.BeforeActionPerformedHandler, Action.HasBeforeActionPerformedHandler, Action.HasOpenType, Action.HasSecurityConstraint, Action.HasTarget, Action.Status, Action.UiPermissionAware

Field Summary

Fields inherited from interface com.haulmont.cuba.gui.components.Action

PROP_CAPTION, PROP_DESCRIPTION, PROP_ENABLED, PROP_ICON, PROP_SHORTCUT, PROP_VISIBLE

Constructor Summary

Constructors

Constructor and Description
BaseAction(java.lang.String id)

Method Summary

Modifier and Type	Method and Description
void	actionPerform(Component component) Invoked by owning component when an action occurs.
void	addEnabledRule(BaseAction.EnabledRule enabledRule) Add new enabled rule for the action.
ListComponent	getTarget()
boolean	isEnabledByUiPermissions()
boolean	isVisibleByUiPermissions()
void	refreshState() Refresh internal state of the action to initialize enabled, visible, caption, icon, etc.
void	removeEnabledRule(BaseAction.EnabledRule enabledRule) Remove enabled rule.
void	setEnabled(boolean enabled)
void	setEnabledByUiPermissions(boolean enabledByUiPermissions)
void	setTarget(ListComponent target)
void	setVisible(boolean visible)
void	setVisibleByUiPermissions(boolean visibleByUiPermissions)
BaseAction	withCaption(java.lang.String caption) Set caption usin fluent API method.
BaseAction	withDescription(java.lang.String description) Set description using fluent API method.
BaseAction	withHandler(java.util.function.Consumer<Action.ActionPerformedEvent> handler) Set actionPerformed handler using fluent API method.
BaseAction	withIcon(java.lang.String icon) Set icon using fluent API method.
BaseAction	withShortcut(java.lang.String shortcut) Set shortcut using fluent API method.

Methods inherited from class com.haulmont.cuba.gui.components.AbstractAction

addOwner, addPropertyChangeListener, getCaption, getDescription, getIcon, getId, getOwner, getOwners, getShortcutCombination, isEnabled, isPrimary, isVisible, removeOwner, removePropertyChangeListener, setCaption, setDescription, setIcon, setIconFromSet, setPrimary, setShortcut, setShortcutCombination

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.haulmont.cuba.gui.components.Action

addOwner, addPropertyChangeListener, getCaption, getDescription, getIcon, getId, getOwner, getOwners, getShortcutCombination, isEnabled, isVisible, removeOwner, removePropertyChangeListener, setCaption, setDescription, setIcon, setIconFromSet, setShortcut, setShortcutCombination

Constructor Detail

BaseAction

public BaseAction(java.lang.String id)

Method Detail

setVisible

public void setVisible(boolean visible)

Specified by:

setVisible in interface Action

Overrides:

setVisible in class AbstractAction

setEnabled

public void setEnabled(boolean enabled)

Specified by:

setEnabled in interface Action

Overrides:

setEnabled in class AbstractAction

refreshState

public void refreshState()

Description copied from interface: Action

Refresh internal state of the action to initialize enabled, visible, caption, icon, etc. properties depending on programmatically set values and user permissions set at runtime.
For example, this method is called by visual components holding actions when they are connected to datasources. At this moment the action can find out what entity it is connected to and change its state according to the user permissions.

Specified by:

refreshState in interface Action

Overrides:

refreshState in class AbstractAction

getTarget

public ListComponent getTarget()

Specified by:

getTarget in interface Action.HasTarget

setTarget

public void setTarget(ListComponent target)

Specified by:

setTarget in interface Action.HasTarget

isEnabledByUiPermissions

public boolean isEnabledByUiPermissions()

Specified by:

isEnabledByUiPermissions in interface Action.UiPermissionAware

setEnabledByUiPermissions

public void setEnabledByUiPermissions(boolean enabledByUiPermissions)

Specified by:

setEnabledByUiPermissions in interface Action.UiPermissionAware

isVisibleByUiPermissions

public boolean isVisibleByUiPermissions()

Specified by:

isVisibleByUiPermissions in interface Action.UiPermissionAware

setVisibleByUiPermissions

public void setVisibleByUiPermissions(boolean visibleByUiPermissions)

Specified by:

setVisibleByUiPermissions in interface Action.UiPermissionAware

addEnabledRule

public void addEnabledRule(BaseAction.EnabledRule enabledRule)

Add new enabled rule for the action.

Parameters:

enabledRule - boolean rule for the action enabled state

removeEnabledRule

public void removeEnabledRule(BaseAction.EnabledRule enabledRule)

Remove enabled rule.

Parameters:

enabledRule - boolean rule for the action enabled state

actionPerform

public void actionPerform(Component component)

Description copied from interface: Action

Invoked by owning component when an action occurs.

Specified by:

actionPerform in interface Action

Parameters:

component - invoking component

withCaption

public BaseAction withCaption(java.lang.String caption)

Set caption usin fluent API method.

Parameters:

caption - caption

Returns:

current instance of action

withDescription

public BaseAction withDescription(java.lang.String description)

Set description using fluent API method.

Parameters:

description - description

Returns:

current instance of action

withIcon

public BaseAction withIcon(java.lang.String icon)

Set icon using fluent API method.

Parameters:

icon - icon

Returns:

current instance of action

withShortcut

public BaseAction withShortcut(java.lang.String shortcut)

Set shortcut using fluent API method.

Parameters:

shortcut - shortcut

Returns:

current instance of action

withHandler

public BaseAction withHandler(java.util.function.Consumer<Action.ActionPerformedEvent> handler)

Set actionPerformed handler using fluent API method. Can be used instead of subclassing BaseAction class.

Parameters:

handler - action performed handler

Returns:

current instance of action