org.omnifaces.component.output

Class Cache

java.lang.Object

javax.faces.component.UIComponent

javax.faces.component.UIComponentBase

org.omnifaces.component.output.OutputFamily

org.omnifaces.component.output.Cache

All Implemented Interfaces:

EventListener, PartialStateHolder, StateHolder, TransientStateHolder, ComponentSystemEventListener, FacesListener, SystemEventListenerHolder

public class Cache
extends OutputFamily

The <o:cache> component allows to cache a fragment of rendered markup. The first request for a page that has this component on it will cause this markup to be put into the cache. Then for subsequent requests the cached content is used directly and none of the components, backing beans and services that were used to generate this content in the first place will be consulted.

Caching can take place in application scope, or in session scope. For individual fragments a time can be specified for which the cached content is valid. After this time is elapsed, the very first request to the page containing the cache component in question will cause new content to be rendered and put into the cache. A default time can be set per scope in web.xml.

For each scope a maximum capacity can be set. If the capacity for that scope is exceeded, an element will be removed following a least recently used policy (LRU).

Via a cache provider mechanism an alternative cache implementation can be configured in web.xml. The default cache is based on http://code.google.com/p/concurrentlinkedhashmap.

Since:

1.1

Author:

Arjan Tijms

See Also:

CacheValue

Field Summary

Fields

Modifier and Type	Field and Description
static String	COMPONENT_TYPE
static String	DEFAULT_SCOPE
static String	END_CONTENT_MARKER
static String	START_CONTENT_MARKER
static String	VALUE_SET

Fields inherited from class org.omnifaces.component.output.OutputFamily

COMPONENT_FAMILY

Fields inherited from class javax.faces.component.UIComponent

ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY

Constructor Summary

Constructors

Constructor and Description
Cache()

Method Summary

Modifier and Type	Method and Description
void	encodeChildren(FacesContext context)
Object	getCacheAttribute(FacesContext context, String name) Gets a named attribute associated with the main cache entry this component is using to store the rendering of its child components.
String	getKey()
String	getScope()
Integer	getTime()
Boolean	isDisabled() Returns whether this cache is disabled.
Boolean	isReset()
Boolean	isUseBuffer()
protected boolean	isVisitable(VisitContext visitContext)
void	setCacheAttribute(FacesContext context, String name, Object value) Sets a named attribute associated with the main cache entry this component is using to store the rendering of its child components.
void	setDisabled(Boolean disabled) Sets whether this cache is disabled.
void	setKey(String keyValue)
void	setReset(Boolean resetValue)
void	setScope(String scopeValue)
void	setTime(Integer timeValue)
void	setUseBuffer(Boolean useBufferValue)

Methods inherited from class org.omnifaces.component.output.OutputFamily

getFamily, getRendersChildren

Methods inherited from class javax.faces.component.UIComponentBase

addClientBehavior, addFacesListener, broadcast, clearInitialState, decode, encodeBegin, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getPassThroughAttributes, getRenderer, getRendererType, getValueBinding, invokeOnComponent, isRendered, isTransient, markInitialState, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, queueEvent, removeFacesListener, restoreAttachedState, restoreState, saveAttachedState, saveState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent

Methods inherited from class javax.faces.component.UIComponent

encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, visitTree

Methods inherited from class java.lang.Object

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

Field Detail

COMPONENT_TYPE

public static final String COMPONENT_TYPE

See Also:

Constant Field Values

VALUE_SET

public static final String VALUE_SET

See Also:

Constant Field Values

DEFAULT_SCOPE

public static final String DEFAULT_SCOPE

See Also:

Constant Field Values

START_CONTENT_MARKER

public static final String START_CONTENT_MARKER

See Also:

Constant Field Values

END_CONTENT_MARKER

public static final String END_CONTENT_MARKER

See Also:

Constant Field Values

Constructor Detail

Cache

public Cache()

Method Detail

encodeChildren

public void encodeChildren(FacesContext context)
                    throws IOException

Overrides:

encodeChildren in class UIComponentBase

Throws:

IOException

getCacheAttribute

public Object getCacheAttribute(FacesContext context,
                                String name)

Gets a named attribute associated with the main cache entry this component is using to store the rendering of its child components.

Parameters:

context - the current FacesContext

name - name of the attribute to retrieve a value for

Returns:

value associated with the named attribute

Since:

1.2

setCacheAttribute

public void setCacheAttribute(FacesContext context,
                              String name,
                              Object value)

Sets a named attribute associated with the main cache entry this component is using to store the rendering of its child components.

Parameters:

context - the current FacesContext

name - name of the attribute under which the value is stored

value - the value that is to be stored

Since:

1.2

isVisitable

protected boolean isVisitable(VisitContext visitContext)

Overrides:

isVisitable in class UIComponent

getKey

public String getKey()

setKey

public void setKey(String keyValue)

getScope

public String getScope()

setScope

public void setScope(String scopeValue)

getTime

public Integer getTime()

setTime

public void setTime(Integer timeValue)

isUseBuffer

public Boolean isUseBuffer()

setUseBuffer

public void setUseBuffer(Boolean useBufferValue)

isReset

public Boolean isReset()

setReset

public void setReset(Boolean resetValue)

isDisabled

public Boolean isDisabled()

Returns whether this cache is disabled.

Returns:

Whether this cache is disabled.

Since:

1.8

setDisabled

public void setDisabled(Boolean disabled)

Sets whether this cache is disabled.

Parameters:

disabled - Whether this cache is disabled.

Since:

1.8