org.jboss.tm

Class TransactionLocal

java.lang.Object

org.jboss.tm.TransactionLocal

Deprecated.

@Deprecated
public class TransactionLocal
extends java.lang.Object

A TransactionLocal is similar to ThreadLocal except it is keyed on the Transactions. A transaction local variable is cleared after the transaction completes.

Version:

$Revision: 37459 $

Field Summary

Fields

Modifier and Type	Field and Description
protected TransactionLocalDelegate	delegate Deprecated. The delegate
private static java.lang.Object	NULL_VALUE Deprecated. To simplify null values handling in the preloaded data pool we use this value instead of 'null'
protected javax.transaction.TransactionManager	transactionManager Deprecated. The transaction manager is maintained by the system and manges the assocation of transaction to threads.

Constructor Summary

Constructors

Constructor and Description
TransactionLocal() Deprecated. Creates a thread local variable.
TransactionLocal(javax.transaction.TransactionManager tm) Deprecated. Creates a transaction local variable.

Method Summary

Modifier and Type	Method and Description
protected boolean	containsValue(javax.transaction.Transaction tx) Deprecated. does Transaction contain object?
java.lang.Object	get() Deprecated. Returns the value of this TransactionLocal variable associated with the thread context transaction.
java.lang.Object	get(javax.transaction.Transaction transaction) Deprecated. Returns the value of this TransactionLocal variable associated with the specified transaction.
javax.transaction.Transaction	getTransaction() Deprecated.
protected java.lang.Object	getValue(javax.transaction.Transaction tx) Deprecated. get the transaction local value.
protected void	initDelegate() Deprecated. Initialise the delegate
protected java.lang.Object	initialValue() Deprecated. Returns the initial value for this thransaction local.
void	lock() Deprecated. Lock the TransactionLocal using the current transaction
void	lock(javax.transaction.Transaction transaction) Deprecated. Lock the TransactionLocal using the provided transaction
void	set(java.lang.Object value) Deprecated. Sets the value of this TransactionLocal variable associtated with the thread context transaction.
void	set(javax.transaction.Transaction transaction, java.lang.Object value) Deprecated. Sets the value of this TransactionLocal variable associtated with the specified transaction.
protected void	storeValue(javax.transaction.Transaction tx, java.lang.Object value) Deprecated. put the value in the TransactionImpl map
void	unlock() Deprecated. Unlock the TransactionLocal using the current transaction
void	unlock(javax.transaction.Transaction transaction) Deprecated. Unlock the ThreadLocal using the provided transaction

Methods inherited from class java.lang.Object

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

Field Detail

NULL_VALUE

private static final java.lang.Object NULL_VALUE

Deprecated.

To simplify null values handling in the preloaded data pool we use this value instead of 'null'

transactionManager

protected final javax.transaction.TransactionManager transactionManager

Deprecated.

The transaction manager is maintained by the system and manges the assocation of transaction to threads.

delegate

protected TransactionLocalDelegate delegate

Deprecated.

The delegate

Constructor Detail

TransactionLocal

public TransactionLocal()

Deprecated.

Creates a thread local variable.

Throws:

java.lang.IllegalStateException - if there is no system transaction manager

TransactionLocal

public TransactionLocal(javax.transaction.TransactionManager tm)

Deprecated.

Creates a transaction local variable. Using the given transaction manager

Parameters:

tm - the transaction manager

Method Detail

lock

public void lock()
          throws java.lang.InterruptedException

Deprecated.

Lock the TransactionLocal using the current transaction

WARN: The current implemention just "locks the transactions"

Throws:

java.lang.IllegalStateException - if the transaction is not active

java.lang.InterruptedException - if the thread is interrupted

lock

public void lock(javax.transaction.Transaction transaction)
          throws java.lang.InterruptedException

Deprecated.

Lock the TransactionLocal using the provided transaction

WARN: The current implemention just "locks the transactions"

Parameters:

transaction - the transaction

Throws:

java.lang.IllegalStateException - if the transaction is not active

java.lang.InterruptedException - if the thread is interrupted

unlock

public void unlock()

Deprecated.

Unlock the TransactionLocal using the current transaction

unlock

public void unlock(javax.transaction.Transaction transaction)

Deprecated.

Unlock the ThreadLocal using the provided transaction

Parameters:

transaction - the transaction

initialValue

protected java.lang.Object initialValue()

Deprecated.

Returns the initial value for this thransaction local. This method will be called once per accessing transaction for each TransactionLocal, the first time each transaction accesses the variable with get or set. If the programmer desires TransactionLocal variables to be initialized to some value other than null, TransactionLocal must be subclassed, and this method overridden. Typically, an anonymous inner class will be used. Typical implementations of initialValue will call an appropriate constructor and return the newly constructed object.

Returns:

the initial value for this TransactionLocal

getValue

protected java.lang.Object getValue(javax.transaction.Transaction tx)

Deprecated.

get the transaction local value.

Parameters:

tx - the transaction

Returns:

the obejct

storeValue

protected void storeValue(javax.transaction.Transaction tx,
                          java.lang.Object value)

Deprecated.

put the value in the TransactionImpl map

Parameters:

tx - the transaction

value - the value

containsValue

protected boolean containsValue(javax.transaction.Transaction tx)

Deprecated.

does Transaction contain object?

Parameters:

tx - the transaction

Returns:

true if it has an object

get

public java.lang.Object get()

Deprecated.

Returns the value of this TransactionLocal variable associated with the thread context transaction. Creates and initializes the copy if this is the first time the method is called in a transaction.

Returns:

the value of this TransactionLocal

get

public java.lang.Object get(javax.transaction.Transaction transaction)

Deprecated.

Returns the value of this TransactionLocal variable associated with the specified transaction. Creates and initializes the copy if this is the first time the method is called in a transaction.

Parameters:

transaction - the transaction for which the variable it to be retrieved

Returns:

the value of this TransactionLocal

Throws:

java.lang.IllegalStateException - if an error occures while registering a synchronization callback with the transaction

set

public void set(java.lang.Object value)

Deprecated.

Sets the value of this TransactionLocal variable associtated with the thread context transaction. This is only used to change the value from the one assigned by the initialValue method, and many applications will have no need for this functionality.

Parameters:

value - the value to be associated with the thread context transactions's TransactionLocal

set

public void set(javax.transaction.Transaction transaction,
                java.lang.Object value)

Deprecated.

Sets the value of this TransactionLocal variable associtated with the specified transaction. This is only used to change the value from the one assigned by the initialValue method, and many applications will have no need for this functionality.

Parameters:

transaction - the transaction for which the value will be set

value - the value to be associated with the thread context transactions's TransactionLocal

getTransaction

public javax.transaction.Transaction getTransaction()

Deprecated.

initDelegate

protected void initDelegate()

Deprecated.

Initialise the delegate