org.castor.cache

Interface Cache

public interface Cache extends Map

Interface specification for performance caches as used in Castor. Please implement this interface if you wish to provide your own cache implementation.

At initialization each cache implementation gets passed a properties map containing key/value pairs. Apart of 3 reserved standard properties, individual once can be used to configure the cache behavier. The standard properties are:

type which is evaluated by the CacheFactoryRegistry and defines the requested cache type. If not set count-limited cahce will be used as default.
debug is also evaluated by the CacheFactoryRegistry and defines if the cache instance will be wrapped by a DebuggingCacheProxy to log debug messages at every access to the cache. If not set no debugging will take place.
name is used by AbstractBaseCache to set the name of the cache instance. At the moment every cache type available extends this AbstractBaseCache. The name does not influence internal behavier of the cache but is usefull to identify from which cache instance debug messages are coming from. By default castor uses the classname of the cached objects as name for the cache. If not present the name will be empty.

For a description of the individual properties you should have a look at the javadoc of the different cache types. It needs to be noted that only string keys and values are allowed.

Since: 1.0

Version: $Revision: 5951 $ $Date: 2006-04-25 16:09:10 -0600 (Tue, 25 Apr 2006) $

Author: Werner Guttmann Ralf Joachim

Field Summary
StringDEFAULT_DEBUG
Default is debugging switched off.
StringDEFAULT_NAME
Default cache name to be used.
StringDEFAULT_TYPE
Default cache type to be used.
StringPARAM_DEBUG
Mapped initialization parameter: debug
StringPARAM_NAME
Mapped initialization parameter: name
StringPARAM_TYPE
Mapped initialization parameter: type
Method Summary
voidclose()
Life-cycle method to allow custom resource cleanup for a cache implementation.
voidexpire(Object key)
Remove the mapping identified by key from the cache.
voidexpireAll()
Removes all mappings from the cache.
StringgetName()
Get virtual name of this cache.
StringgetType()
Indicates the type of this cache.
voidinitialize(Properties params)
Lyfe-cycle method to allow custom initialization of cache implementations.

Field Detail

DEFAULT_DEBUG

public String DEFAULT_DEBUG
Default is debugging switched off.

DEFAULT_NAME

public String DEFAULT_NAME
Default cache name to be used.

DEFAULT_TYPE

public String DEFAULT_TYPE
Default cache type to be used.

PARAM_DEBUG

public String PARAM_DEBUG
Mapped initialization parameter: debug

PARAM_NAME

public String PARAM_NAME
Mapped initialization parameter: name

PARAM_TYPE

public String PARAM_TYPE
Mapped initialization parameter: type

Method Detail

close

public void close()
Life-cycle method to allow custom resource cleanup for a cache implementation.

expire

public void expire(Object key)
Remove the mapping identified by key from the cache.

Parameters: key the key that needs to be removed.

expireAll

public void expireAll()
Removes all mappings from the cache.

getName

public String getName()
Get virtual name of this cache. Castor sets the cache name to the class name of the objects stored in the cache.

Returns: The cache name.

getType

public String getType()
Indicates the type of this cache.

Returns: The cache type.

initialize

public void initialize(Properties params)
Lyfe-cycle method to allow custom initialization of cache implementations.

Parameters: params Parameters to initialize the cache (e.g. name, capacity).

Throws: CacheAcquireException If cache can not be initialized.

Intalio Inc. (C) 1999-2006. All rights reserved http://www.intalio.com