Wrapper around a Vaadin Navigator which allows interpreting complex parameterized URI fragments.

This add-on enhances the standard Navigator component with a sophisticated interpreter for URI fragments. Using this add-on, you can design the URI fragments used by your application in an arbitrarily complex hierarchy. Furthermore, your URI fragments can contain any number of parameter values which will be interpreted and converted automatically so that these values can be handled in a type-safe way.

Note that this add-on requires Java 8.

For example, it is possible to use URI fragments like in the following example:

#!home
#!admin/settings
#!admin/users
#!showHistory/start/2017-01-01/end/2017-01-31
#!admin/users/id/4711/profile/activeTab/address

As you can see, these URI fragments form a hierarchy where each individual path element can have an arbitrary number of parameters. Parameter values are converted automatically. So in the example above, the application will only deal with Long and Date objects (and Strings for the activeTab parameter).

The Navigator wrapper from this add-on interprets a URI fragment completely, extracts and converts all parameter values found in it, and at the end of this process creates and executes a predefined action command object which runs the required tasks for this URI fragment.

Such an action command could, for instance, activate some specific view and display data on that view the source of which has been specified through a parameter value in the URI fragment. In addition to that, the action command might configure the displayed view in some specific way, e. g. by bringing a particular tab of a tab sheet to the foreground, depending on some additional parameter value in the URI fragment.

Install

Link to this version
StableReleased 22 April 2017Apache License 2.0
Framework Support
Vaadin 7.0+
Vaadin 8.0+
Browser Independent
Install with
Release notes - Version 1.0.3

Add-on uses most recent version 1.3.0 of library uri-fragment-routing.