io.jmix.ui.action.list

Class RelatedAction

java.lang.Object

io.jmix.ui.action.AbstractAction

io.jmix.ui.action.BaseAction

io.jmix.ui.action.ListAction

io.jmix.ui.action.list.SecuredListAction

io.jmix.ui.action.list.RelatedAction

All Implemented Interfaces:

Action, Action.AdjustWhenScreenReadOnly, Action.ExecutableAction, Action.HasPrimaryState, Action.HasSecurityConstraint, Action.HasTarget, Action.ScreenOpeningAction, Action.SecuredAction

@StudioAction(target="io.jmix.ui.component.ListComponent",
              description="Opens a browser screen with list of related entities")
 @ActionType(value="related")
public class RelatedAction
extends SecuredListAction
implements Action.AdjustWhenScreenReadOnly, Action.ScreenOpeningAction, Action.ExecutableAction

Nested Class Summary

Nested classes/interfaces inherited from class io.jmix.ui.action.BaseAction

BaseAction.EnabledRule

Nested classes/interfaces inherited from interface io.jmix.ui.action.Action

Action.ActionPerformedEvent, Action.AdjustWhenScreenReadOnly, Action.ExecutableAction, Action.HasPrimaryState, Action.HasSecurityConstraint, Action.HasTarget, Action.MainTabSheetAction, Action.ScreenOpeningAction, Action.SecuredAction, Action.Status

Field Summary

Fields

Modifier and Type	Field and Description
protected java.lang.String	configurationName
static java.lang.String	ID
protected io.jmix.core.metamodel.model.MetaProperty	metaProperty
protected java.lang.String	property
protected RelatedEntitiesSupport	relatedEntitiesSupport
protected ActionScreenInitializer	screenInitializer

Fields inherited from class io.jmix.ui.action.list.SecuredListAction

accessManager, constraintEntityOp, metadata

Fields inherited from class io.jmix.ui.action.ListAction

target

Fields inherited from class io.jmix.ui.action.AbstractAction

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

Fields inherited from interface io.jmix.ui.action.Action

PROP_CAPTION, PROP_DESCRIPTION, PROP_ENABLED, PROP_ICON, PROP_SHORTCUT, PROP_VISIBLE

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
void	actionPerform(Component component) Invoked by owning component to execute the action.
void	execute() Executes the Action
java.lang.String	getConfigurationName()
io.jmix.core.metamodel.model.MetaProperty	getMetaProperty()
OpenMode	getOpenMode() Returns the screen open mode if it was set by Action.ScreenOpeningAction.setOpenMode(OpenMode) or in the screen XML, otherwise returns null.
java.lang.String	getProperty()
java.lang.Class<? extends Screen>	getScreenClass() Returns the screen class if it was set by Action.ScreenOpeningAction.setScreenClass(Class) or in the screen XML, otherwise returns null.
java.lang.String	getScreenId() Returns the screen id if it was set by Action.ScreenOpeningAction.setScreenId(String) or in the screen XML, otherwise returns null.
void	setAfterCloseHandler(java.util.function.Consumer<Screen.AfterCloseEvent> afterCloseHandler) Sets the handler to be invoked when the editor screen closes.
void	setConfigurationName(java.lang.String configurationName) Sets the caption that will be set to filter in opened screen.
void	setMetaProperty(io.jmix.core.metamodel.model.MetaProperty metaProperty) Sets the MetaProperty from which you want to show related entities.
void	setOpenMode(OpenMode openMode) Sets the screen open mode.
void	setProperty(java.lang.String property) Sets the property from which you want to show related entities.
void	setRelatedEntitiesApi(RelatedEntitiesSupport relatedEntitiesSupport)
void	setScreenClass(java.lang.Class<? extends Screen> screenClass) Sets the screen class.
void	setScreenConfigurer(java.util.function.Consumer<Screen> screenConfigurer) Sets the screen configurer.
void	setScreenId(java.lang.String screenId) Sets the screen id.
void	setScreenOptionsSupplier(java.util.function.Supplier<ScreenOptions> screenOptionsSupplier) Sets the screen options supplier.

Methods inherited from class io.jmix.ui.action.list.SecuredListAction

getConstraintEntityOp, isApplicable, isPermitted, setAccessManager, setConstraintEntityOp, setMetadata

Methods inherited from class io.jmix.ui.action.ListAction

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

Methods inherited from class io.jmix.ui.action.BaseAction

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

Methods inherited from class io.jmix.ui.action.AbstractAction

addOwner, addPropertyChangeListener, firePropertyChange, getCaption, getDescription, getEventHub, getIcon, getId, getOwner, getOwners, getShortcutCombination, hasSubscriptions, isEnabled, isPrimary, isVisible, removeOwner, removePropertyChangeListener, setCaption, setDescription, setIcon, 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 io.jmix.ui.action.Action.AdjustWhenScreenReadOnly

isDisabledWhenScreenReadOnly

Methods inherited from interface io.jmix.ui.action.Action

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

Field Detail

ID

public static final java.lang.String ID

See Also:

Constant Field Values

relatedEntitiesSupport

protected RelatedEntitiesSupport relatedEntitiesSupport

screenInitializer

protected ActionScreenInitializer screenInitializer

metaProperty

protected io.jmix.core.metamodel.model.MetaProperty metaProperty

property

protected java.lang.String property

configurationName

protected java.lang.String configurationName

Constructor Detail

RelatedAction

public RelatedAction()

RelatedAction

public RelatedAction(java.lang.String id)

Method Detail

setRelatedEntitiesApi

@Autowired
public void setRelatedEntitiesApi(RelatedEntitiesSupport relatedEntitiesSupport)

getOpenMode

@Nullable
public OpenMode getOpenMode()

Description copied from interface: Action.ScreenOpeningAction

Returns the screen open mode if it was set by Action.ScreenOpeningAction.setOpenMode(OpenMode) or in the screen XML, otherwise returns null.

Specified by:

getOpenMode in interface Action.ScreenOpeningAction

setOpenMode

@StudioPropertiesItem
public void setOpenMode(@Nullable
                                              OpenMode openMode)

Description copied from interface: Action.ScreenOpeningAction

Sets the screen open mode.

Specified by:

setOpenMode in interface Action.ScreenOpeningAction

Parameters:

openMode - the open mode to set

getScreenId

@Nullable
public java.lang.String getScreenId()

Description copied from interface: Action.ScreenOpeningAction

Returns the screen id if it was set by Action.ScreenOpeningAction.setScreenId(String) or in the screen XML, otherwise returns null.

Specified by:

getScreenId in interface Action.ScreenOpeningAction

setScreenId

@StudioPropertiesItem
public void setScreenId(@Nullable
                                              java.lang.String screenId)

Description copied from interface: Action.ScreenOpeningAction

Sets the screen id.

Specified by:

setScreenId in interface Action.ScreenOpeningAction

Parameters:

screenId - the screen id to set

getScreenClass

@Nullable
public java.lang.Class<? extends Screen> getScreenClass()

Description copied from interface: Action.ScreenOpeningAction

Returns the screen class if it was set by Action.ScreenOpeningAction.setScreenClass(Class) or in the screen XML, otherwise returns null.

Specified by:

getScreenClass in interface Action.ScreenOpeningAction

setScreenClass

@StudioPropertiesItem
public void setScreenClass(@Nullable
                                                 java.lang.Class<? extends Screen> screenClass)

Description copied from interface: Action.ScreenOpeningAction

Sets the screen class.

Specified by:

setScreenClass in interface Action.ScreenOpeningAction

Parameters:

screenClass - the screen class to set

setScreenOptionsSupplier

public void setScreenOptionsSupplier(java.util.function.Supplier<ScreenOptions> screenOptionsSupplier)

Description copied from interface: Action.ScreenOpeningAction

Sets the screen options supplier. The supplier provides 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.view", subject = "screenOptionsSupplier")
 protected ScreenOptions petsTableViewScreenOptionsSupplier() {
     return new MapScreenOptions(ParamsMap.of("someParameter", 10));
 }
 

Specified by:

setScreenOptionsSupplier in interface Action.ScreenOpeningAction

setScreenConfigurer

public void setScreenConfigurer(java.util.function.Consumer<Screen> screenConfigurer)

Description copied from interface: Action.ScreenOpeningAction

Sets the screen configurer. Use the configurer if you need to provide parameters to the opened screen through setters.

The preferred way to set the configurer is using a controller method annotated with Install, e.g.:

 @Install(to = "petsTable.view", subject = "screenConfigurer")
 protected void petsTableViewScreenConfigurer(Screen editorScreen) {
     ((PetEdit) editorScreen).setSomeParameter(someValue);
 }
 

Specified by:

setScreenConfigurer in interface Action.ScreenOpeningAction

setAfterCloseHandler

public void setAfterCloseHandler(java.util.function.Consumer<Screen.AfterCloseEvent> afterCloseHandler)

Description copied from interface: Action.ScreenOpeningAction

Sets the handler to be invoked when the editor screen closes.

The preferred way to set the handler is using a controller method annotated with Install, e.g.:

 @Install(to = "petsTable.view", subject = "afterCloseHandler")
 protected void petsTableViewAfterCloseHandler(AfterCloseEvent event) {
     if (event.closedWith(StandardOutcome.COMMIT)) {
         System.out.println("Committed");
     }
 }
 

Specified by:

setAfterCloseHandler in interface Action.ScreenOpeningAction

getMetaProperty

@Nullable
public io.jmix.core.metamodel.model.MetaProperty getMetaProperty()

Returns:

the MetaProperty from which you want to show related entities

setMetaProperty

public void setMetaProperty(@Nullable
                            io.jmix.core.metamodel.model.MetaProperty metaProperty)

Sets the MetaProperty from which you want to show related entities.

Parameters:

metaProperty - the MetaProperty to set

getProperty

@Nullable
public java.lang.String getProperty()

Returns:

the property from which you want to show related entities

setProperty

@StudioPropertiesItem
public void setProperty(@Nullable
                                              java.lang.String property)

Sets the property from which you want to show related entities.

Parameters:

property - the property to set

getConfigurationName

@Nullable
public java.lang.String getConfigurationName()

Returns:

the caption that will be set to filter in opened screen

setConfigurationName

@StudioPropertiesItem
public void setConfigurationName(@Nullable
                                                       java.lang.String configurationName)

Sets the caption that will be set to filter in opened screen.

Parameters:

configurationName - the caption to set

actionPerform

public void actionPerform(Component component)

Description copied from interface: Action

Invoked by owning component to execute the action.

Specified by:

actionPerform in interface Action

Overrides:

actionPerform in class BaseAction

Parameters:

component - invoking component

execute

public void execute()

Description copied from interface: Action.ExecutableAction

Executes the Action

Specified by:

execute in interface Action.ExecutableAction