com.haulmont.cuba.gui.actions.picker

Class LookupAction<E extends Entity>

java.lang.Object

com.haulmont.cuba.gui.components.AbstractAction

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

com.haulmont.cuba.gui.actions.picker.LookupAction<E>

Type Parameters:

E - type of entity

All Implemented Interfaces:

Action, Action.ExecutableAction, Action.HasPrimaryState, Action.SecuredAction, PickerField.PickerFieldAction, org.springframework.beans.factory.InitializingBean

@StudioAction(category="Picker Actions",
              description="Sets an entity to the picker field using the entity lookup screen")
 @ActionType(value="picker_lookup")
public class LookupAction<E extends Entity>
extends BaseAction
implements PickerField.PickerFieldAction, org.springframework.beans.factory.InitializingBean, Action.ExecutableAction

Standard action for setting an entity to the picker field using the entity lookup screen.

Should be defined for PickerField or its subclass in a screen XML descriptor.

The action instance can be parameterized using the nested properties XML element or programmatically in the screen controller.

Nested Class Summary

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.AdjustWhenScreenReadOnly, Action.BeforeActionPerformedHandler, Action.DisabledWhenScreenReadOnly, Action.ExecutableAction, Action.HasBeforeActionPerformedHandler, Action.HasOpenType, Action.HasPrimaryState, Action.HasSecurityConstraint, Action.HasTarget, Action.SecuredAction, Action.Status

Field Summary

Fields

Modifier and Type	Field and Description
protected Configuration	configuration
protected boolean	editable
protected Icons	icons
static java.lang.String	ID
protected Messages	messages
protected PickerField	pickerField
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

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.PickerField.PickerFieldAction

PROP_EDITABLE

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
LookupAction()
LookupAction(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	afterPropertiesSet()
void	editableChanged(PickerField pickerField, boolean editable)
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	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.
boolean	isEditable()
void	setAfterCloseHandler(java.util.function.Consumer<Screen.AfterCloseEvent> afterCloseHandler) Sets the handler to be invoked when the lookup screen closes.
protected void	setConfiguration(Configuration configuration)
protected void	setEditable(boolean editable)
protected void	setIcons(Icons icons)
protected void	setMessages(Messages messages)
void	setOpenMode(OpenMode openMode) Sets the lookup screen open mode.
void	setPickerField(PickerField pickerField)
void	setScreenClass(java.lang.Class 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	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.

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

addActionPerformedListener, addEnabledRule, isApplicable, isEnabledByRule, isEnabledByUiPermissions, isPermitted, isVisibleByUiPermissions, refreshState, removeEnabledRule, setEnabled, setEnabledByUiPermissions, setEnabledInternal, setVisible, setVisibleByUiPermissions, setVisibleInternal, withCaption, withDescription, withHandler, withIcon, withPrimary, withShortcut

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

ID

public static final java.lang.String ID

See Also:

Constant Field Values

pickerField

protected PickerField pickerField

screenBuilders

@Inject
protected ScreenBuilders screenBuilders

icons

protected Icons icons

messages

protected Messages messages

configuration

protected Configuration configuration

editable

protected boolean editable

screenInitializer

protected ActionScreenInitializer screenInitializer

selectValidator

protected java.util.function.Predicate<LookupScreen.ValidationContext<E extends Entity>> selectValidator

transformation

protected java.util.function.Function<java.util.Collection<E extends Entity>,java.util.Collection<E extends Entity>> transformation

Constructor Detail

LookupAction

public LookupAction()

LookupAction

public LookupAction(java.lang.String id)

Method Detail

getOpenMode

@Nullable
public OpenMode getOpenMode()

Returns the lookup screen open mode if it was set by setOpenMode(OpenMode) or in the screen XML. Otherwise returns null.

setOpenMode

@StudioPropertiesItem
public void setOpenMode(OpenMode openMode)

Sets the lookup screen open mode.

getScreenId

@Nullable
public java.lang.String getScreenId()

Returns the lookup screen id if it was set by setScreenId(String) or in the screen XML. Otherwise returns null.

setScreenId

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

Sets the lookup screen id.

getScreenClass

@Nullable
public java.lang.Class getScreenClass()

Returns the lookup screen class if it was set by setScreenClass(Class) or in the screen XML. Otherwise returns null.

setScreenClass

@StudioPropertiesItem
public void setScreenClass(java.lang.Class screenClass)

Sets the lookup screen id.

setScreenOptionsSupplier

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

Sets the lookup 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 = "petField.lookup", subject = "screenOptionsSupplier")
 protected ScreenOptions petFieldLookupScreenOptionsSupplier() {
     return new MapScreenOptions(ParamsMap.of("someParameter", 10));
 }
 

setScreenConfigurer

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

Sets the lookup 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 = "petField.lookup", subject = "screenConfigurer")
 protected void petFieldLookupScreenConfigurer(Screen lookupScreen) {
     ((PetBrowse) lookupScreen).setSomeParameter(someValue);
 }
 

setAfterCloseHandler

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

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

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

 @Install(to = "petField.lookup", subject = "afterCloseHandler")
 protected void petFieldLookupAfterCloseHandler(AfterCloseEvent event) {
     CloseAction closeAction = event.getCloseAction();
     System.out.println("Closed with " + closeAction);
 }
 

setSelectValidator

public 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.

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

 @Install(to = "petField.lookup", subject = "selectValidator")
 protected void petFieldLookupSelectValidator(LookupScreen.ValidationContext<Pet> context) {
     return checkSelected(context.getSelectedItems());
 }
 

setTransformation

public 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.

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

 @Install(to = "petField.lookup", subject = "transformation")
 protected Collection<Pet> petFieldLookupTransformation(Collection<Pet> entities) {
     return doTransform(entities);
 }
 

setPickerField

public void setPickerField(PickerField pickerField)

Specified by:

setPickerField in interface PickerField.PickerFieldAction

editableChanged

public void editableChanged(PickerField pickerField,
                            boolean editable)

Specified by:

editableChanged in interface PickerField.PickerFieldAction

isEditable

public boolean isEditable()

Specified by:

isEditable in interface PickerField.PickerFieldAction

setEditable

protected void setEditable(boolean editable)

setIcons

@Inject
protected void setIcons(Icons icons)

setMessages

@Inject
protected void setMessages(Messages messages)

setConfiguration

@Inject
protected void setConfiguration(Configuration configuration)

afterPropertiesSet

public void afterPropertiesSet()
                        throws java.lang.Exception

Specified by:

afterPropertiesSet in interface org.springframework.beans.factory.InitializingBean

Throws:

java.lang.Exception

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()

Executes the action.

Specified by:

execute in interface Action.ExecutableAction