org.mule.runtime.api.store

Interface ObjectStore<T extends Serializable>

Type Parameters:

T - the generic type of the objects to be stored

All Known Subinterfaces:

PartitionableObjectStore<T>

All Known Implementing Classes:

AbstractObjectStoreSupport, TemplateObjectStore

public interface ObjectStore<T extends Serializable>

A generic object key value store

Since:

1.0

Method Summary

Modifier and Type	Method and Description
List<String>	allKeys()
void	clear() Removes all items of this store without disposing it, meaning that after performing a clear(), you should still be able perform other operations.
void	close() Close the underlying store.
boolean	contains(String key) Check whether this store already contains a value for the given key
boolean	isPersistent()
void	open() Open the underlying store.
T	remove(String key) Remove the object with the given key
T	retrieve(String key) * Retrieve the object stored under the given key
void	store(String key, T value) Store the given Object.

Method Detail

contains

boolean contains(String key)
          throws ObjectStoreException

Check whether this store already contains a value for the given key

Parameters:

key - the identifier of the object to check

Returns:

true if the key is stored or false no value was stored for the key.

Throws:

ObjectStoreException - if the given key is null.

ObjectStoreNotAvailableException - if any implementation-specific error occured, e.g. when the store is not available

store

void store(String key,
           T value)
    throws ObjectStoreException

Store the given Object.

Parameters:

key - the identifier for value

value - the Object to store with key

Throws:

ObjectStoreException - if the given key cannot be stored or is null.

ObjectStoreNotAvailableException - if the store is not available or any other implementation-specific error occured.

ObjectAlreadyExistsException - if an attempt is made to store an object for a key that already has an object associated.

retrieve

T retrieve(String key)
    throws ObjectStoreException

* Retrieve the object stored under the given key

Parameters:

key - the identifier of the object to retrieve.

Returns:

the object associated with the given key. If no object for the given key was found this method throws an ObjectDoesNotExistException.

Throws:

ObjectStoreException - if the given key is null.

ObjectStoreNotAvailableException - if the store is not available or any other implementation-specific error occured.

ObjectDoesNotExistException - if no value for the given key was previously stored.

remove

T remove(String key)
  throws ObjectStoreException

Remove the object with the given key

Parameters:

key - the identifier of the object to remove.

Returns:

the object that was previously stored for the given key

Throws:

ObjectStoreException - if the given key is null or if the store is not available or any other implementation-specific error occured

ObjectDoesNotExistException - if no value for the given key was previously stored.

isPersistent

boolean isPersistent()

Returns:

Whether this store is persistent or not

clear

void clear()
    throws ObjectStoreException

Removes all items of this store without disposing it, meaning that after performing a clear(), you should still be able perform other operations. Implementations of this method have to remove all items in the fastest way possible. No assumptions should be made regarding thread safeness. If the store implementation is thread-safe, then this method should also be. If the implementation does not guarantee thread-safeness, then you shouldn't expect that from this method either.

Throws:

ObjectStoreException - if the operation fails

open

void open()
   throws ObjectStoreException

Open the underlying store.

Throws:

ObjectStoreException - if an exception occurred while opening the underlying store.

close

void close()
    throws ObjectStoreException

Close the underlying store.

Throws:

ObjectStoreException - if an exception occurred while closing the underlying store.

allKeys

List<String> allKeys()
              throws ObjectStoreException

Returns:

list containing all keys that this object store currently holds values for.

Throws:

ObjectStoreException - if an exception occurred while collecting the list of all keys.