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

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() Closing will abort all transactions
void	commit(Object locker) Writes all pending changes to the backends.
void	dumpPendingTransactions(int logLevel)
String	executeQuery(Query query)
C2KLocalObject	get(ItemPath itemPath, String path, Object locker) Public get method.
String[]	getClusterContents(ItemPath itemPath, ClusterType type) Retrieves the ids of the root level of a cluster
String[]	getClusterContents(ItemPath itemPath, ClusterType type, Object locker) Retrieves the ids of the root level of a cluster
String[]	getClusterContents(ItemPath itemPath, String path) Retrieves the ids of the next level of a cluster
String[]	getClusterContents(ItemPath itemPath, String path, Object locker) Retrieves the ids of the next level of a cluster Checks the transaction table first to see if the caller has uncommitted changes
ClusterStorageManager	getDb()
boolean	hasPendingTransactions()
void	postBoostrap() Propagate Bootstrap has finished hook to the storages
void	postConnect() Propagate Gateway connect has finished hook to the storages
void	postStartServer() Propagate start server has finished hook to the storages
void	put(ItemPath itemPath, C2KLocalObject obj, Object locker)
void	remove(ItemPath itemPath, String path, Object locker) Uses the put method, with null as the object value.
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()

Closing will abort all transactions

executeQuery

public String executeQuery(Query query)
                    throws PersistencyException

Parameters:

query -

Returns:

Throws:

PersistencyException

getClusterContents

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

Retrieves the ids of the root level of a cluster

Parameters:

itemPath - the item

type - the type of the cluster

Returns:

array of ids

Throws:

PersistencyException

getClusterContents

public String[] getClusterContents(ItemPath itemPath,
                                   ClusterType type,
                                   Object locker)
                            throws PersistencyException

Retrieves the ids of the root level of a cluster

Parameters:

itemPath - the item

type - the type of the cluster

locker - the transaction key

Returns:

array of ids

Throws:

PersistencyException

getClusterContents

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

Retrieves the ids of the next level of a cluster

Parameters:

itemPath - the item

path - the cluster path

Returns:

array of ids

Throws:

PersistencyException

getClusterContents

public String[] getClusterContents(ItemPath itemPath,
                                   String path,
                                   Object locker)
                            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

locker - the transaction key

Returns:

array of ids

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

Throws:

PersistencyException

remove

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

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.

Parameters:

locker - transaction locker

abort

public void abort(Object locker)

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

Parameters:

locker - transaction locker

clearCache

public void clearCache(ItemPath itemPath,
                       String path)

dumpPendingTransactions

public void dumpPendingTransactions(int logLevel)

postConnect

public void postConnect()
                 throws PersistencyException

Propagate Gateway connect has finished hook to the storages

Throws:

PersistencyException

postBoostrap

public void postBoostrap()
                  throws PersistencyException

Propagate Bootstrap has finished hook to the storages

Throws:

PersistencyException

postStartServer

public void postStartServer()
                     throws PersistencyException

Propagate start server has finished hook to the storages

Throws:

PersistencyException