io.rogue.faces.application

Class WebAppResource

java.lang.Object

javax.faces.application.ViewResource

javax.faces.application.Resource

javax.faces.application.ResourceWrapper

io.rogue.faces.application.WebAppResource

All Implemented Interfaces:

javax.faces.FacesWrapper<javax.faces.application.Resource>

public class WebAppResource
extends javax.faces.application.ResourceWrapper

A WebAppResource represents a file that is local to the web application. This class is primarily used by the resource handler for rendering web assets (CSS/IMG/JavaScript) by returning a direct access URL instead of returning a JSF resource URL.
Consider the following code layout:

     webapp/
       |
       |-resources/
             |
             |-bootstrap/
                 |
                 |-css/
                    |
                    |- bootstrap.min.css
 

Using standard JSF resource handling, the above css file will get rendered as the following URL:

   /javax.faces.resource/css/bootstrap.min.css.xhtml?ln=bootstrap
 

This kind of a URL causes issues when the CSS file has url(..) references in it as they do not get resolved properly.

The WebAppResource object tries to resolve the target URL to a webapp local location and returns that when getRequestPath() is invoked. So the same above code will end up in a url that looks like the following: /resources/bootstrap/css/bootstrap.min.css

Field Summary

Fields inherited from class javax.faces.application.Resource

COMPONENT_RESOURCE_KEY

Constructor Summary

Constructors

Constructor and Description
WebAppResource(java.lang.String path, javax.faces.application.Resource wrapped)

Method Summary

Modifier and Type	Method and Description
java.lang.String	getRequestPath()
javax.faces.application.Resource	getWrapped()

Methods inherited from class javax.faces.application.ResourceWrapper

getContentType, getInputStream, getLibraryName, getResourceName, getResponseHeaders, getURL, setContentType, setLibraryName, setResourceName, userAgentNeedsUpdate

Methods inherited from class javax.faces.application.Resource

toString

Methods inherited from class java.lang.Object

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

Constructor Detail

WebAppResource

public WebAppResource(java.lang.String path,
                      javax.faces.application.Resource wrapped)

Method Detail

getRequestPath

public java.lang.String getRequestPath()

Overrides:

getRequestPath in class javax.faces.application.ResourceWrapper

getWrapped

public javax.faces.application.Resource getWrapped()

Specified by:

getWrapped in interface javax.faces.FacesWrapper<javax.faces.application.Resource>

Overrides:

getWrapped in class javax.faces.application.ResourceWrapper