Package io.jmix.flowui.view.navigation

Class DetailViewClassNavigator<E,V extends View<?>>

java.lang.Object

io.jmix.flowui.view.navigation.AbstractViewNavigator

io.jmix.flowui.view.navigation.DetailViewNavigator<E>

io.jmix.flowui.view.navigation.DetailViewClassNavigator<E,V>

Type Parameters:

E - the type of the entity managed by the detail view

V - the type of the view being navigated to, which extends View

All Implemented Interfaces:

SupportsAfterViewNavigationHandler<V>

Direct Known Subclasses:

EnhancedDetailViewClassNavigator

public class DetailViewClassNavigator<E,V extends View<?>>
extends DetailViewNavigator<E>
implements SupportsAfterViewNavigationHandler<V>

Facilitates navigation to a detail view of a specific type with additional configuration options. This class extends DetailViewNavigator to provide the ability to specify a particular view class and handle additional navigation scenarios like executing a callback after successful navigation to a view.

Nested Class Summary

Nested classes/interfaces inherited from interface io.jmix.flowui.view.navigation.SupportsAfterViewNavigationHandler

SupportsAfterViewNavigationHandler.AfterViewNavigationEvent<V>

Field Summary

Fields

Modifier and Type	Field	Description
protected Consumer<SupportsAfterViewNavigationHandler.AfterViewNavigationEvent<V>>	afterNavigationHandler
protected Class<V>	viewClass

Fields inherited from class io.jmix.flowui.view.navigation.DetailViewNavigator

editedEntity, entityClass, mode, readOnly

Fields inherited from class io.jmix.flowui.view.navigation.AbstractViewNavigator

backwardNavigation, handler, origin, queryParameters, routeParameters, viewId

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DetailViewClassNavigator(DetailViewNavigator<E> viewNavigator, Class<V> viewClass)
	DetailViewClassNavigator(View<?> origin, Class<E> entityClass, Consumer<? extends DetailViewNavigator<E>> handler, Class<V> viewClass)
	DetailViewClassNavigator(Class<E> entityClass, Consumer<? extends DetailViewNavigator<E>> handler, Class<V> viewClass)	Deprecated, for removal: This API element is subject to removal in a future version.

Method Summary

Modifier and Type	Method	Description
DetailViewClassNavigator<E,V>	editEntity(E entity)
Optional<Consumer<SupportsAfterViewNavigationHandler.AfterViewNavigationEvent<V>>>	getAfterNavigationHandler()
Optional<Class<? extends View>>	getViewClass()
DetailViewClassNavigator<E,V>	newEntity()
DetailViewClassNavigator<E,V>	withAfterNavigationHandler(Consumer<SupportsAfterViewNavigationHandler.AfterViewNavigationEvent<V>> handler)	Adds a handler that will be invoked if navigation to a view actually happened.
DetailViewClassNavigator<E,V>	withBackwardNavigation(boolean backwardNavigation)	Sets whether the current URL should be navigated to when the opened view is closed.
DetailViewClassNavigator<E,V>	withQueryParameters(com.vaadin.flow.router.QueryParameters queryParameters)	Sets URL query parameters.
DetailViewClassNavigator<E,V>	withReadOnly(boolean readOnly)
DetailViewClassNavigator<E,V>	withRouteParameters(com.vaadin.flow.router.RouteParameters routeParameters)	Sets URL route parameters.
DetailViewClassNavigator<E,V>	withViewId(String viewId)	Sets the opened view by id.

Methods inherited from class io.jmix.flowui.view.navigation.DetailViewNavigator

getEditedEntity, getEntityClass, getMode, isReadOnly, withViewClass

Methods inherited from class io.jmix.flowui.view.navigation.AbstractViewNavigator

getOrigin, getQueryParameters, getRouteParameters, getViewId, isBackwardNavigation, navigate

Methods inherited from class java.lang.Object

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

Field Details

viewClass

protected Class<V extends View<?>> viewClass

afterNavigationHandler

protected Consumer<SupportsAfterViewNavigationHandler.AfterViewNavigationEvent<V extends View<?>>> afterNavigationHandler

Constructor Details

DetailViewClassNavigator

@Deprecated(since="2.3",
            forRemoval=true)
public DetailViewClassNavigator(Class<E> entityClass,
 Consumer<? extends DetailViewNavigator<E>> handler,
 Class<V> viewClass)

Deprecated, for removal: This API element is subject to removal in a future version.

DetailViewClassNavigator

public DetailViewClassNavigator(View<?> origin,
 Class<E> entityClass,
 Consumer<? extends DetailViewNavigator<E>> handler,
 Class<V> viewClass)

DetailViewClassNavigator

protected DetailViewClassNavigator(DetailViewNavigator<E> viewNavigator,
 Class<V> viewClass)

Method Details

newEntity

public DetailViewClassNavigator<E,V> newEntity()

Overrides:

newEntity in class DetailViewNavigator<E>

editEntity

public DetailViewClassNavigator<E,V> editEntity(E entity)

Overrides:

editEntity in class DetailViewNavigator<E>

withViewId

public DetailViewClassNavigator<E,V> withViewId(@Nullable
 String viewId)

Description copied from class: AbstractViewNavigator

Sets the opened view by id.

Overrides:

withViewId in class DetailViewNavigator<E>

Parameters:

viewId - identifier of the view as specified in the ViewController annotation

Returns:

this instance for chaining

withRouteParameters

public DetailViewClassNavigator<E,V> withRouteParameters(@Nullable
 com.vaadin.flow.router.RouteParameters routeParameters)

Description copied from class: AbstractViewNavigator

Sets URL route parameters.

Overrides:

withRouteParameters in class DetailViewNavigator<E>

Parameters:

routeParameters - route parameters

Returns:

this instance for chaining

withQueryParameters

public DetailViewClassNavigator<E,V> withQueryParameters(@Nullable
 com.vaadin.flow.router.QueryParameters queryParameters)

Description copied from class: AbstractViewNavigator

Sets URL query parameters.

Overrides:

withQueryParameters in class DetailViewNavigator<E>

Parameters:

queryParameters - query parameters

Returns:

this instance for chaining

withBackwardNavigation

public DetailViewClassNavigator<E,V> withBackwardNavigation(boolean backwardNavigation)

Description copied from class: AbstractViewNavigator

Sets whether the current URL should be navigated to when the opened view is closed.

Overrides:

withBackwardNavigation in class DetailViewNavigator<E>

Parameters:

backwardNavigation - whether the current URL should be registered for backward navigation

Returns:

this instance for chaining

withReadOnly

public DetailViewClassNavigator<E,V> withReadOnly(boolean readOnly)

Overrides:

withReadOnly in class DetailViewNavigator<E>

withAfterNavigationHandler

public DetailViewClassNavigator<E,V> withAfterNavigationHandler(Consumer<SupportsAfterViewNavigationHandler.AfterViewNavigationEvent<V>> handler)

Adds a handler that will be invoked if navigation to a view actually happened.

Note: this handler is invoked after all lifecycle events of a view.

Example of setting a custom parameter to a view:

     viewNavigators.detailView(Foo.class)
         .newEntity()
         .withViewClass(FooDetailView.class)
         .withAfterNavigationHandler(navigationEvent -> {
             FooDetailView view = navigationEvent.getView();
             view.setBar("bar");
         }).navigate();
 

Parameters:

handler - a handler to set

Returns:

this instance for chaining

getAfterNavigationHandler

public Optional<Consumer<SupportsAfterViewNavigationHandler.AfterViewNavigationEvent<V>>> getAfterNavigationHandler()

Specified by:

getAfterNavigationHandler in interface SupportsAfterViewNavigationHandler<E>

Returns:

a handler that must be called if navigation to a view actually happened

getViewClass

public Optional<Class<? extends View>> getViewClass()

Overrides:

getViewClass in class AbstractViewNavigator

Returns:

opened view class