Package org.cristalise.storage

Class TransactionalClusterStorageBase

java.lang.Object

org.cristalise.kernel.persistency.ClusterStorage

org.cristalise.storage.TransactionalClusterStorageBase

public abstract class TransactionalClusterStorageBase
extends ClusterStorage

Potentially the base class for ClusterStorage implementation without transactional support, i.e. XMLClusterStorage and MemoryOnlyClusterStorage.

Field Summary

Fields inherited from class org.cristalise.kernel.persistency.ClusterStorage

NONE, READ, READWRITE, WRITE

Constructor Summary

Constructors

Constructor	Description
TransactionalClusterStorageBase()

Method Summary

Modifier and Type	Method	Description
void	abort(TransactionKey transactionKey)	Rolls back all changes sent in the name of 'transactionKey' and unlocks the sysKeys
void	begin(TransactionKey transactionKey)
void	commit(TransactionKey transactionKey)	Writes all pending changes to the backends.
void	delete(ItemPath itemPath, String path, TransactionKey transactionKey)	Uses the put method, with null as the object value.
void	dumpPendingTransactions(int logLevel)
C2KLocalObject	getUncommitted(ItemPath itemPath, String path, TransactionKey transactionKey)	Public get method.
String[]	getUncommittedClusterContents(ItemPath itemPath, String path, TransactionKey transactionKey)	Retrieves the ids of the next level of a cluster Checks the transaction table first to see if the caller has uncommitted changes
void	put(ItemPath itemPath, C2KLocalObject obj, TransactionKey transactionKey)	Stores a CRISTAL local object.

Methods inherited from class org.cristalise.kernel.persistency.ClusterStorage

checkQuerySupport, close, delete, delete, executeQuery, get, getClusterContents, getClusterContents, getClusters, getClusterType, getId, getLastIntegerId, getName, getPath, open, postBoostrap, postConnect, postStartServer, queryClusterSupport, toString

Methods inherited from class java.lang.Object

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

Constructor Details

TransactionalClusterStorageBase

public TransactionalClusterStorageBase()
                                throws PersistencyException

Throws:

PersistencyException

Method Details

getUncommittedClusterContents

public String[] getUncommittedClusterContents(ItemPath itemPath,
 String path,
 TransactionKey transactionKey)
                                       throws PersistencyException

Retrieves the ids of the next level of a cluster Checks the transaction table first to see if the caller has uncommitted changes

Parameters:

itemPath - the item

path - the cluster path

transactionKey - the transaction key

Returns:

array of ids

Throws:

PersistencyException

getUncommitted

public C2KLocalObject getUncommitted(ItemPath itemPath,
 String path,
 TransactionKey transactionKey)
                              throws PersistencyException,
ObjectNotFoundException

Public get method. Required a 'transactionKey' object for a transaction key. Checks the transaction table first to see if the caller has uncommitted changes

Throws:

PersistencyException

ObjectNotFoundException

put

public void put(ItemPath itemPath,
 C2KLocalObject obj,
 TransactionKey transactionKey)
         throws PersistencyException

Description copied from class: ClusterStorage

Stores a CRISTAL local object. The path is automatically generated.

Specified by:

put in class ClusterStorage

Parameters:

itemPath - The Item that the object will be stored under

obj - The C2KLocalObject to store

transactionKey - the key of the transaction, cannot be null

Throws:

PersistencyException - When storage fails

delete

public void delete(ItemPath itemPath,
 String path,
 TransactionKey transactionKey)
            throws PersistencyException

Uses the put method, with null as the object value.

Specified by:

delete in class ClusterStorage

Parameters:

itemPath - The containing Item

path - The path of the object to be removed

transactionKey - the key of the transaction, cannot be null

Throws:

PersistencyException - When deletion fails or is not allowed

begin

public void begin(TransactionKey transactionKey)
           throws PersistencyException

Specified by:

begin in class ClusterStorage

Throws:

PersistencyException

commit

public void commit(TransactionKey transactionKey)
            throws PersistencyException

Writes all pending changes to the backends.

Specified by:

commit in class ClusterStorage

Parameters:

transactionKey - transaction transactionKey

Throws:

PersistencyException

abort

public void abort(TransactionKey transactionKey)

Rolls back all changes sent in the name of 'transactionKey' and unlocks the sysKeys

Specified by:

abort in class ClusterStorage

Parameters:

transactionKey - transaction transactionKey

dumpPendingTransactions

public void dumpPendingTransactions(int logLevel)