Package org.ametys.cms.tag.jcr

Class AbstractJCRTagProvider<T extends Tag>

java.lang.Object

org.apache.avalon.framework.logger.AbstractLogEnabled

org.ametys.cms.tag.AbstractTagProvider<T>

org.ametys.cms.tag.jcr.AbstractJCRTagProvider<T>

Type Parameters:

T - the tag class

All Implemented Interfaces:

TagProvider<T>, PluginAware, Configurable, Contextualizable, LogEnabled

Direct Known Subclasses:

CategoryJCRProvider, CMSJCRTagProvider, JCRThemeProvider, KeywordJCRProvider, ProjectJCRTagProvider

public abstract class AbstractJCRTagProvider<T extends Tag>
extends AbstractTagProvider<T>
implements Contextualizable

Abstract class representing a jcr tag provider.

Field Summary

Fields

Modifier and Type	Field	Description
protected Context	_context	The context
protected static final String	CACHE_REQUEST_ATTRIBUTE	The request attribute name with cache information

Fields inherited from class org.ametys.cms.tag.AbstractTagProvider

_description, _featureName, _id, _label, _pluginName

Constructor Summary

Constructors

Constructor	Description
AbstractJCRTagProvider()

Method Summary

Modifier and Type	Method	Description
protected abstract void	_fillCache(TraversableAmetysObject parentTagNode, T parentTag, Map<String,T> cache)	Fill cache
protected Map<String,T>	_getCache(Map<String,Object> contextualParameters)	Get the Map of tags by their unique name
protected ModifiableTraversableAmetysObject	_getOrCreateNode(ModifiableTraversableAmetysObject parentNode, String nodeName, String nodeType)	Get a node or create it if not exist.
void	clearCache()	Clear the request cache
void	configure(Configuration configuration)
void	contextualize(Context context)
abstract ModifiableTraversableAmetysObject	getRootNode(Map<String,Object> contextualParameters)	Get the root node for tags
T	getTag(String tagName, Map<String,Object> contextualParameters)	Returns the provider's tag.
Map<String,T>	getTags(Map<String,Object> contextualParameters)	Returns the provider's tags.
boolean	hasTag(String tagName, Map<String,Object> contextualParameters)	Determines if the tag exists.

Methods inherited from class org.ametys.cms.tag.AbstractTagProvider

configureDescription, configureLabel, getDescription, getId, getLabel, getPluginName, setPluginInfo

Methods inherited from class org.apache.avalon.framework.logger.AbstractLogEnabled

enableLogging, getLogger, setupLogger, setupLogger, setupLogger

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.ametys.cms.tag.TagProvider

getTags

Field Details

CACHE_REQUEST_ATTRIBUTE

protected static final String CACHE_REQUEST_ATTRIBUTE

The request attribute name with cache information

_context

protected Context _context

The context

Constructor Details

AbstractJCRTagProvider

public AbstractJCRTagProvider()

Method Details

configure

public void configure(Configuration configuration)
               throws ConfigurationException

Specified by:

configure in interface Configurable

Overrides:

configure in class AbstractTagProvider<T extends Tag>

Throws:

ConfigurationException

contextualize

public void contextualize(Context context)
                   throws ContextException

Specified by:

contextualize in interface Contextualizable

Throws:

ContextException

_getCache

protected Map<String,T> _getCache(Map<String,Object> contextualParameters)
                           throws javax.jcr.RepositoryException

Get the Map of tags by their unique name

Parameters:

contextualParameters - The contextual parameters

Returns:

The non null cache

Throws:

javax.jcr.RepositoryException - If the cache cannot be filled

clearCache

public void clearCache()

Clear the request cache

getTags

public Map<String,T> getTags(Map<String,Object> contextualParameters)

Description copied from interface: TagProvider

Returns the provider's tags.

Specified by:

getTags in interface TagProvider<T extends Tag>

Parameters:

contextualParameters - contextual parameters

Returns:

the provider's tags.

getTag

public T getTag(String tagName,
 Map<String,Object> contextualParameters)

Description copied from interface: TagProvider

Returns the provider's tag.

Specified by:

getTag in interface TagProvider<T extends Tag>

Parameters:

tagName - The tag name

contextualParameters - contextual parameters

Returns:

the provider's tag.

hasTag

public boolean hasTag(String tagName,
 Map<String,Object> contextualParameters)

Description copied from interface: TagProvider

Determines if the tag exists.

Specified by:

hasTag in interface TagProvider<T extends Tag>

Parameters:

tagName - The tag unique name

contextualParameters - contextual parameters

Returns:

true if the tag exists.

_fillCache

protected abstract void _fillCache(TraversableAmetysObject parentTagNode,
 T parentTag,
 Map<String,T> cache)
                            throws javax.jcr.RepositoryException

Fill cache

Parameters:

parentTagNode - The parent tag node

parentTag - The parent tag

cache - The cache

Throws:

javax.jcr.RepositoryException - If an error occurred

getRootNode

public abstract ModifiableTraversableAmetysObject getRootNode(Map<String,Object> contextualParameters)
                                                       throws javax.jcr.RepositoryException

Get the root node for tags

Parameters:

contextualParameters - The contextual parameters

Returns:

The root node

Throws:

javax.jcr.RepositoryException - if an error occurred

_getOrCreateNode

protected ModifiableTraversableAmetysObject _getOrCreateNode(ModifiableTraversableAmetysObject parentNode,
 String nodeName,
 String nodeType)
                                                      throws AmetysRepositoryException

Get a node or create it if not exist.

Parameters:

parentNode - the parent node

nodeName - the node name

nodeType - the node type

Returns:

the node

Throws:

AmetysRepositoryException - if an error occurred