org.apache.velocity.context
Class InternalContextAdapterImpl

java.lang.Object
  org.apache.velocity.context.InternalContextAdapterImpl

All Implemented Interfaces:

Context, InternalContextAdapter, InternalEventContext, org.apache.velocity.context.InternalHousekeepingContext, InternalWrapperContext

public final class InternalContextAdapterImpl

extends Object

implements InternalContextAdapter

This adapter class is the container for all context types for internal use. The AST now uses this class rather than the app-level Context interface to allow flexibility in the future. Currently, we have two context interfaces which must be supported :

• Context : used for application/template data access
• InternalHousekeepingContext : used for internal housekeeping and caching
• InternalWrapperContext : used for getting root cache context and other such.
• InternalEventContext : for event handling.

This class implements the two interfaces to ensure that all methods are supported. When adding to the interfaces, or adding more context functionality, the interface is the primary definition, so alter that first and then all classes as necessary. As of this writing, this would be the only class affected by changes to InternalContext This class ensures that an InternalContextBase is available for internal use. If an application constructs their own Context-implementing object w/o subclassing AbstractContext, it may be that support for InternalContext is not available. Therefore, InternalContextAdapter will create an InternalContextBase if necessary for this support. Note that if this is necessary, internal information such as node-cache data will be lost from use to use of the context. This may or may not be important, depending upon application.

Version:

$Id: InternalContextAdapterImpl.java 291585 2005-09-26 08:56:23Z henning $

Author:

Geir Magnusson Jr.

Constructor Summary

InternalContextAdapterImpl(Context c)
CTOR takes a Context and wraps it, delegating all 'data' calls to it.

Method Summary

EventCartridge	attachEventCartridge(EventCartridge ec)
boolean	containsKey(Object key) Indicates whether the specified key is in the context.
Object	get(String key) Gets the value corresponding to the provided key from the context.
boolean	getAllowRendering() Checks to see if rendering should be allowed.
InternalContextAdapter	getBaseContext() Returns the base context that we are wrapping.
Resource	getCurrentResource() temporary fix to enable #include() to figure out current encoding.
String	getCurrentTemplateName() get the current template name
EventCartridge	getEventCartridge()
Context	getInternalUserContext() returns the user data context that we are wrapping
Object[]	getKeys() Get all the keys for the values in the context
Object[]	getTemplateNameStack() Returns the template name stack in form of an array.
IntrospectionCacheData	icacheGet(Object key) returns an IntrospectionCache Data (@see IntrospectionCacheData) object if exists for the key
void	icachePut(Object key, IntrospectionCacheData o) places an IntrospectionCache Data (@see IntrospectionCacheData) element in the cache for specified key
void	popCurrentTemplateName() remove the current template name from stack
void	pushCurrentTemplateName(String s) set the current template name on top of stack
Object	put(String key, Object value) Adds a name/value pair to the context.
Object	remove(Object key) Removes the value associated with the specified key from the context.
void	setAllowRendering(boolean v) Set whether rendering is allowed.
void	setCurrentResource(Resource r)

Methods inherited from class java.lang.Object

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

Constructor Detail

InternalContextAdapterImpl

public InternalContextAdapterImpl(Context c)

CTOR takes a Context and wraps it, delegating all 'data' calls to it. For support of internal contexts, it will create an InternalContextBase if need be.

Method Detail

pushCurrentTemplateName

public void pushCurrentTemplateName(String s)

Description copied from interface: org.apache.velocity.context.InternalHousekeepingContext

set the current template name on top of stack

Specified by:

pushCurrentTemplateName in interface org.apache.velocity.context.InternalHousekeepingContext

Parameters:

s - current template name

popCurrentTemplateName

public void popCurrentTemplateName()

Description copied from interface: org.apache.velocity.context.InternalHousekeepingContext

remove the current template name from stack

Specified by:

popCurrentTemplateName in interface org.apache.velocity.context.InternalHousekeepingContext

getCurrentTemplateName

public String getCurrentTemplateName()

Description copied from interface: org.apache.velocity.context.InternalHousekeepingContext

get the current template name

Specified by:

getCurrentTemplateName in interface org.apache.velocity.context.InternalHousekeepingContext

Returns:

String current template name

getTemplateNameStack

public Object[] getTemplateNameStack()

Description copied from interface: org.apache.velocity.context.InternalHousekeepingContext

Returns the template name stack in form of an array.

Specified by:

getTemplateNameStack in interface org.apache.velocity.context.InternalHousekeepingContext

Returns:

Object[] with the template name stack contents.

icacheGet

public IntrospectionCacheData icacheGet(Object key)

Description copied from interface: org.apache.velocity.context.InternalHousekeepingContext

returns an IntrospectionCache Data (@see IntrospectionCacheData) object if exists for the key

Specified by:

icacheGet in interface org.apache.velocity.context.InternalHousekeepingContext

Parameters:

key - key to find in cache

Returns:

cache object

icachePut

public void icachePut(Object key,
                      IntrospectionCacheData o)

Description copied from interface: org.apache.velocity.context.InternalHousekeepingContext

places an IntrospectionCache Data (@see IntrospectionCacheData) element in the cache for specified key

Specified by:

icachePut in interface org.apache.velocity.context.InternalHousekeepingContext

Parameters:

key - key

o - IntrospectionCacheData object to place in cache

setCurrentResource

public void setCurrentResource(Resource r)

Specified by:

setCurrentResource in interface org.apache.velocity.context.InternalHousekeepingContext

getCurrentResource

public Resource getCurrentResource()

Description copied from interface: org.apache.velocity.context.InternalHousekeepingContext

temporary fix to enable #include() to figure out current encoding.

Specified by:

getCurrentResource in interface org.apache.velocity.context.InternalHousekeepingContext

getAllowRendering

public boolean getAllowRendering()

Description copied from interface: org.apache.velocity.context.InternalHousekeepingContext

Checks to see if rendering should be allowed. Defaults to true but will return false after a #stop directive.

Specified by:

getAllowRendering in interface org.apache.velocity.context.InternalHousekeepingContext

Returns:

true if rendering is allowed, false if no rendering should occur

setAllowRendering

public void setAllowRendering(boolean v)

Description copied from interface: org.apache.velocity.context.InternalHousekeepingContext

Set whether rendering is allowed. Defaults to true but is set to false after a #stop directive.

Specified by:

setAllowRendering in interface org.apache.velocity.context.InternalHousekeepingContext

put

public Object put(String key,
                  Object value)

Description copied from interface: Context

Adds a name/value pair to the context.

Specified by:

put in interface Context

Parameters:

key - The name to key the provided value with.

value - The corresponding value.

get

public Object get(String key)

Description copied from interface: Context

Gets the value corresponding to the provided key from the context.

Specified by:

get in interface Context

Parameters:

key - The name of the desired value.

Returns:

The value corresponding to the provided key.

containsKey

public boolean containsKey(Object key)

Description copied from interface: Context

Indicates whether the specified key is in the context.

Specified by:

containsKey in interface Context

Parameters:

key - The key to look for.

Returns:

Whether the key is in the context.

getKeys

public Object[] getKeys()

Description copied from interface: Context

Get all the keys for the values in the context

Specified by:

getKeys in interface Context

remove

public Object remove(Object key)

Description copied from interface: Context

Removes the value associated with the specified key from the context.

Specified by:

remove in interface Context

Parameters:

key - The name of the value to remove.

Returns:

The value that the key was mapped to, or null if unmapped.

getInternalUserContext

public Context getInternalUserContext()

returns the user data context that we are wrapping

Specified by:

getInternalUserContext in interface InternalWrapperContext

getBaseContext

public InternalContextAdapter getBaseContext()

Returns the base context that we are wrapping. Here, its this, but for other thing like VM related context contortions, it can be something else

Specified by:

getBaseContext in interface InternalWrapperContext

attachEventCartridge

public EventCartridge attachEventCartridge(EventCartridge ec)

Specified by:

attachEventCartridge in interface InternalEventContext

getEventCartridge

public EventCartridge getEventCartridge()

Specified by:

getEventCartridge in interface InternalEventContext