To resolve links to documents in the repository an URL Matcher is used. This URL Matcher makes sure that links in the application are resolved to the right documents. This resolving is based on a mapping, which is defined/determined by the URL Matcher.
To make sure the URLs are resolved, there should be a filter defined in the deployment descriptor, which is set up as a Request Matcher. In the JSF example an ExampleRequestURLMatcher is defined which takes care of the link handling.
The ExampleRequestURLMatcher is defined in:
~/hippo-site-toolkit/jsf-example-app/src/main/java/nl/hippo/client/jsfexample/ExampleRequestURLMatcher.java
The corresponding filter is defined in the deployment descriptor:
<filter>
<filter-name>liveRepositoryFilter</filter-name>
<init-param>
<param-name>requestURLMatcher</param-name>
<param-value>nl.hippo.client.jsfexample.ExampleRequestURLMatcher</param-value>
</init-param>
</filter>