javax.faces.application
Class ResourceWrapper

java.lang.Object
  extended by javax.faces.application.Resource
      extended by javax.faces.application.ResourceWrapper
All Implemented Interfaces:
FacesWrapper<Resource>

public abstract class ResourceWrapper
extends Resource
implements FacesWrapper<Resource>

Provides a simple implementation of Resource that can be subclassed by developers wishing to provide specialized behavior to an existing Resource instance. The default implementation of all methods is to call through to the wrapped Resource.

Usage: extend this class and override getWrapped() to return the instance we are wrapping.

Since:
2.0

Field Summary
 
Fields inherited from class javax.faces.application.Resource
COMPONENT_RESOURCE_KEY
 
Constructor Summary
ResourceWrapper()
           
 
Method Summary
 java.io.InputStream getInputStream()
          

The default behavior of this method is to call Resource#getInputStream on the wrapped ResourceHandler object.

 java.lang.String getRequestPath()
          

The default behavior of this method is to call Resource#getRequestPath on the wrapped ResourceHandler object.

 java.util.Map<java.lang.String,java.lang.String> getResponseHeaders()
          

The default behavior of this method is to call Resource#getResponseHeaders on the wrapped ResourceHandler object.

 java.net.URL getURL()
          

The default behavior of this method is to call Resource#getURL on the wrapped ResourceHandler object.

abstract  Resource getWrapped()
          

A class that implements this interface uses this method to return an instance of the class being wrapped.

 boolean userAgentNeedsUpdate(FacesContext context)
          

The default behavior of this method is to call Resource#userAgentNeedsUpdate on the wrapped ResourceHandler object.

 
Methods inherited from class javax.faces.application.Resource
getContentType, getLibraryName, getResourceName, setContentType, setLibraryName, setResourceName, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ResourceWrapper

public ResourceWrapper()
Method Detail

getWrapped

public abstract Resource getWrapped()
Description copied from interface: FacesWrapper

A class that implements this interface uses this method to return an instance of the class being wrapped.

Specified by:
getWrapped in interface FacesWrapper<Resource>
Returns:
the instance that we are wrapping.

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException

The default behavior of this method is to call Resource#getInputStream on the wrapped ResourceHandler object.

Specified by:
getInputStream in class Resource
Returns:
an InputStream containing the bytes of the resource.

Any EL expressions present in the resource must be evaluated before serving the bytes of the resource. Note that due to browser and server caching, EL expressions in a resource file will generally only be evaluated once, when the resource is first served up. Therefore, using EL expressions that refer to per-request data is not advisable since this data can become stale.

Throws:
java.io.IOException - if the current request is not a resource request.

getURL

public java.net.URL getURL()

The default behavior of this method is to call Resource#getURL on the wrapped ResourceHandler object.

Specified by:
getURL in class Resource
Returns:
Return an actual URL instance that refers to this resource instance.

getResponseHeaders

public java.util.Map<java.lang.String,java.lang.String> getResponseHeaders()

The default behavior of this method is to call Resource#getResponseHeaders on the wrapped ResourceHandler object.

Specified by:
getResponseHeaders in class Resource
Returns:
a mutable Map<String, String> of headers that will be included with the response.

getRequestPath

public java.lang.String getRequestPath()

The default behavior of this method is to call Resource#getRequestPath on the wrapped ResourceHandler object.

Specified by:
getRequestPath in class Resource
Returns:
the path to this resource, intended to be included in the encoded view that is sent to the browser when sending a faces response.

userAgentNeedsUpdate

public boolean userAgentNeedsUpdate(FacesContext context)

The default behavior of this method is to call Resource#userAgentNeedsUpdate on the wrapped ResourceHandler object.

Specified by:
userAgentNeedsUpdate in class Resource
Returns:
true or false depending on whether or not the user-agent needs an update of this resource.


Submit a bug or feature

Copyright © 2009-2011, Oracle Corporation and/or its affiliates. All Rights Reserved. Use is subject to license terms.

Generated on 10-February-2011 12:41

Scripting on this page tracks web page traffic, but does not change the content in any way.