org.apache.myfaces.renderkit.html.util
Class NonBufferingAddResource

java.lang.Object
  extended by org.apache.myfaces.renderkit.html.util.NonBufferingAddResource
All Implemented Interfaces:
AddResource
Direct Known Subclasses:
DefaultAddResource

public class NonBufferingAddResource
extends Object
implements AddResource

Since:
1.1.7
Author:
Martin Marinschek

Field Summary
protected  String _contextPath
           
protected  org.apache.commons.logging.Log log
           
protected static String PATH_SEPARATOR
           
 
Fields inherited from interface org.apache.myfaces.renderkit.html.util.AddResource
BODY_END, BODY_ONLOAD, HEADER_BEGIN
 
Constructor Summary
NonBufferingAddResource()
           
 
Method Summary
 void addInlineScriptAtPosition(javax.faces.context.FacesContext context, ResourcePosition position, String inlineScript)
          Adds the given Inline Script at the specified document position.
 void addInlineStyleAtPosition(javax.faces.context.FacesContext context, ResourcePosition position, String inlineStyle)
          Adds the given Inline Style at the specified document position.
 void addJavaScriptAtPosition(javax.faces.context.FacesContext context, ResourcePosition position, Class myfacesCustomComponent, String resourceName)
          Insert a [script src="url"] entry into the document header at the specified document position.
 void addJavaScriptAtPosition(javax.faces.context.FacesContext context, ResourcePosition position, Class myfacesCustomComponent, String resourceName, boolean defer)
          Insert a [script src="url"] entry into the document header at the specified document position.
 void addJavaScriptAtPosition(javax.faces.context.FacesContext context, ResourcePosition position, ResourceHandler resourceHandler)
          Adds the given Javascript resource to the document header at the specified document positioy by supplying a resourcehandler instance.
 void addJavaScriptAtPosition(javax.faces.context.FacesContext context, ResourcePosition position, ResourceHandler resourceHandler, boolean defer)
          Adds the given Javascript resource at the specified document position.
 void addJavaScriptAtPosition(javax.faces.context.FacesContext context, ResourcePosition position, String uri)
          Insert a [script src="url"] entry into the document header at the specified document position.
 void addJavaScriptAtPosition(javax.faces.context.FacesContext context, ResourcePosition position, String uri, boolean defer)
          Adds the given Javascript resource at the specified document position.
 void addJavaScriptAtPositionPlain(javax.faces.context.FacesContext context, ResourcePosition position, Class myfacesCustomComponent, String resourceName)
          Adds the given Javascript resource at the specified document position.
 void addJavaScriptHere(javax.faces.context.FacesContext context, Class myfacesCustomComponent, String resourceName)
          Insert a [script src="url"] entry at the current location in the response.
 void addJavaScriptHere(javax.faces.context.FacesContext context, ResourceHandler resourceHandler)
          Insert a [script src="url"] entry at the current location in the response.
 void addJavaScriptHere(javax.faces.context.FacesContext context, String uri)
          Insert a [script src="url"] entry at the current location in the response.
 void addJavaScriptHerePlain(javax.faces.context.FacesContext context, String uri)
          Insert a [script src="url"] entry at the current location in the response.
In constrast to the other methods this will not encode the url.
 void addJavaScriptToBodyTag(javax.faces.context.FacesContext context, String javascriptEventName, String addedJavaScript)
          Deprecated.  
 void addResourceHere(javax.faces.context.FacesContext context, ResourceHandler resourceHandler)
           
 void addStyleSheet(javax.faces.context.FacesContext context, ResourcePosition position, Class myfacesCustomComponent, String resourceName)
          Adds the given Style Sheet at the specified document position.
 void addStyleSheet(javax.faces.context.FacesContext context, ResourcePosition position, ResourceHandler resourceHandler)
          Adds the given Style Sheet at the specified document position.
 void addStyleSheet(javax.faces.context.FacesContext context, ResourcePosition position, String uri)
          Adds the given Style Sheet at the specified document position.
protected  long getCacheKey(javax.faces.context.FacesContext context)
          Return a value used in the {cacheKey} part of a generated URL for a resource reference.
protected  String getResourceUri(javax.faces.context.FacesContext context, Class resourceLoader, boolean withContextPath)
          Get the Path used to retrieve an resource.
 String getResourceUri(javax.faces.context.FacesContext context, Class myfacesCustomComponent, String resource)
           
 String getResourceUri(javax.faces.context.FacesContext context, Class myfacesCustomComponent, String resource, boolean withContextPath)
          Return a URI that can be embedded into an HTML page to reference a resource from a Tomahawk jarfile.
 String getResourceUri(javax.faces.context.FacesContext context, ResourceHandler resourceHandler)
          Get the Path used to retrieve an resource.
 String getResourceUri(javax.faces.context.FacesContext context, ResourceHandler resourceHandler, boolean withContextPath)
          Get the Path used to retrieve an resource.
 String getResourceUri(javax.faces.context.FacesContext context, String uri)
          Get the Path used to retrieve an resource.
 String getResourceUri(javax.faces.context.FacesContext context, String uri, boolean withContextPath)
          Get the Path used to retrieve an resource.
 boolean hasHeaderBeginInfos()
          check there is something to write to the header
 boolean isResourceUri(javax.servlet.ServletContext servletContext, javax.servlet.http.HttpServletRequest request)
           
 void parseResponse(javax.servlet.http.HttpServletRequest request, String bufferedResponse, javax.servlet.http.HttpServletResponse response)
          Parses the response to mark the positions where code will be inserted
 boolean requiresBuffer()
          return true if you require the complete response buffered
 void responseFinished()
          called when the response has finished
 void responseStarted()
          called when the response start
 void serveResource(javax.servlet.ServletContext context, javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
           
 void setContextPath(String contextPath)
          the context path for the web-app.
You can set the context path only once, every subsequent set will throw an SecurityException
protected  void validateResourceHandler(ResourceHandler resourceHandler)
          Verify that the resource handler is acceptable.
protected  void validateResourceLoader(Class resourceloader)
          Given a Class object, verify that the instances of that class implement the ResourceLoader interface.
protected static void writeInlineScript(javax.faces.context.ResponseWriter writer, String inlineScript)
           
protected static void writeInlineStylesheet(javax.faces.context.ResponseWriter writer, String inlineStyle)
           
protected static void writeJavaScriptReference(javax.faces.context.FacesContext context, String resourceUri, boolean encoding, boolean defer)
           
protected static void writeJavaScriptReference(javax.servlet.http.HttpServletResponse response, javax.faces.context.ResponseWriter writer, String resourceUri, boolean encoding, boolean defer)
           
 void writeMyFacesJavascriptBeforeBodyEnd(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Writes the javascript code necessary for myfaces in every page, just befode the closing </body> tag
 void writeResponse(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Writes the response
protected static void writeStyleReference(javax.faces.context.FacesContext context, String resourceUri)
           
protected static void writeStyleReference(javax.servlet.http.HttpServletResponse response, javax.faces.context.ResponseWriter writer, String resourceUri)
           
 void writeWithFullHeader(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
          Add the resources to the <head> of the page.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

PATH_SEPARATOR

protected static final String PATH_SEPARATOR
See Also:
Constant Field Values

_contextPath

protected String _contextPath

log

protected org.apache.commons.logging.Log log
Constructor Detail

NonBufferingAddResource

public NonBufferingAddResource()
Method Detail

setContextPath

public void setContextPath(String contextPath)
the context path for the web-app.
You can set the context path only once, every subsequent set will throw an SecurityException

Specified by:
setContextPath in interface AddResource

addJavaScriptHere

public void addJavaScriptHere(javax.faces.context.FacesContext context,
                              Class myfacesCustomComponent,
                              String resourceName)
                       throws IOException
Insert a [script src="url"] entry at the current location in the response. The resource is expected to be in the classpath, at the same location as the specified component + "/resource".

Example: when customComponent is class example.Widget, and resourceName is script.js, the resource will be retrieved from "example/Widget/resource/script.js" in the classpath.

Specified by:
addJavaScriptHere in interface AddResource
Throws:
IOException

addJavaScriptHere

public void addJavaScriptHere(javax.faces.context.FacesContext context,
                              String uri)
                       throws IOException
Insert a [script src="url"] entry at the current location in the response.

Specified by:
addJavaScriptHere in interface AddResource
Parameters:
uri - is the location of the desired resource, relative to the base directory of the webapp (ie its contextPath).
Throws:
IOException

writeJavaScriptReference

protected static void writeJavaScriptReference(javax.faces.context.FacesContext context,
                                               String resourceUri,
                                               boolean encoding,
                                               boolean defer)
                                        throws IOException
Throws:
IOException

writeJavaScriptReference

protected static void writeJavaScriptReference(javax.servlet.http.HttpServletResponse response,
                                               javax.faces.context.ResponseWriter writer,
                                               String resourceUri,
                                               boolean encoding,
                                               boolean defer)
                                        throws IOException
Throws:
IOException

writeStyleReference

protected static void writeStyleReference(javax.faces.context.FacesContext context,
                                          String resourceUri)
                                   throws IOException
Throws:
IOException

writeStyleReference

protected static void writeStyleReference(javax.servlet.http.HttpServletResponse response,
                                          javax.faces.context.ResponseWriter writer,
                                          String resourceUri)
                                   throws IOException
Throws:
IOException

writeInlineScript

protected static void writeInlineScript(javax.faces.context.ResponseWriter writer,
                                        String inlineScript)
                                 throws IOException
Throws:
IOException

writeInlineStylesheet

protected static void writeInlineStylesheet(javax.faces.context.ResponseWriter writer,
                                            String inlineStyle)
                                     throws IOException
Throws:
IOException

addJavaScriptHerePlain

public void addJavaScriptHerePlain(javax.faces.context.FacesContext context,
                                   String uri)
                            throws IOException
Description copied from interface: AddResource
Insert a [script src="url"] entry at the current location in the response.
In constrast to the other methods this will not encode the url. So ,depending on the use case, it wont work in cookie-only environments.

Specified by:
addJavaScriptHerePlain in interface AddResource
uri - is the location of the desired resource, relative to the base directory of the webapp (ie its contextPath).
Throws:
IOException

addJavaScriptHere

public void addJavaScriptHere(javax.faces.context.FacesContext context,
                              ResourceHandler resourceHandler)
                       throws IOException
Insert a [script src="url"] entry at the current location in the response.

Specified by:
addJavaScriptHere in interface AddResource
Parameters:
context - The current faces-context
resourceHandler - is an object which specifies exactly how to build the url that is emitted into the script tag. Code which needs to generate URLs in ways that this class does not support by default can implement a custom ResourceHandler.
Throws:
IOException

addResourceHere

public void addResourceHere(javax.faces.context.FacesContext context,
                            ResourceHandler resourceHandler)
                     throws IOException
Specified by:
addResourceHere in interface AddResource
Throws:
IOException

validateResourceHandler

protected void validateResourceHandler(ResourceHandler resourceHandler)
Verify that the resource handler is acceptable. Null is not valid, and the getResourceLoaderClass method must return a Class object whose instances implements the ResourceLoader interface.

Parameters:
resourceHandler - handler to check

validateResourceLoader

protected void validateResourceLoader(Class resourceloader)
Given a Class object, verify that the instances of that class implement the ResourceLoader interface.

Parameters:
resourceloader - loader to check

addJavaScriptAtPosition

public void addJavaScriptAtPosition(javax.faces.context.FacesContext context,
                                    ResourcePosition position,
                                    ResourceHandler resourceHandler)
Description copied from interface: AddResource
Adds the given Javascript resource to the document header at the specified document positioy by supplying a resourcehandler instance.

Use this method to have full control about building the reference url to identify the resource and to customize how the resource is written to the response. In most cases, however, one of the convenience methods on this class can be used without requiring a custom ResourceHandler to be provided.

If the script has already been referenced, it's added only once.

Note that this method queues the javascript for insertion, and that the script is inserted into the buffered response by the ExtensionsFilter after the page is complete.

Specified by:
addJavaScriptAtPosition in interface AddResource

addJavaScriptAtPosition

public void addJavaScriptAtPosition(javax.faces.context.FacesContext context,
                                    ResourcePosition position,
                                    Class myfacesCustomComponent,
                                    String resourceName)
Description copied from interface: AddResource
Insert a [script src="url"] entry into the document header at the specified document position. If the script has already been referenced, it's added only once.

The resource is expected to be in the classpath, at the same location as the specified component + "/resource".

Example: when customComponent is class example.Widget, and resourceName is script.js, the resource will be retrieved from "example/Widget/resource/script.js" in the classpath.

Specified by:
addJavaScriptAtPosition in interface AddResource

addJavaScriptAtPosition

public void addJavaScriptAtPosition(javax.faces.context.FacesContext context,
                                    ResourcePosition position,
                                    Class myfacesCustomComponent,
                                    String resourceName,
                                    boolean defer)
Description copied from interface: AddResource
Insert a [script src="url"] entry into the document header at the specified document position. If the script has already been referenced, it's added only once.

Specified by:
addJavaScriptAtPosition in interface AddResource
defer - specifies whether the html attribute "defer" is set on the generated script tag. If this is true then the browser will continue processing the html page without waiting for the specified script to load and be run.

addJavaScriptAtPosition

public void addJavaScriptAtPosition(javax.faces.context.FacesContext context,
                                    ResourcePosition position,
                                    String uri)
Description copied from interface: AddResource
Insert a [script src="url"] entry into the document header at the specified document position. If the script has already been referenced, it's added only once.

Specified by:
addJavaScriptAtPosition in interface AddResource
uri - is the location of the desired resource, relative to the base directory of the webapp (ie its contextPath).

addJavaScriptAtPosition

public void addJavaScriptAtPosition(javax.faces.context.FacesContext context,
                                    ResourcePosition position,
                                    String uri,
                                    boolean defer)
Description copied from interface: AddResource
Adds the given Javascript resource at the specified document position. If the script has already been referenced, it's added only once.

Specified by:
addJavaScriptAtPosition in interface AddResource

addJavaScriptToBodyTag

public void addJavaScriptToBodyTag(javax.faces.context.FacesContext context,
                                   String javascriptEventName,
                                   String addedJavaScript)
Deprecated. 

Specified by:
addJavaScriptToBodyTag in interface AddResource
Parameters:
context -
javascriptEventName -
addedJavaScript -

addJavaScriptAtPosition

public void addJavaScriptAtPosition(javax.faces.context.FacesContext context,
                                    ResourcePosition position,
                                    ResourceHandler resourceHandler,
                                    boolean defer)
Description copied from interface: AddResource
Adds the given Javascript resource at the specified document position. If the script has already been referenced, it's added only once.

Specified by:
addJavaScriptAtPosition in interface AddResource

addJavaScriptAtPositionPlain

public void addJavaScriptAtPositionPlain(javax.faces.context.FacesContext context,
                                         ResourcePosition position,
                                         Class myfacesCustomComponent,
                                         String resourceName)
Description copied from interface: AddResource
Adds the given Javascript resource at the specified document position. If the script has already been referenced, it's added only once.
In constrast to the other methods this will not encode the url. So ,depending on the use case, it wont work in cookie-only environments.

Specified by:
addJavaScriptAtPositionPlain in interface AddResource

addStyleSheet

public void addStyleSheet(javax.faces.context.FacesContext context,
                          ResourcePosition position,
                          Class myfacesCustomComponent,
                          String resourceName)
Description copied from interface: AddResource
Adds the given Style Sheet at the specified document position. If the style sheet has already been referenced, it's added only once.

Specified by:
addStyleSheet in interface AddResource

addStyleSheet

public void addStyleSheet(javax.faces.context.FacesContext context,
                          ResourcePosition position,
                          String uri)
Description copied from interface: AddResource
Adds the given Style Sheet at the specified document position. If the style sheet has already been referenced, it's added only once.

Specified by:
addStyleSheet in interface AddResource

addStyleSheet

public void addStyleSheet(javax.faces.context.FacesContext context,
                          ResourcePosition position,
                          ResourceHandler resourceHandler)
Description copied from interface: AddResource
Adds the given Style Sheet at the specified document position. If the style sheet has already been referenced, it's added only once.

Specified by:
addStyleSheet in interface AddResource

addInlineStyleAtPosition

public void addInlineStyleAtPosition(javax.faces.context.FacesContext context,
                                     ResourcePosition position,
                                     String inlineStyle)
Description copied from interface: AddResource
Adds the given Inline Style at the specified document position.

Specified by:
addInlineStyleAtPosition in interface AddResource

addInlineScriptAtPosition

public void addInlineScriptAtPosition(javax.faces.context.FacesContext context,
                                      ResourcePosition position,
                                      String inlineScript)
Description copied from interface: AddResource
Adds the given Inline Script at the specified document position.

Specified by:
addInlineScriptAtPosition in interface AddResource

getResourceUri

public String getResourceUri(javax.faces.context.FacesContext context,
                             Class myfacesCustomComponent,
                             String resource,
                             boolean withContextPath)
Description copied from interface: AddResource
Return a URI that can be embedded into an HTML page to reference a resource from a Tomahawk jarfile.

This method is intended for internal use by the Tomahawk project only, and will not serve resources for other projects (unless a custom AddResource implementation has been configured). Non-tomahawk code should use the variants that take an explicit ResourceHandler class.

Parameter myfacesCustomComponent is a tomahawk class that the resource is associated with. The resource is then expected to be in the classpath in the same package as the specified class (or a subpackage).

Parameter resource is a path relative to the .class file of the specified myfacesCustomComponent class. Param withContextPath controls whether the webapp name is prefixed to the generated url.

Specified by:
getResourceUri in interface AddResource

getResourceUri

public String getResourceUri(javax.faces.context.FacesContext context,
                             Class myfacesCustomComponent,
                             String resource)
Specified by:
getResourceUri in interface AddResource

getResourceUri

public String getResourceUri(javax.faces.context.FacesContext context,
                             ResourceHandler resourceHandler)
Get the Path used to retrieve an resource.

Specified by:
getResourceUri in interface AddResource

getResourceUri

public String getResourceUri(javax.faces.context.FacesContext context,
                             ResourceHandler resourceHandler,
                             boolean withContextPath)
Get the Path used to retrieve an resource.

Specified by:
getResourceUri in interface AddResource

getResourceUri

public String getResourceUri(javax.faces.context.FacesContext context,
                             String uri)
Get the Path used to retrieve an resource.

Specified by:
getResourceUri in interface AddResource

getResourceUri

public String getResourceUri(javax.faces.context.FacesContext context,
                             String uri,
                             boolean withContextPath)
Get the Path used to retrieve an resource.

Specified by:
getResourceUri in interface AddResource

getResourceUri

protected String getResourceUri(javax.faces.context.FacesContext context,
                                Class resourceLoader,
                                boolean withContextPath)
Get the Path used to retrieve an resource.

Parameters:
context - current faces-context
resourceLoader - resourceLoader
withContextPath - use the context-path of the web-app when accessing the resources
Returns:
the URI of the resource

getCacheKey

protected long getCacheKey(javax.faces.context.FacesContext context)
Return a value used in the {cacheKey} part of a generated URL for a resource reference.

Caching in browsers normally works by having files served to them include last-modified and expiry-time http headers. Until the expiry time is reached, a browser will silently use its cached version. After the expiry time, it will send a "get if modified since {time}" message, where {time} is the last-modified header from the version it has cached.

Unfortunately this scheme only works well for resources represented as plain files on disk, where the webserver can easily and efficiently see the last-modified time of the resource file. When that query has to be processed by a servlet that doesn't scale well, even when it is possible to determine the resource's last-modified date from servlet code.

Fortunately, for the AddResource class a static resource is only ever accessed because a URL was embedded by this class in a dynamic page. This makes it possible to implement caching by instead marking every resource served with a very long expiry time, but forcing the URL that points to the resource to change whenever the old cached version becomes invalid; the browser effectively thinks it is fetching a different resource that it hasn't seen before. This is implemented by embedding a "cache key" in the generated URL.

Rather than using the actual modification date of a resource as the cache key, we simply use the webapp deployment time. This means that all data cached by browsers will become invalid after a webapp deploy (all the urls to the resources change). It also means that changes that occur to a resource without a webapp redeploy will not be seen by browsers.

Parameters:
context - the current faces-context
Returns:
the key for caching

isResourceUri

public boolean isResourceUri(javax.servlet.ServletContext servletContext,
                             javax.servlet.http.HttpServletRequest request)
Specified by:
isResourceUri in interface AddResource

serveResource

public void serveResource(javax.servlet.ServletContext context,
                          javax.servlet.http.HttpServletRequest request,
                          javax.servlet.http.HttpServletResponse response)
                   throws IOException
Specified by:
serveResource in interface AddResource
Throws:
IOException

parseResponse

public void parseResponse(javax.servlet.http.HttpServletRequest request,
                          String bufferedResponse,
                          javax.servlet.http.HttpServletResponse response)
                   throws IOException
Description copied from interface: AddResource
Parses the response to mark the positions where code will be inserted

Specified by:
parseResponse in interface AddResource
Throws:
IOException

writeMyFacesJavascriptBeforeBodyEnd

public void writeMyFacesJavascriptBeforeBodyEnd(javax.servlet.http.HttpServletRequest request,
                                                javax.servlet.http.HttpServletResponse response)
                                         throws IOException
Description copied from interface: AddResource
Writes the javascript code necessary for myfaces in every page, just befode the closing </body> tag

Specified by:
writeMyFacesJavascriptBeforeBodyEnd in interface AddResource
Throws:
IOException

writeWithFullHeader

public void writeWithFullHeader(javax.servlet.http.HttpServletRequest request,
                                javax.servlet.http.HttpServletResponse response)
                         throws IOException
Description copied from interface: AddResource
Add the resources to the <head> of the page. If the head tag is missing, but the <body> tag is present, the head tag is added. If both are missing, no resource is added. The ordering is such that the user header CSS & JS override the MyFaces' ones.

Specified by:
writeWithFullHeader in interface AddResource
Throws:
IOException

writeResponse

public void writeResponse(javax.servlet.http.HttpServletRequest request,
                          javax.servlet.http.HttpServletResponse response)
                   throws IOException
Description copied from interface: AddResource
Writes the response

Specified by:
writeResponse in interface AddResource
Throws:
IOException

requiresBuffer

public boolean requiresBuffer()
Description copied from interface: AddResource
return true if you require the complete response buffered

Specified by:
requiresBuffer in interface AddResource

responseStarted

public void responseStarted()
Description copied from interface: AddResource
called when the response start

Specified by:
responseStarted in interface AddResource

responseFinished

public void responseFinished()
Description copied from interface: AddResource
called when the response has finished

Specified by:
responseFinished in interface AddResource

hasHeaderBeginInfos

public boolean hasHeaderBeginInfos()
Description copied from interface: AddResource
check there is something to write to the header

Specified by:
hasHeaderBeginInfos in interface AddResource


Copyright © 2012 The Apache Software Foundation. All Rights Reserved.