com.sibvisions.util
Class ObjectCacheInstance

java.lang.Object
  com.sibvisions.util.ObjectCacheInstance

public class ObjectCacheInstance
extends Object

The ObjectCacheInstance 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

ObjectCacheInstance()
Creates a new instance of ObjectCacheInstance.

Method Summary

static Object	createKey() Creates a random acces key.
Object	get(Object pKey) Gets an object from the cache.
Object	put(IValidatable pObject) Puts a validatable object to the cache.
Object	put(Object pKey, IValidatable pObject) Puts a validatable object to the cache, with a specific key.
Object	put(Object pObject, long pTimeout) Puts an object to the cache, with a timeout for expiration.
Object	put(Object pKey, Object pObject, long pTimeout) Puts an object to the cache, with a specific key and timeout for expiration.
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

ObjectCacheInstance

public ObjectCacheInstance()

Creates a new instance of ObjectCacheInstance.

Method Detail

createKey

public static Object createKey()

Creates a random acces key.

Returns:

the access key

put

public 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 Object put(IValidatable pObject)

Puts a validatable object to the cache.

Parameters:

pObject - the cachable object

Returns:

the access key for the object

put

public 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

put

public Object put(Object pKey,
                  IValidatable pObject)

Puts a validatable object to the cache, with a specific key.

Parameters:

pKey - the key for accessing the object

pObject - the cachable object

Returns:

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

get

public 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 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