com.haulmont.cuba.gui.components.actions

Class RemoveAction

java.lang.Object

com.haulmont.cuba.gui.components.AbstractAction

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

com.haulmont.cuba.gui.components.actions.ListAction

com.haulmont.cuba.gui.components.actions.ItemTrackingAction

com.haulmont.cuba.gui.components.actions.RemoveAction

All Implemented Interfaces:

Action, Action.HasBeforeActionPerformedHandler, Action.HasSecurityConstraint, Action.HasTarget, Action.SecuredAction

Direct Known Subclasses:

ExcludeAction, UserEditor.RemoveRoleAction, UserRemoveAction

@Component(value="cuba_RemoveAction")
 @Scope(value="prototype")
public class RemoveAction
extends ItemTrackingAction
implements Action.HasBeforeActionPerformedHandler

Standard list action to remove an entity instance.

Action's behaviour can be customized by providing arguments to constructor, setting properties, or overriding method afterRemove(java.util.Set) )}

In order to provide your own implementation globally, create a subclass and register it in web-spring.xml, for example:

 <bean id="cuba_RemoveAction" class="com.company.sample.gui.MyRemoveAction" scope="prototype"/>
 

Also, use create() static methods instead of constructors when creating the action programmatically.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	RemoveAction.AfterRemoveHandler

Nested classes/interfaces inherited from class com.haulmont.cuba.gui.components.actions.BaseAction

BaseAction.EnabledRule

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.SecuredAction, Action.Status

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ACTION_ID
protected RemoveAction.AfterRemoveHandler	afterRemoveHandler
protected boolean	autocommit
protected Action.BeforeActionPerformedHandler	beforeActionPerformedHandler
protected boolean	confirm
protected java.lang.String	confirmationMessage
protected java.lang.String	confirmationTitle

Fields inherited from class com.haulmont.cuba.gui.components.actions.ItemTrackingAction

constraintCode, constraintOperationType, security

Fields inherited from class com.haulmont.cuba.gui.components.actions.ListAction

target

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

caption, description, enabled, eventHub, icon, id, owners, primary, shortcut, visible

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
RemoveAction(ListComponent target) The simplest constructor.
RemoveAction(ListComponent target, boolean autocommit) Constructor that allows to specify autocommit value.
RemoveAction(ListComponent target, boolean autocommit, java.lang.String id) Constructor that allows to specify action's identifier and autocommit value.

Method Summary

Modifier and Type	Method and Description
void	actionPerform(Component component) This method is invoked by the action owner component.
protected void	afterRemove(java.util.Set selected) Hook invoked after remove.
protected boolean	checkRemovePermission()
protected void	confirmAndRemove(java.util.Set<Entity> selected)
static RemoveAction	create(ListComponent target) Creates an action with default id.
static RemoveAction	create(ListComponent target, boolean autocommit) Creates an action with default id.
static RemoveAction	create(ListComponent target, boolean autocommit, java.lang.String id) Creates an action with the given id.
protected void	doRemove(java.util.Set<Entity> selected, boolean autocommit)
Action.BeforeActionPerformedHandler	getBeforeActionPerformedHandler()
java.lang.String	getConfirmationMessage() Provides confirmation dialog message.
java.lang.String	getConfirmationTitle() Provides confirmation dialog title.
boolean	isAutocommit()
boolean	isConfirm()
protected boolean	isPermitted() Check permissions for Action
protected void	remove(java.util.Set<Entity> selected)
void	setAfterRemoveHandler(RemoveAction.AfterRemoveHandler afterRemoveHandler)
void	setAutocommit(boolean autocommit)
void	setBeforeActionPerformedHandler(Action.BeforeActionPerformedHandler handler)
void	setConfirm(boolean confirm)
void	setConfirmationMessage(java.lang.String confirmationMessage)
void	setConfirmationTitle(java.lang.String confirmationTitle)

Methods inherited from class com.haulmont.cuba.gui.components.actions.ItemTrackingAction

getConstraintCode, getConstraintOperationType, isApplicable, setConstraintCode, setConstraintOperationType

Methods inherited from class com.haulmont.cuba.gui.components.actions.ListAction

getTarget, setTarget, withCaption, withDescription, withHandler, withIcon, withPrimary, withShortcut

Methods inherited from class com.haulmont.cuba.gui.components.actions.BaseAction

addActionPerformedListener, addEnabledRule, isEnabledByRule, isEnabledByUiPermissions, isVisibleByUiPermissions, refreshState, removeEnabledRule, setEnabled, setEnabledByUiPermissions, setEnabledInternal, setVisible, setVisibleByUiPermissions, setVisibleInternal

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

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

Methods inherited from class java.lang.Object

clone, equals, finalize, 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, refreshState, removeOwner, removePropertyChangeListener, setCaption, setDescription, setEnabled, setIcon, setIconFromSet, setShortcut, setShortcutCombination, setVisible

Field Detail

ACTION_ID

public static final java.lang.String ACTION_ID

autocommit

protected boolean autocommit

confirm

protected boolean confirm

confirmationMessage

protected java.lang.String confirmationMessage

confirmationTitle

protected java.lang.String confirmationTitle

afterRemoveHandler

protected RemoveAction.AfterRemoveHandler afterRemoveHandler

beforeActionPerformedHandler

protected Action.BeforeActionPerformedHandler beforeActionPerformedHandler

Constructor Detail

RemoveAction

public RemoveAction(ListComponent target)

The simplest constructor. The action has default name and autocommit=true.

Parameters:

target - component containing this action

RemoveAction

public RemoveAction(ListComponent target,
                    boolean autocommit)

Constructor that allows to specify autocommit value. The action has default name.

Parameters:

target - component containing this action

autocommit - whether to commit datasource immediately

RemoveAction

public RemoveAction(ListComponent target,
                    boolean autocommit,
                    java.lang.String id)

Constructor that allows to specify action's identifier and autocommit value.

Parameters:

target - component containing this action

autocommit - whether to commit datasource immediately

id - action's identifier

Method Detail

create

public static RemoveAction create(ListComponent target)

Creates an action with default id. Autocommit is set to true.

Parameters:

target - component containing this action

create

public static RemoveAction create(ListComponent target,
                                  boolean autocommit)

Creates an action with default id.

Parameters:

target - component containing this action

autocommit - whether to commit datasource immediately

create

public static RemoveAction create(ListComponent target,
                                  boolean autocommit,
                                  java.lang.String id)

Creates an action with the given id.

Parameters:

target - component containing this action

autocommit - whether to commit datasource immediately

id - action's identifier

isPermitted

protected boolean isPermitted()

Check permissions for Action

Overrides:

isPermitted in class ItemTrackingAction

Returns:

true if the action is enabled for the current user

checkRemovePermission

protected boolean checkRemovePermission()

actionPerform

public void actionPerform(Component component)

This method is invoked by the action owner component.

Specified by:

actionPerform in interface Action

Overrides:

actionPerform in class BaseAction

Parameters:

component - component invoking the action

confirmAndRemove

protected void confirmAndRemove(java.util.Set<Entity> selected)

remove

protected void remove(java.util.Set<Entity> selected)

isAutocommit

public boolean isAutocommit()

Returns:

whether to commit datasource immediately after deletion

setAutocommit

public void setAutocommit(boolean autocommit)

Parameters:

autocommit - whether to commit datasource immediately after deletion

isConfirm

public boolean isConfirm()

Returns:

whether to show the confirmation dialog to user

setConfirm

public void setConfirm(boolean confirm)

Parameters:

confirm - whether to show the confirmation dialog to user

getConfirmationMessage

public java.lang.String getConfirmationMessage()

Provides confirmation dialog message.

Returns:

localized message

setConfirmationMessage

public void setConfirmationMessage(java.lang.String confirmationMessage)

Parameters:

confirmationMessage - confirmation dialog message

getConfirmationTitle

public java.lang.String getConfirmationTitle()

Provides confirmation dialog title.

Returns:

localized title

setConfirmationTitle

public void setConfirmationTitle(java.lang.String confirmationTitle)

Parameters:

confirmationTitle - confirmation dialog title.

doRemove

protected void doRemove(java.util.Set<Entity> selected,
                        boolean autocommit)

afterRemove

protected void afterRemove(java.util.Set selected)

Hook invoked after remove.

Parameters:

selected - set of removed instances

setAfterRemoveHandler

public void setAfterRemoveHandler(RemoveAction.AfterRemoveHandler afterRemoveHandler)

Parameters:

afterRemoveHandler - handler that is invoked after remove

getBeforeActionPerformedHandler

public Action.BeforeActionPerformedHandler getBeforeActionPerformedHandler()

Specified by:

getBeforeActionPerformedHandler in interface Action.HasBeforeActionPerformedHandler

setBeforeActionPerformedHandler

public void setBeforeActionPerformedHandler(Action.BeforeActionPerformedHandler handler)

Specified by:

setBeforeActionPerformedHandler in interface Action.HasBeforeActionPerformedHandler