org.jboss.dna.connector.jbosscache
Class JBossCacheSource

java.lang.Object
  org.jboss.dna.connector.jbosscache.JBossCacheSource

All Implemented Interfaces:

Serializable, Referenceable, ObjectFactory, org.jboss.dna.graph.connectors.RepositorySource

@ThreadSafe
public class JBossCacheSource
extends Object
implements org.jboss.dna.graph.connectors.RepositorySource, ObjectFactory

A repository source that uses a JBoss Cache instance to manage the content. This source is capable of using an existing Cache instance or creating a new instance. This process is controlled entirely by the JavaBean properties of the JBossCacheSource instance.

This source first attempts to find an existing cache in JNDI. If none is found, then it attempts to create a cache instance using the CacheFactory found in JNDI (or the DefaultCacheFactory if no such factory is available) and the cache configuration name if supplied or the default configuration if not set.

Like other RepositorySource classes, instances of JBossCacheSource can be placed into JNDI and do support the creation of JNDI referenceable objects and resolution of references into JBossCacheSource.

Author:

Randall Hauch

See Also:

Serialized Form

Nested Class Summary

protected class

JBossCacheSource.Capabilities

Field Summary

protected static String	CACHE_CONFIGURATION_NAME
protected static String	CACHE_FACTORY_JNDI_NAME
protected static String	CACHE_JNDI_NAME
protected static String	DEFAULT_CACHE_POLICY
static int	DEFAULT_RETRY_LIMIT The default limit is 0 for retrying connection calls to the underlying source.
static String	DEFAULT_UUID_PROPERTY_NAME
protected static String	RETRY_LIMIT
protected static String	ROOT_NODE_UUID
protected static String	SOURCE_NAME
protected static String	UUID_PROPERTY_NAME

Constructor Summary

JBossCacheSource()
Create a repository source instance.

Method Summary

boolean	equals(Object obj)
String	getCacheConfigurationName() Get the name of the configuration that should be used if a cache is to be created using the CacheFactory found in JNDI or the DefaultCacheFactory if needed.
String	getCacheFactoryJndiName() Get the name in JNDI of a CacheFactory instance that should be used to create the cache for this source.
String	getCacheJndiName() Get the name in JNDI of a Cache instance that should be used by this source.
org.jboss.dna.graph.connectors.RepositorySourceCapabilities	getCapabilities()
org.jboss.dna.graph.connectors.RepositoryConnection	getConnection()
protected Context	getContext()
org.jboss.dna.graph.cache.CachePolicy	getDefaultCachePolicy() Get the default cache policy for this source, or null if the global default cache policy should be used
String	getName()
Object	getObjectInstance(Object obj, Name name, Context nameCtx, Hashtable<?,?> environment)
Reference	getReference()
org.jboss.dna.graph.connectors.RepositoryContext	getRepositoryContext()
int	getRetryLimit()
String	getRootNodeUuid() Get the UUID of the root node for the cache.
UUID	getRootNodeUuidObject() Get the UUID of the root node for the cache.
String	getUuidPropertyName() Get the property name where the UUID is stored for each node.
void	initialize(org.jboss.dna.graph.connectors.RepositoryContext context)
void	setCacheConfigurationName(String cacheConfigurationName) Get the name of the configuration that should be used if a cache is to be created using the CacheFactory found in JNDI or the DefaultCacheFactory if needed.
void	setCacheFactoryJndiName(String jndiName) Set the name in JNDI of a CacheFactory instance that should be used to obtain the Cache instance used by this source.
void	setCacheJndiName(String cacheJndiName) Set the name in JNDI of a Cache instance that should be used by this source.
protected void	setContext(Context context)
void	setDefaultCachePolicy(org.jboss.dna.graph.cache.CachePolicy defaultCachePolicy)
void	setName(String name) Set the name of this source
void	setRetryLimit(int limit)
void	setRootNodeUuid(String rootNodeUuid) Set the UUID of the root node in this repository.
void	setUuidPropertyName(String uuidPropertyName) Set the property name where the UUID is stored for each node.

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_RETRY_LIMIT

public static final int DEFAULT_RETRY_LIMIT

The default limit is 0 for retrying connection calls to the underlying source.

See Also:

Constant Field Values

DEFAULT_UUID_PROPERTY_NAME

public static final String DEFAULT_UUID_PROPERTY_NAME

ROOT_NODE_UUID

protected static final String ROOT_NODE_UUID

See Also:

Constant Field Values

SOURCE_NAME

protected static final String SOURCE_NAME

See Also:

Constant Field Values

DEFAULT_CACHE_POLICY

protected static final String DEFAULT_CACHE_POLICY

See Also:

Constant Field Values

CACHE_CONFIGURATION_NAME

protected static final String CACHE_CONFIGURATION_NAME

See Also:

Constant Field Values

CACHE_FACTORY_JNDI_NAME

protected static final String CACHE_FACTORY_JNDI_NAME

See Also:

Constant Field Values

CACHE_JNDI_NAME

protected static final String CACHE_JNDI_NAME

See Also:

Constant Field Values

UUID_PROPERTY_NAME

protected static final String UUID_PROPERTY_NAME

See Also:

Constant Field Values

RETRY_LIMIT

protected static final String RETRY_LIMIT

See Also:

Constant Field Values

Constructor Detail

JBossCacheSource

public JBossCacheSource()

Create a repository source instance.

Method Detail

initialize

public void initialize(org.jboss.dna.graph.connectors.RepositoryContext context)
                throws org.jboss.dna.graph.connectors.RepositorySourceException

Specified by:

initialize in interface org.jboss.dna.graph.connectors.RepositorySource

Throws:

org.jboss.dna.graph.connectors.RepositorySourceException

See Also:

RepositorySource.initialize(org.jboss.dna.graph.connectors.RepositoryContext)

getRepositoryContext

public org.jboss.dna.graph.connectors.RepositoryContext getRepositoryContext()

Returns:

repositoryContext

getName

public String getName()

Specified by:

getName in interface org.jboss.dna.graph.connectors.RepositorySource

getRetryLimit

public int getRetryLimit()

Specified by:

getRetryLimit in interface org.jboss.dna.graph.connectors.RepositorySource

See Also:

RepositorySource.getRetryLimit()

setRetryLimit

public void setRetryLimit(int limit)

Specified by:

setRetryLimit in interface org.jboss.dna.graph.connectors.RepositorySource

See Also:

RepositorySource.setRetryLimit(int)

setName

public void setName(String name)

Set the name of this source

Parameters:

name - the name for this source

getDefaultCachePolicy

public org.jboss.dna.graph.cache.CachePolicy getDefaultCachePolicy()

Get the default cache policy for this source, or null if the global default cache policy should be used

Returns:

the default cache policy, or null if this source has no explicit default cache policy

setDefaultCachePolicy

public void setDefaultCachePolicy(org.jboss.dna.graph.cache.CachePolicy defaultCachePolicy)

Parameters:

defaultCachePolicy - Sets defaultCachePolicy to the specified value.

getCacheJndiName

public String getCacheJndiName()

Get the name in JNDI of a Cache instance that should be used by this source.

This source first attempts to find an existing cache in JNDI. If none is found, then it attempts to create a cache instance using the CacheFactory found in JNDI (or the DefaultCacheFactory if no such factory is available) and the cache configuration name if supplied or the default configuration if not set.

Returns:

the JNDI name of the Cache instance that should be used, or null if the cache is to be created with a cache factory found in JNDI using the specified cache configuration name.

See Also:

setCacheJndiName(String), getCacheConfigurationName(), getCacheFactoryJndiName()

setCacheJndiName

public void setCacheJndiName(String cacheJndiName)

Set the name in JNDI of a Cache instance that should be used by this source.

This source first attempts to find an existing cache in JNDI. If none is found, then it attempts to create a cache instance using the CacheFactory found in JNDI (or the DefaultCacheFactory if no such factory is available) and the cache configuration name if supplied or the default configuration if not set.

Parameters:

cacheJndiName - the JNDI name of the Cache instance that should be used, or null if the cache is to be created with a cache factory found in JNDI using the specified cache configuration name.

See Also:

getCacheJndiName(), getCacheConfigurationName(), getCacheFactoryJndiName()

getCacheFactoryJndiName

public String getCacheFactoryJndiName()

Get the name in JNDI of a CacheFactory instance that should be used to create the cache for this source.

This source first attempts to find an existing cache in JNDI. If none is found, then it attempts to create a cache instance using the CacheFactory found in JNDI (or the DefaultCacheFactory if no such factory is available) and the cache configuration name if supplied or the default configuration if not set.

Returns:

the JNDI name of the CacheFactory instance that should be used, or null if the DefaultCacheFactory should be used if a cache is to be created

See Also:

setCacheFactoryJndiName(String), getCacheConfigurationName(), getCacheJndiName()

setCacheFactoryJndiName

public void setCacheFactoryJndiName(String jndiName)

Set the name in JNDI of a CacheFactory instance that should be used to obtain the Cache instance used by this source.

This source first attempts to find an existing cache in JNDI. If none is found, then it attempts to create a cache instance using the CacheFactory found in JNDI (or the DefaultCacheFactory if no such factory is available) and the cache configuration name if supplied or the default configuration if not set.

Parameters:

jndiName - the JNDI name of the CacheFactory instance that should be used, or null if the DefaultCacheFactory should be used if a cache is to be created

See Also:

setCacheFactoryJndiName(String), getCacheConfigurationName(), getCacheJndiName()

getCacheConfigurationName

public String getCacheConfigurationName()

Get the name of the configuration that should be used if a cache is to be created using the CacheFactory found in JNDI or the DefaultCacheFactory if needed.

This source first attempts to find an existing cache in JNDI. If none is found, then it attempts to create a cache instance using the CacheFactory found in JNDI (or the DefaultCacheFactory if no such factory is available) and the cache configuration name if supplied or the default configuration if not set.

Returns:

the name of the configuration that should be passed to the CacheFactory, or null if the default configuration should be used

See Also:

setCacheConfigurationName(String), getCacheFactoryJndiName(), getCacheJndiName()

setCacheConfigurationName

public void setCacheConfigurationName(String cacheConfigurationName)

Get the name of the configuration that should be used if a cache is to be created using the CacheFactory found in JNDI or the DefaultCacheFactory if needed.

This source first attempts to find an existing cache in JNDI. If none is found, then it attempts to create a cache instance using the CacheFactory found in JNDI (or the DefaultCacheFactory if no such factory is available) and the cache configuration name if supplied or the default configuration if not set.

Parameters:

cacheConfigurationName - the name of the configuration that should be passed to the CacheFactory, or null if the default configuration should be used

See Also:

getCacheConfigurationName(), getCacheFactoryJndiName(), getCacheJndiName()

getRootNodeUuid

public String getRootNodeUuid()

Get the UUID of the root node for the cache. If the cache exists, this UUID is not used but is instead set to the UUID of the existing root node.

Returns:

the UUID of the root node for the cache.

getRootNodeUuidObject

public UUID getRootNodeUuidObject()

Get the UUID of the root node for the cache. If the cache exists, this UUID is not used but is instead set to the UUID of the existing root node.

Returns:

the UUID of the root node for the cache.

setRootNodeUuid

public void setRootNodeUuid(String rootNodeUuid)

Set the UUID of the root node in this repository. If the cache exists, this UUID is not used but is instead set to the UUID of the existing root node.

Parameters:

rootNodeUuid - the UUID of the root node for the cache, or null if the UUID should be randomly generated

getUuidPropertyName

public String getUuidPropertyName()

Get the property name where the UUID is stored for each node.

Returns:

the name of the UUID property; never null

setUuidPropertyName

public void setUuidPropertyName(String uuidPropertyName)

Set the property name where the UUID is stored for each node.

Parameters:

uuidPropertyName - the name of the UUID property, or null if the default name should be used

getConnection

public org.jboss.dna.graph.connectors.RepositoryConnection getConnection()
                                                                  throws org.jboss.dna.graph.connectors.RepositorySourceException

Specified by:

getConnection in interface org.jboss.dna.graph.connectors.RepositorySource

Throws:

org.jboss.dna.graph.connectors.RepositorySourceException

See Also:

RepositorySource.getConnection()

getContext

protected Context getContext()

setContext

protected void setContext(Context context)

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

getReference

public Reference getReference()

Specified by:

getReference in interface Referenceable

getObjectInstance

public Object getObjectInstance(Object obj,
                                Name name,
                                Context nameCtx,
                                Hashtable<?,?> environment)
                         throws Exception

Specified by:

getObjectInstance in interface ObjectFactory

Throws:

Exception

getCapabilities

public org.jboss.dna.graph.connectors.RepositorySourceCapabilities getCapabilities()

Specified by:

getCapabilities in interface org.jboss.dna.graph.connectors.RepositorySource

See Also:

RepositorySource.getCapabilities()