org.cristalise.kernel.persistency

Class TransactionManager

java.lang.Object

org.cristalise.kernel.persistency.TransactionManager

public class TransactionManager
extends Object

Constructor Summary

Constructors

Constructor and Description
TransactionManager(Authenticator auth)

Method Summary

Methods

Modifier and Type	Method and Description
void	abort(Object locker) Rolls back all changes sent in the name of 'locker' and unlocks the sysKeys
void	clearCache(ItemPath itemPath, String path)
void	close()
void	commit(Object locker) Writes all pending changes to the backends.
void	dumpPendingTransactions(int logLevel)
C2KLocalObject	get(ItemPath itemPath, String path, Object locker) Public get method.
String[]	getClusterContents(ItemPath itemPath, String path)
ClusterStorageManager	getDb()
boolean	hasPendingTransactions()
void	put(ItemPath itemPath, C2KLocalObject obj, Object locker) Public put method.
void	remove(ItemPath itemPath, String path, Object locker) Public delete method.
void	removeCluster(ItemPath itemPath, String path, Object locker) Removes all child objects from the given path

Methods inherited from class java.lang.Object

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

Constructor Detail

TransactionManager

public TransactionManager(Authenticator auth)
                   throws PersistencyException

Throws:

PersistencyException

Method Detail

hasPendingTransactions

public boolean hasPendingTransactions()

getDb

public ClusterStorageManager getDb()

close

public void close()

getClusterContents

public String[] getClusterContents(ItemPath itemPath,
                          String path)
                            throws PersistencyException

Throws:

PersistencyException

get

public C2KLocalObject get(ItemPath itemPath,
                 String path,
                 Object locker)
                   throws PersistencyException,
                          ObjectNotFoundException

Public get method. Required a 'locker' 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,
       Object locker)
         throws PersistencyException

Public put method. Manages the transaction table keyed by the object 'locker'. If this object is null, transaction support is bypassed (so long as no lock exists on that object).

Throws:

PersistencyException

remove

public void remove(ItemPath itemPath,
          String path,
          Object locker)
            throws PersistencyException

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

Throws:

PersistencyException

removeCluster

public void removeCluster(ItemPath itemPath,
                 String path,
                 Object locker)
                   throws PersistencyException

Removes all child objects from the given path

Parameters:

itemPath - - Item to delete from

path - - root path to delete

locker - - locking object

Throws:

PersistencyException - - when deleting fails

commit

public void commit(Object locker)

Writes all pending changes to the backends.

abort

public void abort(Object locker)

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

clearCache

public void clearCache(ItemPath itemPath,
              String path)

dumpPendingTransactions

public void dumpPendingTransactions(int logLevel)