|
Oracle Fusion Middleware Java API Reference for Oracle TopLink 11g Release 1 (11.1.1) B32476-03 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object oracle.toplink.transaction.AbstractTransactionController oracle.toplink.transaction.JTATransactionController
public class JTATransactionController
Purpose: TransactionController implementation for JTA 1.0
Description: Implements the required behaviour for controlling JTA 1.0 transactions. Specific JTA implementations may need to extend this class when special controller behavior is necessary.
The JTA TransactionManager must be obtained and set on the instance in order for a Synchronization listener to be registered against the transaction. This can be done either by extending this class and defining acquireTransactionManager() to return the manager for the server, or by using this class and explicitly calling the setTransactionManager() method on it after the fact. e.g. TransactionManager mgr = controller.jndiLookup("java:comp/TransactionManager"); controller.setTransactionManager(mgr);
If a different listener needs to be used for synchronization, the SynchronizationListenerFactory should be set on the controller instance. The listener subclass should implement the factory interface, so that setting the factory is simply a matter of assigning an instance of the listener. e.g. controller.setSynchronizationListenerFactory( new DifferentServerSynchronizationListener()); The default listener factory creates instances of JTATransactionListener.
JTASynchronizationListener
,
AbstractTransactionController
Constructor Summary | |
---|---|
JTATransactionController()
Return a new controller for use with a JTA 1.0 compliant TransactionManager. |
Method Summary | |
---|---|
javax.transaction.TransactionManager |
getTransactionManager()
Return the transaction manager used to control the JTA transactions. |
void |
setTransactionManager(javax.transaction.TransactionManager mgr)
Set the transaction manager used to control the JTA transactions. |
Methods inherited from class oracle.toplink.transaction.AbstractTransactionController |
---|
jndiLookup, logTxStateTrace, logTxTrace |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public JTATransactionController()
Method Detail |
---|
public javax.transaction.TransactionManager getTransactionManager()
public void setTransactionManager(javax.transaction.TransactionManager mgr)
mgr
- A valid JTA TransactionManager that can be
accessed by this controller to obtain transaction state information and
control the active transaction.
|
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |