com.vaadin.flow.server

Class SessionRouteRegistry

java.lang.Object

com.vaadin.flow.router.internal.AbstractRouteRegistry

com.vaadin.flow.server.SessionRouteRegistry

All Implemented Interfaces:

RouteRegistry, Serializable

public class SessionRouteRegistry
extends AbstractRouteRegistry

SessionRouteRegistry is a mutable route registry that is valid in the scope of VaadinSession. Routes can be added and removed from this registry and any overlap with the registered routes between session and global scope will be handled so that session scope paths overrides global paths.

Since:

1.3

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.vaadin.flow.router.internal.AbstractRouteRegistry

AbstractRouteRegistry.Configuration

Method Summary

Modifier and Type	Method and Description
Registration	addRoutesChangeListener(RoutesChangedListener listener) Adds the given route change listener to the registry.
Optional<Class<? extends Component>>	getNavigationTarget(String pathString) Gets the optional navigation target class for a given path.
Optional<Class<? extends Component>>	getNavigationTarget(String pathString, List<String> segments) Gets the optional navigation target class for a given Location matching with path segments.
List<RouteData>	getRegisteredRoutes() Get the RouteData for all registered navigation targets.
List<Class<? extends RouterLayout>>	getRouteLayouts(String path, Class<? extends Component> navigationTarget) Get the layout chain for given navigation target on the targeted path.
static RouteRegistry	getSessionRegistry(VaadinSession session) Get the session registry for VaadinSession.
Optional<String>	getTargetUrl(Class<? extends Component> navigationTarget) Get the url string for given navigation target.

Methods inherited from class com.vaadin.flow.router.internal.AbstractRouteRegistry

addErrorTarget, clean, configure, fireEvent, getConfiguration, hasLock, removeRoute, removeRoute, removeRoute, searchByCause, searchBySuperType, setRoute, update

Methods inherited from class java.lang.Object

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

Method Detail

getSessionRegistry

public static RouteRegistry getSessionRegistry(VaadinSession session)

Get the session registry for VaadinSession. If no SessionRegistry exists then one will be created for given VaadinSession.

Parameters:

session - vaadin session to get registry for

Returns:

session registry for given session

getRegisteredRoutes

public List<RouteData> getRegisteredRoutes()

Description copied from interface: RouteRegistry

Get the RouteData for all registered navigation targets.

Specified by:

getRegisteredRoutes in interface RouteRegistry

Overrides:

getRegisteredRoutes in class AbstractRouteRegistry

Returns:

list of routes available for this registry

addRoutesChangeListener

public Registration addRoutesChangeListener(RoutesChangedListener listener)

Adds the given route change listener to the registry.

For the session scoped registry also changes to the application scoped registry will be delegated to the listener if the added or removed route was not masked by a registration in the session scope.

Specified by:

addRoutesChangeListener in interface RouteRegistry

Overrides:

addRoutesChangeListener in class AbstractRouteRegistry

Parameters:

listener - listener to add

Returns:

registration to remove the listener

getNavigationTarget

public Optional<Class<? extends Component>> getNavigationTarget(String pathString)

Description copied from interface: RouteRegistry

Gets the optional navigation target class for a given path. Returns an empty optional if no navigation target corresponds to the given path.

Note! If a path has been specifically removed from a registry it will not be served from possible higher lever registries either.

Parameters:

pathString - the path to get the navigation target for, not null

Returns:

optional of the navigation target corresponding to the given path

getNavigationTarget

public Optional<Class<? extends Component>> getNavigationTarget(String pathString,
                                                                List<String> segments)

Description copied from interface: RouteRegistry

Gets the optional navigation target class for a given Location matching with path segments.

Note! If a path has been specifically removed from a registry it will not be served from possible higher lever registries either.

Parameters:

pathString - path to get navigation target for, not null

segments - segments given for path

Returns:

optional navigation target corresponding to the given location with given segments if any applicable targets found.

See Also:

Location

getTargetUrl

public Optional<String> getTargetUrl(Class<? extends Component> navigationTarget)

Description copied from interface: RouteRegistry

Get the url string for given navigation target.

Will return Optional.empty is navigation target was not found.

Specified by:

getTargetUrl in interface RouteRegistry

Overrides:

getTargetUrl in class AbstractRouteRegistry

Parameters:

navigationTarget - navigation target to get registered route for, not null

Returns:

optional navigation target url string

getRouteLayouts

public List<Class<? extends RouterLayout>> getRouteLayouts(String path,
                                                           Class<? extends Component> navigationTarget)

Description copied from interface: RouteRegistry

Get the layout chain for given navigation target on the targeted path.

This chain may be pre-defined or generated from annotation data.

Specified by:

getRouteLayouts in interface RouteRegistry

Overrides:

getRouteLayouts in class AbstractRouteRegistry

Parameters:

path - path to use for resolving chain

navigationTarget - navigation target to get layout chain for

Returns:

layout chain of target