com.sibvisions.util
Class ObjectCache

java.lang.Object
  com.sibvisions.util.ObjectCache

public class ObjectCache
extends Object

The ObjectCache is a utility class to cache/store objects for a period of time. The cache handles the object expiration and the access to the cached objects. The cache stores an object with a unique access key. With this access key it's possible to access the object from the store.

Constructor Summary

protected

ObjectCache() Invisible constructor, because the ObjectCache is a utility class.

Method Summary

static Object	createKey() Creates a random acces key.
static Object	get(Object pKey) Gets an object from the cache.
static Object	put(Object pObject, long pTimeout) Puts an object to the cache, with a timeout for expiration.
static Object	put(Object pKey, Object pObject, long pTimeout) Puts an object to the cache, with a specific key and timeout for expiration.
static Object	remove(Object pKey) Removes an object from the cache.

Methods inherited from class java.lang.Object

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

Constructor Detail

ObjectCache

protected ObjectCache()

Invisible constructor, because the ObjectCache is a utility class.

Method Detail

createKey

public static Object createKey()

Creates a random acces key.

Returns:

the access key

put

public static Object put(Object pObject,
                         long pTimeout)

Puts an object to the cache, with a timeout for expiration.

Parameters:

pObject - the cachable object

pTimeout - the timeout (in millis) for the object. After this time, the object will be removed from the cache

Returns:

the access key for the object

put

public static Object put(Object pKey,
                         Object pObject,
                         long pTimeout)

Puts an object to the cache, with a specific key and timeout for expiration.

Parameters:

pKey - the key for accessing the object

pObject - the cachable object

pTimeout - the timeout (in millis) for the object. After this time, the object will be removed from the cache

Returns:

the previous cached object or null if there was no previous object or the object is expired

get

public static Object get(Object pKey)

Gets an object from the cache.

Parameters:

pKey - the access key of the object

Returns:

the object or null if the object was expired or the key was not found

remove

public static Object remove(Object pKey)

Removes an object from the cache.

Parameters:

pKey - the access key of the object

Returns:

the removed object or null if the object was expired or the key was not found