E
- type of entity@StudioAction(target="io.jmix.ui.component.ListComponent", description="Adds entities to the list using a lookup screen", availableInScreenWizard=true) @ActionType(value="add") public class AddAction<E> extends ListAction implements Action.AdjustWhenScreenReadOnly, Action.ScreenOpeningAction, Action.ExecutableAction
Should be defined for a list component (Table
, DataGrid
, etc.) in a screen XML descriptor.
The action instance can be parameterized using the nested properties
XML element or programmatically in the
screen controller.
BaseAction.EnabledRule
Action.ActionPerformedEvent, Action.AdjustWhenScreenReadOnly, Action.ExecutableAction, Action.HasPrimaryState, Action.HasSecurityConstraint, Action.HasTarget, Action.MainTabSheetAction, Action.ScreenOpeningAction, Action.SecuredAction, Action.Status
Modifier and Type | Field and Description |
---|---|
protected io.jmix.core.AccessManager |
accessManager |
static java.lang.String |
ID |
protected ScreenBuilders |
screenBuilders |
protected ActionScreenInitializer |
screenInitializer |
protected java.util.function.Predicate<LookupScreen.ValidationContext<E>> |
selectValidator |
protected java.util.function.Function<java.util.Collection<E>,java.util.Collection<E>> |
transformation |
target
caption, description, enabled, eventHub, icon, id, owners, primary, shortcut, visible
PROP_CAPTION, PROP_DESCRIPTION, PROP_ENABLED, PROP_ICON, PROP_SHORTCUT, PROP_VISIBLE
Constructor and Description |
---|
AddAction() |
AddAction(java.lang.String id) |
Modifier and Type | Method and Description |
---|---|
void |
actionPerform(Component component)
Invoked by owning component to execute the action.
|
void |
execute()
Executes the action.
|
OpenMode |
getOpenMode()
Returns the lookup screen open mode if it was set by
setOpenMode(OpenMode) or in the screen XML. |
java.lang.Class<? extends Screen> |
getScreenClass()
Returns the lookup screen class if it was set by
setScreenClass(Class) or in the screen XML. |
java.lang.String |
getScreenId()
Returns the lookup screen id if it was set by
setScreenId(String) or in the screen XML. |
protected boolean |
isPermitted()
Callback method which is invoked by the action to determine its enabled state.
|
void |
setAfterCloseHandler(java.util.function.Consumer<Screen.AfterCloseEvent> afterCloseHandler)
Sets the handler to be invoked when the lookup screen closes.
|
protected void |
setIcons(Icons icons) |
protected void |
setMessages(io.jmix.core.Messages messages) |
void |
setOpenMode(OpenMode openMode)
Sets the lookup screen open mode.
|
void |
setScreenBuilders(ScreenBuilders screenBuilders) |
void |
setScreenClass(java.lang.Class<? extends Screen> screenClass)
Sets the lookup screen id.
|
void |
setScreenConfigurer(java.util.function.Consumer<Screen> screenConfigurer)
Sets the lookup screen configurer.
|
void |
setScreenId(java.lang.String screenId)
Sets the lookup screen id.
|
void |
setScreenOptionsSupplier(java.util.function.Supplier<ScreenOptions> screenOptionsSupplier)
Sets the lookup screen options supplier.
|
void |
setSecurity(io.jmix.core.AccessManager accessManager) |
void |
setSelectValidator(java.util.function.Predicate<LookupScreen.ValidationContext<E>> selectValidator)
Sets the validator to be invoked when the user selects entities in the lookup screen.
|
void |
setTransformation(java.util.function.Function<java.util.Collection<E>,java.util.Collection<E>> transformation)
Sets the function to transform selected in the lookup screen entities.
|
getTarget, setTarget, withCaption, withDescription, withHandler, withIcon, withPrimary, withShortcut
addActionPerformedListener, addEnabledRule, isApplicable, isEnabledByRule, isEnabledByUiPermissions, isVisibleByUiPermissions, refreshState, removeEnabledRule, setEnabled, setEnabledByUiPermissions, setEnabledInternal, setVisible, setVisibleByUiPermissions, setVisibleInternal
addOwner, addPropertyChangeListener, firePropertyChange, getCaption, getDescription, getEventHub, getIcon, getId, getOwner, getOwners, getShortcutCombination, hasSubscriptions, isEnabled, isPrimary, isVisible, removeOwner, removePropertyChangeListener, setCaption, setDescription, setIcon, setPrimary, setShortcut, setShortcutCombination
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
isDisabledWhenScreenReadOnly
addOwner, addPropertyChangeListener, getCaption, getDescription, getIcon, getId, getOwner, getOwners, getShortcutCombination, isEnabled, isVisible, refreshState, removeOwner, removePropertyChangeListener, setCaption, setDescription, setEnabled, setIcon, setShortcut, setShortcutCombination, setVisible
public static final java.lang.String ID
protected ScreenBuilders screenBuilders
protected io.jmix.core.AccessManager accessManager
protected ActionScreenInitializer screenInitializer
protected java.util.function.Predicate<LookupScreen.ValidationContext<E>> selectValidator
@Nullable public OpenMode getOpenMode()
setOpenMode(OpenMode)
or in the screen XML.
Otherwise returns null.getOpenMode
in interface Action.ScreenOpeningAction
@StudioPropertiesItem public void setOpenMode(@Nullable OpenMode openMode)
setOpenMode
in interface Action.ScreenOpeningAction
openMode
- the open mode to set@Nullable public java.lang.String getScreenId()
setScreenId(String)
or in the screen XML.
Otherwise returns null.getScreenId
in interface Action.ScreenOpeningAction
@StudioPropertiesItem public void setScreenId(@Nullable java.lang.String screenId)
setScreenId
in interface Action.ScreenOpeningAction
screenId
- the screen id to set@Nullable public java.lang.Class<? extends Screen> getScreenClass()
setScreenClass(Class)
or in the screen XML.
Otherwise returns null.getScreenClass
in interface Action.ScreenOpeningAction
@StudioPropertiesItem public void setScreenClass(@Nullable java.lang.Class<? extends Screen> screenClass)
setScreenClass
in interface Action.ScreenOpeningAction
screenClass
- the screen class to setpublic void setScreenOptionsSupplier(java.util.function.Supplier<ScreenOptions> screenOptionsSupplier)
ScreenOptions
to the
opened screen.
The preferred way to set the supplier is using a controller method annotated with Install
, e.g.:
@Install(to = "petsTable.add", subject = "screenOptionsSupplier") protected ScreenOptions petsTableAddScreenOptionsSupplier() { return new MapScreenOptions(ParamsMap.of("someParameter", 10)); }
setScreenOptionsSupplier
in interface Action.ScreenOpeningAction
public void setScreenConfigurer(java.util.function.Consumer<Screen> screenConfigurer)
The preferred way to set the configurer is using a controller method annotated with Install
, e.g.:
@Install(to = "petsTable.add", subject = "screenConfigurer") protected void petsTableAddScreenConfigurer(Screen lookupScreen) { ((PetBrowse) lookupScreen).setSomeParameter(someValue); }
setScreenConfigurer
in interface Action.ScreenOpeningAction
public void setAfterCloseHandler(java.util.function.Consumer<Screen.AfterCloseEvent> afterCloseHandler)
The preferred way to set the handler is using a controller method annotated with Install
, e.g.:
@Install(to = "petsTable.add", subject = "afterCloseHandler") protected void petsTableAddAfterCloseHandler(AfterCloseEvent event) { if (event.closedWith(StandardOutcome.SELECT)) { System.out.println("Selected"); } }
setAfterCloseHandler
in interface Action.ScreenOpeningAction
public void setSelectValidator(java.util.function.Predicate<LookupScreen.ValidationContext<E>> selectValidator)
The preferred way to set the validator is using a controller method annotated with Install
, e.g.:
@Install(to = "petsTable.add", subject = "selectValidator") protected void petsTableAddSelectValidator(LookupScreen.ValidationContext<Pet> context) { return checkSelected(context.getSelectedItems()); }
public void setTransformation(java.util.function.Function<java.util.Collection<E>,java.util.Collection<E>> transformation)
The preferred way to set the function is using a controller method annotated with Install
, e.g.:
@Install(to = "petsTable.add", subject = "transformation") protected Collection<Pet> petsTableAddTransformation(Collection<Pet> entities) { return doTransform(entities); }
@Autowired protected void setIcons(Icons icons)
@Autowired protected void setMessages(io.jmix.core.Messages messages)
@Autowired public void setSecurity(io.jmix.core.AccessManager accessManager)
@Autowired public void setScreenBuilders(ScreenBuilders screenBuilders)
protected boolean isPermitted()
BaseAction
isPermitted
in class BaseAction
public void actionPerform(Component component)
Action
actionPerform
in interface Action
actionPerform
in class BaseAction
component
- invoking componentpublic void execute()
execute
in interface Action.ExecutableAction