com.vaadin.flow.router.internal

Class ConfigureRoutes

java.lang.Object

com.vaadin.flow.router.internal.ConfiguredRoutes

com.vaadin.flow.router.internal.ConfigureRoutes

All Implemented Interfaces:

Serializable

public class ConfigureRoutes
extends ConfiguredRoutes
implements Serializable

Configuration class for editing routes. After editing the class should always be set as a ConfiguredRoutes read only value object.

ConfigureRoutes is always mutable where as ConfiguredRoutes is always immutable.

Since:

1.3

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
ConfigureRoutes() Create an immutable RouteConfiguration.
ConfigureRoutes(ConfiguredRoutes original) Create a mutable or immutable configuration with original configuration information.

Method Summary

Modifier and Type	Method and Description
void	clear() Clear all maps from this configuration.
Map<Class<? extends Exception>,Class<? extends Component>>	getExceptionHandlers() Override so that the getters use the correct exception targets map for data.
protected Map<String,RouteTarget>	getRoutesMap() Override so that the getters use the correct routes map for data.
Map<Class<? extends Component>,String>	getTargetRoutes() Override so that the getters use the correct target routes map for data.
void	removeRoute(Class<? extends Component> targetRoute) Remove the targetRoute completely from the configuration.
void	removeRoute(String path) Remove route for given path.
void	removeRoute(String path, Class<? extends Component> targetRoute) Remove specific navigation target for given route.
void	setErrorRoute(Class<? extends Exception> exception, Class<? extends Component> errorTarget) Set a error route to the configuration.
void	setRoute(String path, Class<? extends Component> navigationTarget) Set a new RouteTarget for the given path.
void	setTargetRoute(Class<? extends Component> navigationTarget, String path) Put a new target route for Class-to-path mapping.

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

getExceptionHandlerByClass, getParentLayouts, getRoute, getRoutePaths, getRoutes, getRouteTarget, getTargetRoute, hasRoute, hasRoute, hasRouteTarget

Methods inherited from class java.lang.Object

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

Constructor Detail

ConfigureRoutes

public ConfigureRoutes()

Create an immutable RouteConfiguration.

ConfigureRoutes

public ConfigureRoutes(ConfiguredRoutes original)

Create a mutable or immutable configuration with original configuration information.

Parameters:

original - original configuration to get data from

Method Detail

getRoutesMap

protected Map<String,RouteTarget> getRoutesMap()

Override so that the getters use the correct routes map for data.

Overrides:

getRoutesMap in class ConfiguredRoutes

Returns:

editable map of routes

getTargetRoutes

public Map<Class<? extends Component>,String> getTargetRoutes()

Override so that the getters use the correct target routes map for data.

Overrides:

getTargetRoutes in class ConfiguredRoutes

Returns:

editable map of targetRoutes

getExceptionHandlers

public Map<Class<? extends Exception>,Class<? extends Component>> getExceptionHandlers()

Override so that the getters use the correct exception targets map for data.

Overrides:

getExceptionHandlers in class ConfiguredRoutes

Returns:

editable map of exception targets

clear

public void clear()

Clear all maps from this configuration.

setRoute

public void setRoute(String path,
                     Class<? extends Component> navigationTarget)

Set a new RouteTarget for the given path.

Note! this will override any previous value.

Parameters:

path - path for which to set route target for

navigationTarget - navigation target to add

setTargetRoute

public void setTargetRoute(Class<? extends Component> navigationTarget,
                           String path)

Put a new target route for Class-to-path mapping.

This is a reverse mapping to RouteTarget, which also handles any HasUrl parameters, for the main route of this navigation target.

Parameters:

navigationTarget - navigation target to map

path - path for given navigation target

setErrorRoute

public void setErrorRoute(Class<? extends Exception> exception,
                          Class<? extends Component> errorTarget)

Set a error route to the configuration.

Any exception handler set for a existing error will override the old exception handler.

Parameters:

exception - exception handled by error route

errorTarget - error navigation target

removeRoute

public void removeRoute(Class<? extends Component> targetRoute)

Remove the targetRoute completely from the configuration.

Parameters:

targetRoute - target registered route to remove

removeRoute

public void removeRoute(String path)

Remove route for given path. This will remove all targets registered for given path.

In case there exists another path mapping for any of the removed route targets the main class-to-string mapping will be updated to the first found.

Parameters:

path - path from which to remove routes from

removeRoute

public void removeRoute(String path,
                        Class<? extends Component> targetRoute)

Remove specific navigation target for given route. The path will still exist if there is another target with different parameters registered to it. If no targets remain the path will be removed completely.

In case there exists another path mapping for the removed route target the main class-to-string mapping will be updated to the first found.

Parameters:

path - path to remove target from

targetRoute - target route to remove from path