org.eclipse.stardust.engine.core.spi.cluster

Interface ClusterSafeObjectProvider

@SPI(status=Stable,
     useRestriction=Internal)
public interface ClusterSafeObjectProvider

An SPI allowing to specify which cluster safe object provider to use.

Version:

$Revision$

Author:

Nicolas.Werlein

Method Summary

Methods

Modifier and Type	Method and Description
void	afterAccess() Will be called after each and every operation on an object retrieved from the cluster safe object provider.
void	beforeAccess() Will be called before each and every operation on an object retrieved from the cluster safe object provider.
<K,V> Map<K,V>	clusterSafeMap(String mapId) Returns a cluster safe map for the given map ID.
void	exception(Exception e) Will be called in case an exception occured during access of an object retrieved from the cluster safe object provider.
void	reset() Resets the ClusterSafeObjectProvider to the uninitialized state such that a subsequent call other than reset() causes a reinitialization of this ClusterSafeObjectProvider.

Method Detail

clusterSafeMap

<K,V> Map<K,V> clusterSafeMap(String mapId)

Returns a cluster safe map for the given map ID. If it does not yet exist, it will be created first. Same map ID means that the same map is returned.

Type Parameters:

K - the type of the map keys

V - the type of the map values

Parameters:

mapId - the ID of the map to be returned; must not be null

Returns:

the map for the given map ID

beforeAccess

void beforeAccess()

Will be called before each and every operation on an object retrieved from the cluster safe object provider.

exception

void exception(Exception e)

Will be called in case an exception occured during access of an object retrieved from the cluster safe object provider.

Parameters:

e - the exception raised

afterAccess

void afterAccess()

Will be called after each and every operation on an object retrieved from the cluster safe object provider.

reset

void reset()

Resets the ClusterSafeObjectProvider to the uninitialized state such that a subsequent call other than reset() causes a reinitialization of this ClusterSafeObjectProvider.