wt.pom
Class Transaction

java.lang.Object
  wt.pom.Transaction

public class Transaction
extends Object

Transaction provides interfaces to create transaction blocks. This class supports transaction block nesting. A new database level transaction is not started for nested transaction blocks. Internal state is maintained so that only a commit at the outer most transaction block will cause a database level commit. A rollback at any level will cause the entire transaction to be rolled back immediately.

TransactionListeners can be added within a global or local scope. For global listeners, callback methods will be executed when the outer-most Transaction either commits or rolls back. For the local listeners, the methods will be called when this Transaction instance either commits or rolls back. The overall transactional behavior is not affected.

Supported API: true
Extendable: false

See Also:

TransactionListener

Constructor Summary

Transaction()
This constructor initializes the instance.

Transaction(LocalizableMessage a_description)
This constructor initializes the instance.

Method Summary

void	addLocalTransactionListener(TransactionListener a_listener) Add a listener for local Transaction events.
static void	addTransactionListener(TransactionListener listener) Add a listener for Transaction events.
void	commit() Commit a transaction block.
static boolean	containsKeyInContext(Object a_key, boolean a_includeGlobalMap, boolean a_includeMethodContext) Indicates if the key exists in the current context of the Transaction.
static List	findAllInContext(Object a_key) Returns List of Transactions that contains the specified key.
static Transaction	findInContext(Object a_key) Returns the inner-most Transaction in the current Transaction stack that contains the specified key.
static Transaction	getCurrentTransaction() Returns the current Transaction.
LocalizableMessage	getDescription() Returns the transaction description.
static Map	getGlobalMap() Returns the global transaction map.
static Object	getInContext(Object a_key, boolean a_includeGlobalMap, boolean a_includeMethodContext) Returns the values associated with the specified key exists in the current context of the Transaction.
Map	getLocalMap() Returns the local transaction map.
static List	getTransactionStack() Returns the current Transaction stack.
boolean	hasLocalMap() Indicates if the Transaction has a local map.
void	removeLocalTransactionListener(TransactionListener listener) Remove a listener for Transaction events.
static void	removeTransactionListener(TransactionListener listener) Remove a listener for Transaction events.
void	rollback() Rollback a transaction block.
void	start() Start a transaction block.

Methods inherited from class java.lang.Object

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

Constructor Detail

Transaction

public Transaction()

This constructor initializes the instance.

Supported API: true

Transaction

public Transaction(LocalizableMessage a_description)
            throws PersistenceException

This constructor initializes the instance.

Parameters:

a_description - localizable message describing this transaction. The object must implement Evolvable.

Supported API: true

Throws:

PersistenceException

See Also:

Evolvable

Method Detail

containsKeyInContext

public static boolean containsKeyInContext(Object a_key,
                                           boolean a_includeGlobalMap,
                                           boolean a_includeMethodContext)
                                    throws WTException

Indicates if the key exists in the current context of the Transaction. The context includes the Transaction stack local Maps and optionally the global Transaction Map and MethodContext.

Supported API: true

Throws:

WTException

getInContext

public static Object getInContext(Object a_key,
                                  boolean a_includeGlobalMap,
                                  boolean a_includeMethodContext)
                           throws WTException

Returns the values associated with the specified key exists in the current context of the Transaction. The context includes the Transaction stack local Maps and optionally the global Transaction Map and MethodContext. The key is searched in the current Transaction context local Maps from inner (most recently created) to outer (first created) Transaction blocks. If the key is not found in the Transaction context and a_includeGlobalMap is true, then the Transaction global map is searched. If still not found and a_includeMethodContext is true, then the MethodContext is searched.

Returns:

the value associated with the key, null if not found

Supported API: true

Throws:

WTException

findInContext

public static Transaction findInContext(Object a_key)
                                 throws WTException

Returns the inner-most Transaction in the current Transaction stack that contains the specified key.

Returns:

current local Transaction that contains the key or null if no Transaction exists or the key is not found.

Supported API: true

Throws:

WTException

findAllInContext

public static List findAllInContext(Object a_key)
                             throws WTException

Returns List of Transactions that contains the specified key. The List is ordered from inner-most (index=0) to outer-most (index=size() - 1).

Returns:

List of local Transactions that contain the key or null if no Transaction exists or the key is not found.

Supported API: true

Throws:

WTException

getTransactionStack

public static List getTransactionStack()
                                throws WTException

Returns the current Transaction stack.

Returns:

current Transaction stack or null if no Transaction exists.

Supported API: true

Throws:

WTException

getCurrentTransaction

public static Transaction getCurrentTransaction()
                                         throws WTException

Returns the current Transaction.

Returns:

current local Transaction or null if no Transaction exists.

Supported API: true

Throws:

WTException

getGlobalMap

public static Map getGlobalMap()
                        throws WTException

Returns the global transaction map. If a global Map does not currently exist, then one is created.

Returns:

global Transaction Map

Supported API: true

Throws:

WTException

addTransactionListener

public static void addTransactionListener(TransactionListener listener)
                                   throws PersistenceException

Add a listener for Transaction events.

Supported API: true

Throws:

PersistenceException

removeTransactionListener

public static void removeTransactionListener(TransactionListener listener)
                                      throws PersistenceException

Remove a listener for Transaction events.

Supported API: true

Throws:

PersistenceException

getDescription

public LocalizableMessage getDescription()

Returns the transaction description.

Supported API: true

hasLocalMap

public boolean hasLocalMap()

Indicates if the Transaction has a local map.

Supported API: true

getLocalMap

public Map getLocalMap()

Returns the local transaction map. If a local Map does not currently exist, then one is created.

Supported API: true

start

public void start()
           throws PersistenceException

Start a transaction block.

Supported API: true

Throws:

PersistenceException

commit

public void commit()
            throws PersistenceException

Commit a transaction block. An acutal database commit is only performed when the outer-most transaction block is committed.

Supported API: true

Throws:

PersistenceException

rollback

public void rollback()

Rollback a transaction block.

Supported API: true

addLocalTransactionListener

public void addLocalTransactionListener(TransactionListener a_listener)
                                 throws PersistenceException

Add a listener for local Transaction events.

Supported API: true

Throws:

PersistenceException

removeLocalTransactionListener

public void removeLocalTransactionListener(TransactionListener listener)
                                    throws PersistenceException

Remove a listener for Transaction events.

Supported API: true

Throws:

PersistenceException