org.apache.velocity.tools.view
Class ServletUtils

java.lang.Object
  org.apache.velocity.tools.view.ServletUtils

Direct Known Subclasses:

ServletUtils

public class ServletUtils
extends java.lang.Object

A set of utility methods for supporting and using VelocityTools in the servlet environment.

Version:

$Id: ServletUtils.java 471244 2006-11-04 18:34:38Z henning $

Nested Class Summary

private static class

ServletUtils.SessionMutex

Field Summary

static java.lang.String	ALT_VELOCITY_VIEW_KEY
static java.lang.String	CONFIGURATION_KEY Key used to access a live FactoryConfiguration previously placed in the ServletContext attributes.
static ServletUtils	INSTANCE
static java.lang.String	SHARED_CONFIG_PARAM
static java.lang.String	VELOCITY_VIEW_KEY

Constructor Summary

protected

ServletUtils()

Method Summary

private static VelocityView	createView(java.lang.Class klass, JeeConfig config)
private static VelocityView	createView(JeeConfig config)
static java.lang.Object	findTool(java.lang.String key, javax.servlet.http.HttpServletRequest request)
static java.lang.Object	findTool(java.lang.String key, javax.servlet.http.HttpServletRequest request, javax.servlet.ServletContext application)
static java.lang.Object	findTool(java.lang.String key, javax.servlet.ServletContext application)
static java.lang.Object	findTool(java.lang.String key, java.lang.String toolboxKey, javax.servlet.http.HttpServletRequest request)
static java.lang.Object	findTool(java.lang.String key, java.lang.String toolboxKey, javax.servlet.http.HttpServletRequest request, javax.servlet.ServletContext application)
static java.lang.Object	findTool(java.lang.String key, java.lang.String toolboxKey, javax.servlet.ServletContext application)
static FactoryConfiguration	getConfiguration(javax.servlet.ServletContext application)
static FactoryConfiguration	getConfiguration(java.lang.String path, javax.servlet.ServletContext application)
static FactoryConfiguration	getConfiguration(java.lang.String path, javax.servlet.ServletContext application, boolean deprecationSupportMode)
static java.io.InputStream	getInputStream(java.lang.String path, javax.servlet.ServletContext application)
ServletUtils	getInstance()
static java.lang.Object	getMutex(javax.servlet.http.HttpSession session, java.lang.String key, java.lang.Object caller) Returns a mutex (lock object) unique to the specified session and stored under the specified key to allow for reliable synchronization on the session.
static java.lang.String	getPath(javax.servlet.http.HttpServletRequest request) Retrieves the path for the specified request regardless of whether this is a direct request or an include by the RequestDispatcher.
static VelocityView	getVelocityView(javax.servlet.FilterConfig config) Returns the shared VelocityView for the specified FilterConfig's context.
static VelocityView	getVelocityView(JeeConfig config) Returns the shared VelocityView for the specified JeeConfig's context.
static VelocityView	getVelocityView(javax.servlet.ServletConfig config) Returns the shared VelocityView for the specified ServletConfig's context.
static VelocityView	getVelocityView(javax.servlet.ServletContext application) Returns the shared VelocityView for the specified ServletContext.
static VelocityView	getVelocityView(javax.servlet.ServletContext application, boolean createIfMissing) Returns the shared VelocityView for the specified ServletContext.

Methods inherited from class java.lang.Object

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

Field Detail

VELOCITY_VIEW_KEY

public static final java.lang.String VELOCITY_VIEW_KEY

SHARED_CONFIG_PARAM

public static final java.lang.String SHARED_CONFIG_PARAM

See Also:

Constant Field Values

ALT_VELOCITY_VIEW_KEY

public static final java.lang.String ALT_VELOCITY_VIEW_KEY

See Also:

Constant Field Values

CONFIGURATION_KEY

public static final java.lang.String CONFIGURATION_KEY

Key used to access a live FactoryConfiguration previously placed in the ServletContext attributes.

See Also:

Constant Field Values

INSTANCE

public static final ServletUtils INSTANCE

Constructor Detail

ServletUtils

protected ServletUtils()

Method Detail

getInstance

public ServletUtils getInstance()

getPath

public static java.lang.String getPath(javax.servlet.http.HttpServletRequest request)

Retrieves the path for the specified request regardless of whether this is a direct request or an include by the RequestDispatcher.

getVelocityView

public static VelocityView getVelocityView(javax.servlet.ServletConfig config)

Returns the shared VelocityView for the specified ServletConfig's context. If one has not yet been created, it will create, store it for future access, and then return it.

getVelocityView

public static VelocityView getVelocityView(javax.servlet.FilterConfig config)

Returns the shared VelocityView for the specified FilterConfig's context. If one has not yet been created, it will create, store it for future access, and then return it.

getVelocityView

public static VelocityView getVelocityView(JeeConfig config)

Returns the shared VelocityView for the specified JeeConfig's context. If one has not yet been created, it will create, store it for future access, and then return it.

createView

private static VelocityView createView(JeeConfig config)

createView

private static VelocityView createView(java.lang.Class klass,
                                       JeeConfig config)

getVelocityView

public static VelocityView getVelocityView(javax.servlet.ServletContext application)

Returns the shared VelocityView for the specified ServletContext. If one has not yet been created, it will create one, store it for future access, and then return it.

getVelocityView

public static VelocityView getVelocityView(javax.servlet.ServletContext application,
                                           boolean createIfMissing)

Returns the shared VelocityView for the specified ServletContext. If one has not yet been created and the second parameter is true, then it will create one, store it for future access, and return it.

findTool

public static java.lang.Object findTool(java.lang.String key,
                                        javax.servlet.ServletContext application)

findTool

public static java.lang.Object findTool(java.lang.String key,
                                        java.lang.String toolboxKey,
                                        javax.servlet.ServletContext application)

findTool

public static java.lang.Object findTool(java.lang.String key,
                                        javax.servlet.http.HttpServletRequest request)

findTool

public static java.lang.Object findTool(java.lang.String key,
                                        java.lang.String toolboxKey,
                                        javax.servlet.http.HttpServletRequest request)

findTool

public static java.lang.Object findTool(java.lang.String key,
                                        javax.servlet.http.HttpServletRequest request,
                                        javax.servlet.ServletContext application)

findTool

public static java.lang.Object findTool(java.lang.String key,
                                        java.lang.String toolboxKey,
                                        javax.servlet.http.HttpServletRequest request,
                                        javax.servlet.ServletContext application)

getInputStream

public static java.io.InputStream getInputStream(java.lang.String path,
                                                 javax.servlet.ServletContext application)

getConfiguration

public static FactoryConfiguration getConfiguration(javax.servlet.ServletContext application)

getConfiguration

public static FactoryConfiguration getConfiguration(java.lang.String path,
                                                    javax.servlet.ServletContext application)

getConfiguration

public static FactoryConfiguration getConfiguration(java.lang.String path,
                                                    javax.servlet.ServletContext application,
                                                    boolean deprecationSupportMode)

getMutex

public static java.lang.Object getMutex(javax.servlet.http.HttpSession session,
                                        java.lang.String key,
                                        java.lang.Object caller)

Returns a mutex (lock object) unique to the specified session and stored under the specified key to allow for reliable synchronization on the session.