Class FacesViewsViewHandler

  • All Implemented Interfaces:

    public class FacesViewsViewHandler
    extends ViewHandlerWrapper
    View handler that renders an action URL extensionless if a resource is a mapped one, and faces views has been set to always render extensionless or if the current request is extensionless, otherwise as-is.

    Implementation note: this is installed by ApplicationProcessor during the PostConstructApplicationEvent, in which it's guaranteed that Faces initialization (typically done via a ServletContextListener) has been done. Setting a view handler programmatically requires the Faces Application to be present which isn't the case before Faces initialization has been done.

    Additionally, the view handler needs to be set BEFORE the first faces request is processed. Putting the view handler setting code in a Filter.init(jakarta.servlet.FilterConfig) method only works when all init methods are called during startup, OR when the filter filters every request.

    For a guide on FacesViews, please see the package summary.

    Arjan Tijms
    See Also:
    FacesViews, ApplicationProcessor
    • Constructor Detail

      • FacesViewsViewHandler

        public FacesViewsViewHandler​(ViewHandler wrapped)
        Construct faces views view handler.
        wrapped - The view handler to be wrapped.
    • Method Detail

      • getBookmarkableURL

        public String getBookmarkableURL​(FacesContext context,
                                         String viewId,
                                         Map<String,​List<String>> parameters,
                                         boolean includeViewParams)
        An override to create bookmarkable URLs via standard outcome target components that take into account <o:pathParam> tags nested in the components. The path parameters will be rendered in the order they were declared for a view id that is defined as a multi view and if the view was not defined as a multi view then they won't be rendered at all. Additionally, declaring path parameters for a non-multi view will be logged as a warning and a faces warning message will be added for Development stage.
        getBookmarkableURL in class ViewHandlerWrapper
        See Also: