org.castor.persist

Class AbstractTransactionContext

public abstract class AbstractTransactionContext extends Object implements TransactionContext

A transaction context is required in order to perform operations against the database. The transaction context is mapped to an API transaction or an XA transaction. The only way to begin a new transaction is through the creation of a new transaction context. A transaction context is created from an implementation class directly or through XAResourceImpl.

Since: 1.0

Version: $Revision: 6230 $ $Date: 2006-04-25 15:08:23 -0600 (Tue, 25 Apr 2006) $

Author: Assaf Arkin Ralf Joachim Werner Guttmann Gregory Block

Constructor Summary
	AbstractTransactionContext(Database db) Create a new transaction context.

Method Summary
void	addTxSynchronizable(TxSynchronizable synchronizable)
protected void	clearConnections()
void	close()
protected abstract void	closeConnections() The derived class must implement this method and close all the connections used in this transaction.
void	commit()
protected abstract void	commitConnections() The derived class must implement this method and commit all the connections used in this transaction.
protected Iterator	connectionsIterator()
void	create(ClassMolder molder, Object object, OID depended)
protected abstract Connection	createConnection(LockEngine engine)
void	delete(Object object)
void	expireCache(ClassMolder molder, Identity identity)
Object	fetch(ClassMolder molder, Identity identity, AccessMode suggestedAccessMode)
ClassLoader	getClassLoader()
Connection	getConnection(LockEngine engine)
DbMetaInfo	getConnectionInfo(LockEngine engine)
Database	getDatabase()
int	getLockTimeout()
String	getNamedQuery(ClassMolder molder, String name)
int	getStatus()
int	getTransactionTimeout()
ObjectLock	getWaitOnLock()
boolean	isAutoStore()
boolean	isCached(ClassMolder molder, Class cls, Identity identity)
boolean	isCreated(Object object)
boolean	isDeleted(Object object)
boolean	isDeletedByOID(OID oid)
boolean	isDepended(OID master, Object dependent)
boolean	isLocked(Class cls, Identity identity, LockEngine lockEngine) Returns true if the object given is locked.
boolean	isOpen()
boolean	isPersistent(Object object)
boolean	isReadOnly(Object object)
boolean	isRecorded(Object object)
boolean	isUpdateCacheNeeded(Object object)
boolean	isUpdatePersistNeeded(Object object)
Iterator	iterateReadWriteObjectsInTransaction()
Object	load(Identity identity, ProposedEntity proposedObject, AccessMode suggestedAccessMode)
Object	load(Identity identity, ProposedEntity proposedObject, AccessMode suggestedAccessMode, QueryResults results)
void	markCreate(ClassMolder molder, Object object, OID rootObjectOID)
void	markModified(Object object, boolean updatePersist, boolean updateCache)
boolean	markUpdate(ClassMolder molder, Object object, OID depended)
boolean	prepare()
QueryResults	query(LockEngine engine, PersistenceQuery query, AccessMode accessMode, boolean scrollable)
void	removeTxSynchronizable(TxSynchronizable synchronizable)
void	rollback()
protected abstract void	rollbackConnections() The derived class must implement this method and rollback all the connections used in this transaction.
void	setAutoStore(boolean autoStore)
void	setCallback(CallbackInterceptor callback)
void	setInstanceFactory(InstanceFactory factory)
void	setLockTimeout(int timeout)
void	setStatus(int status)
void	setTransactionTimeout(int timeout)
void	setWaitOnLock(ObjectLock lock)
void	update(ClassMolder molder, Object object, OID depended)
void	writeLock(Object object, int timeout)

Constructor Detail

AbstractTransactionContext

public AbstractTransactionContext(Database db)

Create a new transaction context. This method is used by the explicit transaction model.

Parameters: db Database instance

Method Detail

addTxSynchronizable

public final void addTxSynchronizable(TxSynchronizable synchronizable)

{@inheritDoc }