org.apache.servicemix.store
Interface Store

All Known Implementing Classes:

JdbcStore, MemoryStore, TimeoutMemoryStore

public interface Store

A Store is an interface representing a storage where objects can be put and retrieved. A store can support different features, mainly persistence, clustered or transactional. A store is not designed to be a thread-safe map. If a user tries to store an object with an existing id, the behavior is undefined.

Author:

gnodet

Field Summary

static String	CLUSTERED
static String	PERSISTENT
static String	TRANSACTIONAL

Method Summary

boolean	hasFeature(String name) Returns true if the store implementation supports the given feature.
Object	load(String id) Loads an object that has been previously stored under the specified key.
String	store(Object data) Put an object into the store and return the unique id that may be used at a later time to retrieve the object.
void	store(String id, Object data) Put an object in the store under the given id.

Field Detail

PERSISTENT

static final String PERSISTENT

See Also:

Constant Field Values

CLUSTERED

static final String CLUSTERED

See Also:

Constant Field Values

TRANSACTIONAL

static final String TRANSACTIONAL

See Also:

Constant Field Values

Method Detail

hasFeature

boolean hasFeature(String name)

Returns true if the store implementation supports the given feature.

Parameters:

name - the feature to check

Returns:

true if the feature is supported

store

void store(String id,
           Object data)
           throws IOException

Put an object in the store under the given id. This method must be used with caution and the behavior is unspecified if an object already exist for the same id.

Parameters:

id - the id of the object to store

data - the object to store

Throws:

IOException - if an error occurs

store

String store(Object data)
             throws IOException

Put an object into the store and return the unique id that may be used at a later time to retrieve the object.

Parameters:

data - the object to store

Returns:

the id of the object stored

Throws:

IOException - if an error occurs

load

Object load(String id)
            throws IOException

Loads an object that has been previously stored under the specified key. The object is removed from the store.

Parameters:

id - the id of the object

Returns:

the object, or null> if the object could not be found

Throws:

IOException - if an error occurs