Package com.vaadin.flow.server

Interface RouteRegistry

    • Method Detail

      • setRoute

        void setRoute​(String path,
              Class<? extends Component> navigationTarget,
              List<Class<? extends RouterLayout>> parentChain)
        Register a navigation target with specified path and given parent layout chain. Any ParentLayout, Route or RouteAlias will be ignored in route handling.
        Parameters:
        path - path to register navigation target to
        navigationTarget - navigation target to register into session scope
        parentChain - chain of parent layouts that should be used with this target
        Throws:
        InvalidRouteConfigurationException - thrown if exact route already defined in this scope

      • removeRoute

        void removeRoute​(Class<? extends Component> navigationTarget)
        Remove the given navigation target route registration.

        Note! this will remove target route and if possible any RouteAlias route that can be found for the class.

        Parameters:
        navigationTarget - navigation target class to remove

      • removeRoute

        void removeRoute​(String path)
        Remove the registration for given path.

        In case navigationTarget is a HasUrlParameter, path argument needs to include the parameter placeholder which is added automatically. Otherwise, using removeRoute(String, Class) is preferred in such a case.

        Parameters:
        path - path for which to remove the navigation target.

      • removeRoute

        void removeRoute​(String path,
                 Class<? extends Component> navigationTarget)
        Remove navigationTarget for the path.

        This method will check if indeed navigationTarget is registered with path.

        In case navigationTarget is a HasUrlParameter, the path needs to be specified exactly as it is in the Route annotation or as it was registered using setRoute(String, Class, List), without the parameter placeholder which is automatically added.

        Parameters:
        path - path to remove from registry
        navigationTarget - path navigation target to remove

      • getRegisteredRoutes

        List<RouteData> getRegisteredRoutes()
        Get the RouteData for all registered navigation targets.
        Returns:
        list of routes available for this registry

      • getNavigationRouteTarget

        NavigationRouteTarget getNavigationRouteTarget​(String url)
        Search for a route target using given navigation url argument.
        Parameters:
        url - the navigation url used to search a route target.
        Returns:
        a NavigationRouteTarget instance containing the RouteTarget and RouteParameters extracted from the url argument according with the route configuration.

      • getRouteTarget

        RouteTarget getRouteTarget​(Class<? extends Component> target,
                           RouteParameters parameters)
        Gets the RouteTarget instance matching the given target component and route parameters.
        Parameters:
        target - a component class which is a navigation target.
        parameters - parameter values that may be used with given target.
        Returns:
        the RouteTarget instance matching the given target component and route parameters.

      • getNavigationTarget

        Optional<Class<? extends Component>> getNavigationTarget​(String url)
        Gets the optional navigation target class for a given path. Returns an empty optional if no navigation target corresponds to the given url.
        Parameters:
        url - the path to get the navigation target for, not null
        Returns:
        optional of the navigation target corresponding to the given path

      • getNavigationTarget

        Optional<Class<? extends Component>> getNavigationTarget​(String url,
                                                         List<String> segments)
        Gets the optional navigation target class for a given Location matching with path segments.
        Parameters:
        url - 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

        Optional<String> getTargetUrl​(Class<? extends Component> navigationTarget)
        Get the url string for given navigation target.
        Parameters:
        navigationTarget - navigation target to get registered route for, not null
        Returns:
        Optional navigation target url string or Optional.empty() if navigation target was not found

      • getTargetUrl

        Optional<String> getTargetUrl​(Class<? extends Component> navigationTarget,
                              RouteParameters parameters)
        Get the url string for given navigation target.
        Parameters:
        navigationTarget - navigation target to get registered route for, not null
        parameters - parameters for the target url.
        Returns:
        Optional navigation target url string or Optional.empty() if navigation target was not found

      • getTemplate

        Optional<String> getTemplate​(Class<? extends Component> navigationTarget)
        Get the main template for given navigation target.

        In case of annotated target the main template is composed of the Route annotation value prefixed by all RoutePrefix values of the parent RouterLayouts chain.

        Parameters:
        navigationTarget - navigation target to get route definition for, not null
        Returns:
        Optional navigation target template string or Optional.empty() if navigation target was not found

      • update

        void update​(Command command)
        Block updates to the registry configuration from other threads until update command has completed. This makes the command changes atomic for the registry as no one else can change the registry state during the command.

        Any other thread trying to configure current registry will be blocked until the update has released all the locks.

        Parameters:
        command - command to execute for the update

      • addRoutesChangeListener

        Registration addRoutesChangeListener​(RoutesChangedListener listener)
        Adds the given route change listener to the registry.
        Parameters:
        listener - listener to be informed on route changes
        Returns:
        registration to remove the listener

      • clean

        void clean()
        Clear all registered routes from the registry.

      • getContext

        VaadinContext getContext()
        Gets the Vaadin context which the registry belongs to.
        Returns:
        the Vaadin context

      • hasMandatoryParameter

        boolean hasMandatoryParameter​(Class<? extends Component> navigationTarget)
        Check if the given navigationTarget requires parameters.
        Parameters:
        navigationTarget - navigation target to check
        Returns:
        true if parameters are required
        Throws:
        NotFoundException - if given navigation target is not registered