Package io.jmix.flowui.action.list

Class CreateAction<E>

java.lang.Object

io.jmix.flowui.kit.action.AbstractAction

io.jmix.flowui.kit.action.BaseAction<CreateAction<E>>

io.jmix.flowui.action.ObservableBaseAction<CreateAction<E>>

io.jmix.flowui.action.SecuredBaseAction<CreateAction<E>>

io.jmix.flowui.action.list.ListDataComponentAction<CreateAction<E>,E>

io.jmix.flowui.action.list.CreateAction<E>

All Implemented Interfaces:

AdjustWhenViewReadOnly, ExecutableAction, TargetAction<ListDataComponent<E>>, ViewOpeningAction, Action, HasShortcutCombination

Direct Known Subclasses:

EntityInspectorCreateAction

@ActionType("list_create")
public class CreateAction<E>
extends ListDataComponentAction<CreateAction<E>,E>
implements AdjustWhenViewReadOnly, ViewOpeningAction

Nested Class Summary

Nested classes/interfaces inherited from class io.jmix.flowui.action.SecuredBaseAction

SecuredBaseAction.EnabledRule

Nested classes/interfaces inherited from interface io.jmix.flowui.action.ViewOpeningAction

ViewOpeningAction.QueryParametersProvider, ViewOpeningAction.RouteParametersProvider

Field Summary

Fields

Modifier and Type	Field	Description
protected AccessManager	accessManager
protected Consumer<E>	afterSaveHandler
protected DialogWindows	dialogWindows
static final String	ID
protected Consumer<E>	initializer
protected Supplier<E>	newEntitySupplier
protected OpenMode	openMode
protected Function<E,E>	transformation
protected ActionViewInitializer	viewInitializer
protected ViewNavigators	viewNavigators

Fields inherited from class io.jmix.flowui.action.list.ListDataComponentAction

selectionListenerRegistration, target

Fields inherited from class io.jmix.flowui.action.SecuredBaseAction

enabledRules

Fields inherited from class io.jmix.flowui.action.ObservableBaseAction

uiObservationSupport

Fields inherited from class io.jmix.flowui.kit.action.BaseAction

enabledExplicitly, visibleExplicitly

Fields inherited from class io.jmix.flowui.kit.action.AbstractAction

description, enabled, eventBus, icon, id, shortcutCombination, text, variant, visible

Fields inherited from interface io.jmix.flowui.kit.action.Action

PROP_DESCRIPTION, PROP_ENABLED, PROP_ICON, PROP_SHORTCUT_COMBINATION, PROP_TEXT, PROP_VARIANT, PROP_VISIBLE

Constructor Summary

Constructors

Constructor	Description
CreateAction()
CreateAction(String id)

Method Summary

Modifier and Type	Method	Description
void	execute()	Executes the action.
<V extends View<?>> Consumer<DialogWindow.AfterCloseEvent<V>>	getAfterCloseHandler()
@Nullable Consumer<E>	getAfterSaveHandler()
@Nullable Consumer<E>	getInitializer()
@Nullable Supplier<E>	getNewEntitySupplier()
@Nullable OpenMode	getOpenMode()	Returns the view open mode if it was set by ViewOpeningAction.setOpenMode(OpenMode) or in the view XML, otherwise returns null.
@Nullable ViewOpeningAction.QueryParametersProvider	getQueryParametersProvider()
@Nullable ViewOpeningAction.RouteParametersProvider	getRouteParametersProvider()
@Nullable Function<E,E>	getTransformation()
@Nullable Class<? extends View>	getViewClass()	Returns the detail view class if it was set by setViewClass(Class) or in the view XML.
<V extends View<?>> Consumer<V>	getViewConfigurer()
@Nullable String	getViewId()	Returns the detail view id if it was set by setViewId(String) or in the view XML, otherwise returns null.
protected void	initAction()
protected boolean	isPermitted()
protected void	navigate()
protected void	openDialog()
void	setAccessManager(AccessManager accessManager)
<V extends View<?>> void	setAfterCloseHandler(@Nullable Consumer<DialogWindow.AfterCloseEvent<V>> afterCloseHandler)	Sets the handler to be invoked when the detail view closes.
void	setAfterSaveHandler(@Nullable Consumer<E> afterSaveHandler)	Sets the handler to be invoked when the detail view saves the new entity.
void	setDialogWindowBuilders(DialogWindows dialogWindows)
protected void	setIcons(Icons icons)
void	setInitializer(@Nullable Consumer<E> initializer)	Sets the new entity initializer.
protected void	setMessages(Messages messages)
void	setNewEntitySupplier(@Nullable Supplier<E> newEntitySupplier)	Sets the new entity supplier.
void	setOpenMode(@Nullable OpenMode openMode)	Sets the view open mode.
void	setQueryParametersProvider(@Nullable ViewOpeningAction.QueryParametersProvider provider)	Sets query parameters provider that returns query parameters that should be used in the URL.
void	setRouteParametersProvider(@Nullable ViewOpeningAction.RouteParametersProvider provider)	Sets route parameters provider that returns route parameters that should be used in the route template.
void	setTransformation(@Nullable Function<E,E> transformation)	Sets the function to transform the saved in the detail view entity before setting it to the target data container.
protected void	setUiComponentProperties(UiComponentProperties uiComponentProperties)
void	setViewClass(@Nullable Class<? extends View> viewClass)	Sets the detail view class.
<V extends View<?>> void	setViewConfigurer(@Nullable Consumer<V> viewConfigurer)	Sets the view configurer.
void	setViewId(@Nullable String viewId)	Sets the detail view id.
void	setViewNavigators(ViewNavigators viewNavigators)
<V extends View<?>> CreateAction<E>	withAfterCloseHandler(@Nullable Consumer<DialogWindow.AfterCloseEvent<V>> afterCloseHandler)
CreateAction<E>	withAfterSaveHandler(@Nullable Consumer<E> afterSaveHandler)
CreateAction<E>	withInitializer(@Nullable Consumer<E> initializer)
CreateAction<E>	withNewEntitySupplier(@Nullable Supplier<E> newEntitySupplier)
CreateAction<E>	withOpenMode(@Nullable OpenMode openMode)
CreateAction<E>	withQueryParameters(@Nullable ViewOpeningAction.QueryParametersProvider provider)
CreateAction<E>	withRouteParameters(@Nullable ViewOpeningAction.RouteParametersProvider provider)
CreateAction<E>	withTransformation(@Nullable Function<E,E> transformation)
CreateAction<E>	withViewClass(@Nullable Class<? extends View> viewClass)
<V extends View<?>> CreateAction<E>	withViewConfigurer(@Nullable Consumer<V> viewConfigurer)
CreateAction<E>	withViewId(@Nullable String viewId)

Methods inherited from class io.jmix.flowui.action.list.ListDataComponentAction

actionPerform, attachSelectionListener, checkTarget, checkTargetItems, getTarget, onSelectionChange, setTarget, withTarget

Methods inherited from class io.jmix.flowui.action.SecuredBaseAction

addEnabledRule, isEnabledByRule, refreshState, removeEnabledRule

Methods inherited from class io.jmix.flowui.action.ObservableBaseAction

getUiObservationSupport

Methods inherited from class io.jmix.flowui.kit.action.BaseAction

addActionPerformedListener, isApplicable, self, setEnabled, setEnabledInternal, setVisible, setVisibleInternal, withDescription, withEnabled, withHandler, withIcon, withShortcutCombination, withText, withVariant, withVisible

Methods inherited from class io.jmix.flowui.kit.action.AbstractAction

addPropertyChangeListener, firePropertyChange, getDescription, getEventBus, getIcon, getIconComponent, getId, getShortcutCombination, getText, getVariant, hasListener, isEnabled, isVisible, setDescription, setIcon, setIconComponent, setShortcutCombination, setText, setVariant

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.jmix.flowui.kit.action.Action

actionPerform, addPropertyChangeListener, getDescription, getIcon, getIconComponent, getId, getText, getVariant, isEnabled, isVisible, refreshState, setDescription, setEnabled, setIcon, setIconComponent, setText, setVariant, setVisible

Methods inherited from interface io.jmix.flowui.action.AdjustWhenViewReadOnly

isDisabledWhenViewReadOnly

Methods inherited from interface io.jmix.flowui.kit.component.HasShortcutCombination

getShortcutCombination, setShortcutCombination

Field Details

ID

public static final String ID

See Also:

• Constant Field Values

viewNavigators

protected ViewNavigators viewNavigators

dialogWindows

protected DialogWindows dialogWindows

accessManager

protected AccessManager accessManager

viewInitializer

protected ActionViewInitializer viewInitializer

newEntitySupplier

protected Supplier<E> newEntitySupplier

initializer

protected Consumer<E> initializer

afterSaveHandler

protected Consumer<E> afterSaveHandler

transformation

protected Function<E,E> transformation

openMode

protected OpenMode openMode

Constructor Details

CreateAction

public CreateAction()

CreateAction

public CreateAction(String id)

Method Details

initAction

protected void initAction()

Overrides:

initAction in class ListDataComponentAction<CreateAction<E>,E>

getOpenMode

public @Nullable OpenMode getOpenMode()

Description copied from interface: ViewOpeningAction

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

Specified by:

getOpenMode in interface ViewOpeningAction

setOpenMode

public void setOpenMode(@Nullable OpenMode openMode)

Description copied from interface: ViewOpeningAction

Sets the view open mode.

Specified by:

setOpenMode in interface ViewOpeningAction

Parameters:

openMode - the open mode to set

getViewId

public @Nullable String getViewId()

Returns the detail view id if it was set by setViewId(String) or in the view XML, otherwise returns null.

Specified by:

getViewId in interface ViewOpeningAction

setViewId

public void setViewId(@Nullable String viewId)

Sets the detail view id.

Specified by:

setViewId in interface ViewOpeningAction

Parameters:

viewId - the view id to set

getViewClass

public @Nullable Class<? extends View> getViewClass()

Returns the detail view class if it was set by setViewClass(Class) or in the view XML. Otherwise returns null.

Specified by:

getViewClass in interface ViewOpeningAction

setViewClass

public void setViewClass(@Nullable Class<? extends View> viewClass)

Sets the detail view class.

Specified by:

setViewClass in interface ViewOpeningAction

Parameters:

viewClass - the view class to set

getRouteParametersProvider

public @Nullable ViewOpeningAction.RouteParametersProvider getRouteParametersProvider()

Specified by:

getRouteParametersProvider in interface ViewOpeningAction

Returns:

route parameters or null if not set

setRouteParametersProvider

public void setRouteParametersProvider(@Nullable ViewOpeningAction.RouteParametersProvider provider)

Description copied from interface: ViewOpeningAction

Sets route parameters provider that returns route parameters that should be used in the route template.

Note that route parameters provider is set if the detail is opened in OpenMode.NAVIGATION.

Specified by:

setRouteParametersProvider in interface ViewOpeningAction

Parameters:

provider - route parameters provider to set

See Also:

• Route

getQueryParametersProvider

public @Nullable ViewOpeningAction.QueryParametersProvider getQueryParametersProvider()

Specified by:

getQueryParametersProvider in interface ViewOpeningAction

Returns:

query parameters provider or null if not set

setQueryParametersProvider

public void setQueryParametersProvider(@Nullable ViewOpeningAction.QueryParametersProvider provider)

Description copied from interface: ViewOpeningAction

Sets query parameters provider that returns query parameters that should be used in the URL.

Note that query parameters provider is set if the detail is opened in OpenMode.NAVIGATION.

Specified by:

setQueryParametersProvider in interface ViewOpeningAction

Parameters:

provider - query parameters provider to set

setAfterCloseHandler

public <V extends View<?>> void setAfterCloseHandler(@Nullable Consumer<DialogWindow.AfterCloseEvent<V>> afterCloseHandler)

Description copied from interface: ViewOpeningAction

Sets the handler to be invoked when the detail view closes.

Note that handler is invoked if the detail is opened in OpenMode.DIALOG mode.

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.SAVE)) {
         System.out.println("Saved");
     }
 }
 

Specified by:

setAfterCloseHandler in interface ViewOpeningAction

Type Parameters:

V - view type

Parameters:

afterCloseHandler - handler to set

getAfterCloseHandler

public <V extends View<?>>
Consumer<DialogWindow.AfterCloseEvent<V>> getAfterCloseHandler()

Specified by:

getAfterCloseHandler in interface ViewOpeningAction

setViewConfigurer

public <V extends View<?>> void setViewConfigurer(@Nullable Consumer<V> viewConfigurer)

Description copied from interface: ViewOpeningAction

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

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

 @Install(to = "petsTable.view", subject = "viewConfigurer")
 protected void petsTableViewConfigurer(View<?> view) {
     view.setSomeParameter(someValue);
 }
 

Specified by:

setViewConfigurer in interface ViewOpeningAction

getViewConfigurer

public <V extends View<?>> Consumer<V> getViewConfigurer()

Specified by:

getViewConfigurer in interface ViewOpeningAction

setInitializer

public void setInitializer(@Nullable Consumer<E> initializer)

Sets the new entity initializer. The initializer accepts the new entity instance and can perform its initialization.

Note that initializer is invoked if the detail is opened in OpenMode.DIALOG mode.

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

 @Install(to = "petsTable.create", subject = "initializer")
 protected void petsTableCreateInitializer(Pet entity) {
     entity.setName("a cat");
 }
 

getInitializer

public @Nullable Consumer<E> getInitializer()

setAfterSaveHandler

public void setAfterSaveHandler(@Nullable Consumer<E> afterSaveHandler)

Sets the handler to be invoked when the detail view saves the new entity.

Note that handler is invoked if the detail is opened in OpenMode.DIALOG mode.

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

 @Install(to = "petsTable.create", subject = "afterSaveHandler")
 protected void petsTableCreateAfterSaveHandler(Pet entity) {
     System.out.println("Created " + entity);
 }
 

getAfterSaveHandler

public @Nullable Consumer<E> getAfterSaveHandler()

setTransformation

public void setTransformation(@Nullable Function<E,E> transformation)

Sets the function to transform the saved in the detail view entity before setting it to the target data container.

Note that transformation function is invoked if the detail is opened in OpenMode.DIALOG mode.

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

 @Install(to = "petsTable.create", subject = "transformation")
 protected Pet petsTableCreateTransformation(Pet entity) {
     return doTransform(entity);
 }
 

getTransformation

public @Nullable Function<E,E> getTransformation()

setNewEntitySupplier

public void setNewEntitySupplier(@Nullable Supplier<E> newEntitySupplier)

Sets the new entity supplier. The supplier should return a new entity instance.

Note that supplier is invoked if the detail is opened in OpenMode.DIALOG mode.

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

 @Install(to = "petsTable.create", subject = "newEntitySupplier")
 protected Pet petsTableCreateNewEntitySupplier() {
     Pet pet = metadata.create(Pet.class);
     pet.setName("a cat");
     return pet;
 }
 

getNewEntitySupplier

public @Nullable Supplier<E> getNewEntitySupplier()

setMessages

@Autowired
protected void setMessages(Messages messages)

setIcons

@Autowired
protected void setIcons(Icons icons)

setUiComponentProperties

@Autowired
protected void setUiComponentProperties(UiComponentProperties uiComponentProperties)

setViewNavigators

@Autowired
public void setViewNavigators(ViewNavigators viewNavigators)

setAccessManager

@Autowired
public void setAccessManager(AccessManager accessManager)

setDialogWindowBuilders

@Autowired
public void setDialogWindowBuilders(DialogWindows dialogWindows)

isPermitted

protected boolean isPermitted()

Overrides:

isPermitted in class SecuredBaseAction<CreateAction<E>>

execute

public void execute()

Executes the action.

Specified by:

execute in interface ExecutableAction

navigate

protected void navigate()

openDialog

protected void openDialog()

withViewId

public CreateAction<E> withViewId(@Nullable String viewId)

See Also:

• setViewId(String)

withViewClass

public CreateAction<E> withViewClass(@Nullable Class<? extends View> viewClass)

See Also:

• setViewClass(Class)

withRouteParameters

public CreateAction<E> withRouteParameters(@Nullable ViewOpeningAction.RouteParametersProvider provider)

See Also:

• setRouteParametersProvider(RouteParametersProvider)

withQueryParameters

public CreateAction<E> withQueryParameters(@Nullable ViewOpeningAction.QueryParametersProvider provider)

See Also:

• setQueryParametersProvider(QueryParametersProvider)

withOpenMode

public CreateAction<E> withOpenMode(@Nullable OpenMode openMode)

See Also:

• setOpenMode(OpenMode)

withAfterCloseHandler

public <V extends View<?>> CreateAction<E> withAfterCloseHandler(@Nullable Consumer<DialogWindow.AfterCloseEvent<V>> afterCloseHandler)

See Also:

• setAfterCloseHandler(Consumer)

withViewConfigurer

public <V extends View<?>> CreateAction<E> withViewConfigurer(@Nullable Consumer<V> viewConfigurer)

See Also:

• setViewConfigurer(Consumer)

withAfterSaveHandler

public CreateAction<E> withAfterSaveHandler(@Nullable Consumer<E> afterSaveHandler)

See Also:

• setAfterSaveHandler(Consumer)

withTransformation

public CreateAction<E> withTransformation(@Nullable Function<E,E> transformation)

See Also:

• setTransformation(Function)

withInitializer

public CreateAction<E> withInitializer(@Nullable Consumer<E> initializer)

See Also:

• withInitializer(Consumer)

withNewEntitySupplier

public CreateAction<E> withNewEntitySupplier(@Nullable Supplier<E> newEntitySupplier)

See Also:

• setNewEntitySupplier(Supplier)