Java Doc for JtaTransactionManager.java in  » J2EE » spring-framework-2.5 » org » springframework » transaction » jta » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Java Source Code / Java Documentation
1. 6.0 JDK Core
2. 6.0 JDK Modules
3. 6.0 JDK Modules com.sun
4. 6.0 JDK Modules com.sun.java
5. 6.0 JDK Modules sun
6. 6.0 JDK Platform
7. Ajax
8. Apache Harmony Java SE
9. Aspect oriented
10. Authentication Authorization
11. Blogger System
12. Build
13. Byte Code
14. Cache
15. Chart
16. Chat
17. Code Analyzer
18. Collaboration
19. Content Management System
20. Database Client
21. Database DBMS
22. Database JDBC Connection Pool
23. Database ORM
24. Development
25. EJB Server geronimo
26. EJB Server GlassFish
27. EJB Server JBoss 4.2.1
28. EJB Server resin 3.1.5
29. ERP CRM Financial
30. ESB
31. Forum
32. GIS
33. Graphic Library
34. Groupware
35. HTML Parser
36. IDE
37. IDE Eclipse
38. IDE Netbeans
39. Installer
40. Internationalization Localization
41. Inversion of Control
42. Issue Tracking
43. J2EE
44. JBoss
45. JMS
46. JMX
47. Library
48. Mail Clients
49. Net
50. Parser
51. PDF
52. Portal
53. Profiler
54. Project Management
55. Report
56. RSS RDF
57. Rule Engine
58. Science
59. Scripting
60. Search Engine
61. Security
62. Sevlet Container
63. Source Control
64. Swing Library
65. Template Engine
66. Test Coverage
67. Testing
68. UML
69. Web Crawler
70. Web Framework
71. Web Mail
72. Web Server
73. Web Services
74. Web Services apache cxf 2.0.1
75. Web Services AXIS2
76. Wiki Engine
77. Workflow Engines
78. XML
79. XML UI
Java
Java Tutorial
Java Open Source
Jar File Download
Java Articles
Java Products
Java by API
Photoshop Tutorials
Maya Tutorials
Flash Tutorials
3ds-Max Tutorials
Illustrator Tutorials
GIMP Tutorials
C# / C Sharp
C# / CSharp Tutorial
C# / CSharp Open Source
ASP.Net
ASP.NET Tutorial
JavaScript DHTML
JavaScript Tutorial
JavaScript Reference
HTML / CSS
HTML CSS Reference
C / ANSI-C
C Tutorial
C++
C++ Tutorial
Ruby
PHP
Python
Python Tutorial
Python Open Source
SQL Server / T-SQL
SQL Server / T-SQL Tutorial
Oracle PL / SQL
Oracle PL/SQL Tutorial
PostgreSQL
SQL / MySQL
MySQL Tutorial
VB.Net
VB.Net Tutorial
Flash / Flex / ActionScript
VBA / Excel / Access / Word
XML
XML Tutorial
Microsoft Office PowerPoint 2007 Tutorial
Microsoft Office Excel 2007 Tutorial
Microsoft Office Word 2007 Tutorial
Java Source Code / Java Documentation » J2EE » spring framework 2.5 » org.springframework.transaction.jta 
Source Cross Reference  Class Diagram Java Document (Java Doc) 


java.lang.Object
   org.springframework.transaction.support.AbstractPlatformTransactionManager
      org.springframework.transaction.jta.JtaTransactionManager

All known Subclasses:   org.springframework.transaction.jta.WebLogicJtaTransactionManager,  org.springframework.transaction.jta.OC4JJtaTransactionManager,  org.springframework.transaction.jta.WebSphereUowTransactionManager,
JtaTransactionManager
public class JtaTransactionManager extends AbstractPlatformTransactionManager implements TransactionFactory,InitializingBean,Serializable(Code)
org.springframework.transaction.PlatformTransactionManager implementation for JTA, delegating to a backend JTA provider. This is typically used to delegate to a J2EE server's transaction coordinator, but may also be configured with a local JTA provider which is embedded within the application.

This transaction manager is appropriate for handling distributed transactions, i.e. transactions that span multiple resources, and for controlling transactions on application server resources (e.g. JDBC DataSources available in JNDI) in general. For a single JDBC DataSource, DataSourceTransactionManager is perfectly sufficient, and for accessing a single resource with Hibernate (including transactional cache), HibernateTransactionManager is appropriate, for example.

Transaction synchronization is active by default, to allow data access support classes to register resources that are opened within the transaction for closing at transaction completion time. Spring's support classes for JDBC, Hibernate, JDO etc all perform such registration, allowing for reuse of the same Hibernate Session etc within the transaction. Standard JTA does not even guarantee that for Connections from a transactional JDBC DataSource: Spring's synchronization solves those issues.

For typical JTA transactions (REQUIRED, SUPPORTS, MANDATORY, NEVER), a plain JtaTransactionManager definition is all you need, completely portable across all J2EE servers. This corresponds to the functionality of the JTA UserTransaction, for which J2EE specifies a standard JNDI name ("java:comp/UserTransaction"). There is no need to configure a server-specific TransactionManager lookup for this kind of JTA usage.

Note: Advanced JTA usage below. Dealing with these mechanisms is not necessary for typical usage scenarios.

Transaction suspension (REQUIRES_NEW, NOT_SUPPORTED) is just available with a JTA TransactionManager being registered, via the "transactionManagerName" or "transactionManager" property. The location of this well-defined JTA object is not specified by J2EE; it is specific to each J2EE server, often kept in JNDI like the JTA UserTransaction. Some well-known JNDI locations are:

  • "java:comp/UserTransaction" for Resin 2.x, Oracle OC4J (Orion), JOnAS (JOTM), BEA WebLogic
  • "java:comp/TransactionManager" for Resin 3.x
  • "java:pm/TransactionManager" for Borland Enterprise Server and Sun Application Server (Sun ONE 7 and later)
  • "java:/TransactionManager" for JBoss Application Server

All of these cases are autodetected by JtaTransactionManager, provided that the "autodetectTransactionManager" flag is set to "true" (which it is by default).

Note: Support for the JTA TransactionManager interface is not required by J2EE. Almost all J2EE servers expose it, but do so as extension to J2EE. There might be some issues with compatibility, despite the TransactionManager interface being part of JTA. As a consequence, Spring provides various vendor-specific PlatformTransactionManagers, which are recommended to be used if appropriate: WebLogicJtaTransactionManager , WebSphereUowTransactionManager and OC4JJtaTransactionManager . For all other J2EE servers, the standard JtaTransactionManager is sufficient.

Consider using Spring 2.5's tx:jta-transaction-manager configuration element for automatically picking the appropriate JTA platform transaction manager (automatically detecting WebLogic, WebSphere and OC4J).

This pure JtaTransactionManager supports timeouts but not per-transaction isolation levels. Custom subclasses may override JtaTransactionManager.doJtaBegin for specific JTA extensions in order to provide this functionality; Spring includes corresponding WebLogicJtaTransactionManager and OC4JJtaTransactionManager classes, for BEA's WebLogic Server and Oracle's OC4J, respectively. Such adapters for specific J2EE transaction coordinators may also expose transaction names for monitoring; with standard JTA, transaction names will simply be ignored.

JTA 1.1 adds the TransactionSynchronizationRegistry facility, as public Java EE 5 API in addition to the standard JTA UserTransaction handle. As of Spring 2.5, this JtaTransactionManager autodetects the TransactionSynchronizationRegistry and uses it for registering Spring-managed synchronizations when participating in an existing JTA transaction (e.g. controlled by EJB CMT). If no TransactionSynchronizationRegistry is available (or the JTA 1.1 API isn't available), then such synchronizations will be registered via the (non-J2EE) JTA TransactionManager handle.

This class is serializable. However, active synchronizations do not survive serialization.
author:
   Juergen Hoeller
since:
   24.03.2003
See Also:   javax.transaction.UserTransaction
See Also:   javax.transaction.TransactionManager
See Also:   javax.transaction.TransactionSynchronizationRegistry
See Also:   JtaTransactionManager.setUserTransactionName
See Also:   JtaTransactionManager.setUserTransaction
See Also:   JtaTransactionManager.setTransactionManagerName
See Also:   JtaTransactionManager.setTransactionManager
See Also:   JotmFactoryBean
See Also:   WebSphereTransactionManagerFactoryBean
See Also:   WebLogicJtaTransactionManager



Field Summary
final public static  StringDEFAULT_TRANSACTION_SYNCHRONIZATION_REGISTRY_NAME
     Standard Java EE 5 JNDI location for the JTA TransactionSynchronizationRegistry.
final public static  StringDEFAULT_USER_TRANSACTION_NAME
     Default JNDI location for the JTA UserTransaction.
final public static  String[]FALLBACK_TRANSACTION_MANAGER_NAMES
     Fallback JNDI locations for the JTA TransactionManager.

Constructor Summary
public  JtaTransactionManager()
     Create a new JtaTransactionManager instance, to be configured as bean.
public  JtaTransactionManager(UserTransaction userTransaction)
     Create a new JtaTransactionManager instance.
public  JtaTransactionManager(UserTransaction userTransaction, TransactionManager transactionManager)
     Create a new JtaTransactionManager instance.
public  JtaTransactionManager(TransactionManager transactionManager)
     Create a new JtaTransactionManager instance.

Method Summary
public  voidafterPropertiesSet()
     Initialize the UserTransaction as well as the TransactionManager handle.
protected  voidapplyIsolationLevel(JtaTransactionObject txObject, int isolationLevel)
     Apply the given transaction isolation level.
protected  voidapplyTimeout(JtaTransactionObject txObject, int timeout)
     Apply the given transaction timeout.
protected  UserTransactionbuildUserTransaction(TransactionManager transactionManager)
     Build a UserTransaction handle based on the given TransactionManager.
protected  voidcheckUserTransactionAndTransactionManager()
     Check the UserTransaction as well as the TransactionManager handle, assuming standard JTA requirements.
public  TransactioncreateTransaction(String name, int timeout)
    
protected  voiddoBegin(Object transaction, TransactionDefinition definition)
    
protected  voiddoCommit(DefaultTransactionStatus status)
    
protected  JtaTransactionObjectdoGetJtaTransaction(UserTransaction ut)
     Get a JTA transaction object for the given current UserTransaction.
protected  ObjectdoGetTransaction()
     This implementation returns a JtaTransactionObject instance for the JTA UserTransaction.

The UserTransaction object will either be looked up freshly for the current transaction, or the cached one looked up at startup will be used. The latter is the default: Most application servers use a shared singleton UserTransaction that can be cached.

protected  voiddoJtaBegin(JtaTransactionObject txObject, TransactionDefinition definition)
     Perform a JTA begin on the JTA UserTransaction or TransactionManager.
protected  voiddoJtaResume(JtaTransactionObject txObject, Object suspendedTransaction)
     Perform a JTA resume on the JTA TransactionManager.
protected  ObjectdoJtaSuspend(JtaTransactionObject txObject)
     Perform a JTA suspend on the JTA TransactionManager.
protected  voiddoRegisterAfterCompletionWithJtaTransaction(JtaTransactionObject txObject, List synchronizations)
     Register a JTA synchronization on the JTA TransactionManager, for calling afterCompletion on the given Spring TransactionSynchronizations.
protected  voiddoResume(Object transaction, Object suspendedResources)
    
protected  voiddoRollback(DefaultTransactionStatus status)
    
protected  voiddoSetRollbackOnly(DefaultTransactionStatus status)
    
protected  ObjectdoSuspend(Object transaction)
    
protected  TransactionManagerfindTransactionManager(UserTransaction ut)
     Find the JTA TransactionManager through autodetection: checking whether the UserTransaction object implements the TransactionManager, and checking the fallback JNDI locations.
protected  ObjectfindTransactionSynchronizationRegistry(UserTransaction ut, TransactionManager tm)
     Find the JTA 1.1 TransactionSynchronizationRegistry through autodetection: checking whether the UserTransaction object or TransactionManager object implements it, and checking Java EE 5's standard JNDI location.
protected  UserTransactionfindUserTransaction()
     Find the JTA UserTransaction through a default JNDI lookup: "java:comp/UserTransaction".
public  PropertiesgetJndiEnvironment()
     Return the JNDI environment to use for JNDI lookups.
public  JndiTemplategetJndiTemplate()
     Return the JndiTemplate used for JNDI lookups.
public  TransactionManagergetTransactionManager()
     Return the JTA TransactionManager that this transaction manager uses.
public  UserTransactiongetUserTransaction()
     Return the JTA UserTransaction that this transaction manager uses.
protected  voidinitTransactionSynchronizationRegistry()
     Initialize the JTA 1.1 TransactionSynchronizationRegistry, if available.
protected  voidinitUserTransactionAndTransactionManager()
     Initialize the UserTransaction as well as the TransactionManager handle.
protected  booleanisExistingTransaction(Object transaction)
    
protected  TransactionManagerlookupTransactionManager(String transactionManagerName)
     Look up the JTA TransactionManager in JNDI via the configured name.
protected  ObjectlookupTransactionSynchronizationRegistry(String registryName)
     Look up the JTA TransactionSynchronizationRegistry in JNDI via the configured name.
protected  UserTransactionlookupUserTransaction(String userTransactionName)
     Look up the JTA UserTransaction in JNDI via the configured name.
protected  voidregisterAfterCompletionWithExistingTransaction(Object transaction, List synchronizations)
    
protected  TransactionManagerretrieveTransactionManager()
     Allows subclasses to retrieve the JTA TransactionManager in a vendor-specific manner.
protected  ObjectretrieveTransactionSynchronizationRegistry()
     Allows subclasses to retrieve the JTA 1.1 TransactionSynchronizationRegistry in a vendor-specific manner.
protected  UserTransactionretrieveUserTransaction()
     Allows subclasses to retrieve the JTA UserTransaction in a vendor-specific manner.
public  voidsetAllowCustomIsolationLevels(boolean allowCustomIsolationLevels)
     Set whether to allow custom isolation levels to be specified.

Default is "false", throwing an exception if a non-default isolation level is specified for a transaction.

public  voidsetAutodetectTransactionManager(boolean autodetectTransactionManager)
     Set whether to autodetect a JTA UserTransaction object that implements the JTA TransactionManager interface too (i.e.
public  voidsetAutodetectUserTransaction(boolean autodetectUserTransaction)
     Set whether to autodetect the JTA UserTransaction at its default JNDI location "java:comp/UserTransaction", as specified by J2EE. Will proceed without UserTransaction if none found.

Default is "true", autodetecting the UserTransaction unless it has been specified explicitly.

public  voidsetCacheUserTransaction(boolean cacheUserTransaction)
     Set whether to cache the JTA UserTransaction object fetched from JNDI.

Default is "true": UserTransaction lookup will only happen at startup, reusing the same UserTransaction handle for all transactions of all threads. This is the most efficient choice for all application servers that provide a shared UserTransaction object (the typical case).

Turn this flag off to enforce a fresh lookup of the UserTransaction for every transaction.

public  voidsetJndiEnvironment(Properties jndiEnvironment)
     Set the JNDI environment to use for JNDI lookups.
public  voidsetJndiTemplate(JndiTemplate jndiTemplate)
     Set the JndiTemplate to use for JNDI lookups.
public  voidsetTransactionManager(TransactionManager transactionManager)
     Set the JTA TransactionManager to use as direct reference.
public  voidsetTransactionManagerName(String transactionManagerName)
     Set the JNDI name of the JTA TransactionManager.
public  voidsetTransactionSynchronizationRegistryName(String transactionSynchronizationRegistryName)
     Set the JNDI name of the JTA 1.1 TransactionSynchronizationRegistry.
public  voidsetUserTransaction(UserTransaction userTransaction)
     Set the JTA UserTransaction to use as direct reference.
public  voidsetUserTransactionName(String userTransactionName)
     Set the JNDI name of the JTA UserTransaction.
protected  booleanshouldCommitOnGlobalRollbackOnly()
     This implementation returns "true": a JTA commit will properly handle transactions that have been marked rollback-only at a global level.
protected  booleanuseSavepointForNestedTransaction()
     This implementation returns false to cause a further invocation of doBegin despite an already existing transaction.

Field Detail
DEFAULT_TRANSACTION_SYNCHRONIZATION_REGISTRY_NAME
final public static String DEFAULT_TRANSACTION_SYNCHRONIZATION_REGISTRY_NAME(Code)
Standard Java EE 5 JNDI location for the JTA TransactionSynchronizationRegistry. Autodetected when available.



DEFAULT_USER_TRANSACTION_NAME
final public static String DEFAULT_USER_TRANSACTION_NAME(Code)
Default JNDI location for the JTA UserTransaction. Many J2EE servers also provide support for the JTA TransactionManager interface there.
See Also:   JtaTransactionManager.setUserTransactionName
See Also:   JtaTransactionManager.setAutodetectTransactionManager



FALLBACK_TRANSACTION_MANAGER_NAMES
final public static String[] FALLBACK_TRANSACTION_MANAGER_NAMES(Code)
Fallback JNDI locations for the JTA TransactionManager. Applied if the JTA UserTransaction does not implement the JTA TransactionManager interface, provided that the "autodetectTransactionManager" flag is "true".
See Also:   JtaTransactionManager.setTransactionManagerName
See Also:   JtaTransactionManager.setAutodetectTransactionManager




Constructor Detail
JtaTransactionManager
public JtaTransactionManager()(Code)
Create a new JtaTransactionManager instance, to be configured as bean. Invoke afterPropertiesSet to activate the configuration.
See Also:   JtaTransactionManager.setUserTransactionName
See Also:   JtaTransactionManager.setUserTransaction
See Also:   JtaTransactionManager.setTransactionManagerName
See Also:   JtaTransactionManager.setTransactionManager
See Also:   JtaTransactionManager.afterPropertiesSet()



JtaTransactionManager
public JtaTransactionManager(UserTransaction userTransaction)(Code)
Create a new JtaTransactionManager instance.
Parameters:
  userTransaction - the JTA UserTransaction to use as direct reference



JtaTransactionManager
public JtaTransactionManager(UserTransaction userTransaction, TransactionManager transactionManager)(Code)
Create a new JtaTransactionManager instance.
Parameters:
  userTransaction - the JTA UserTransaction to use as direct reference
Parameters:
  transactionManager - the JTA TransactionManager to use as direct reference



JtaTransactionManager
public JtaTransactionManager(TransactionManager transactionManager)(Code)
Create a new JtaTransactionManager instance.
Parameters:
  transactionManager - the JTA TransactionManager to use as direct reference




Method Detail
afterPropertiesSet
public void afterPropertiesSet() throws TransactionSystemException(Code)
Initialize the UserTransaction as well as the TransactionManager handle.
See Also:   JtaTransactionManager.initUserTransactionAndTransactionManager()



applyIsolationLevel
protected void applyIsolationLevel(JtaTransactionObject txObject, int isolationLevel) throws InvalidIsolationLevelException, SystemException(Code)
Apply the given transaction isolation level. The default implementation will throw an exception for any level other than ISOLATION_DEFAULT.

To be overridden in subclasses for specific JTA implementations, as alternative to overriding the full JtaTransactionManager.doJtaBegin method.
Parameters:
  txObject - the JtaTransactionObject containing the UserTransaction
Parameters:
  isolationLevel - isolation level taken from transaction definition
throws:
  InvalidIsolationLevelException - if the given isolation levelcannot be applied
throws:
  SystemException - if thrown by the JTA implementation
See Also:   JtaTransactionManager.doJtaBegin
See Also:   JtaTransactionObject.getUserTransaction
See Also:   JtaTransactionManager.getTransactionManager()




applyTimeout
protected void applyTimeout(JtaTransactionObject txObject, int timeout) throws SystemException(Code)
Apply the given transaction timeout. The default implementation will call UserTransaction.setTransactionTimeout for a non-default timeout value.
Parameters:
  txObject - the JtaTransactionObject containing the UserTransaction
Parameters:
  timeout - timeout value taken from transaction definition
throws:
  SystemException - if thrown by the JTA implementation
See Also:   JtaTransactionManager.doJtaBegin
See Also:   JtaTransactionObject.getUserTransaction
See Also:   javax.transaction.UserTransaction.setTransactionTimeout(int)



buildUserTransaction
protected UserTransaction buildUserTransaction(TransactionManager transactionManager)(Code)
Build a UserTransaction handle based on the given TransactionManager.
Parameters:
  transactionManager - the TransactionManager a corresponding UserTransaction handle



checkUserTransactionAndTransactionManager
protected void checkUserTransactionAndTransactionManager() throws IllegalStateException(Code)
Check the UserTransaction as well as the TransactionManager handle, assuming standard JTA requirements.
throws:
  IllegalStateException - if no sufficient handles are available



createTransaction
public Transaction createTransaction(String name, int timeout) throws NotSupportedException, SystemException(Code)



doBegin
protected void doBegin(Object transaction, TransactionDefinition definition)(Code)



doCommit
protected void doCommit(DefaultTransactionStatus status)(Code)



doGetJtaTransaction
protected JtaTransactionObject doGetJtaTransaction(UserTransaction ut)(Code)
Get a JTA transaction object for the given current UserTransaction.

Subclasses can override this to provide a JtaTransactionObject subclass, for example holding some additional JTA handle needed.
Parameters:
  ut - the UserTransaction handle to use for the current transaction the JtaTransactionObject holding the UserTransaction




doGetTransaction
protected Object doGetTransaction()(Code)
This implementation returns a JtaTransactionObject instance for the JTA UserTransaction.

The UserTransaction object will either be looked up freshly for the current transaction, or the cached one looked up at startup will be used. The latter is the default: Most application servers use a shared singleton UserTransaction that can be cached. Turn off the "cacheUserTransaction" flag to enforce a fresh lookup for every transaction.
See Also:   JtaTransactionManager.setCacheUserTransaction




doJtaBegin
protected void doJtaBegin(JtaTransactionObject txObject, TransactionDefinition definition) throws NotSupportedException, SystemException(Code)
Perform a JTA begin on the JTA UserTransaction or TransactionManager.

This implementation only supports standard JTA functionality: that is, no per-transaction isolation levels and no transaction names. Can be overridden in subclasses, for specific JTA implementations.

Calls applyIsolationLevel and applyTimeout before invoking the UserTransaction's begin method.
Parameters:
  txObject - the JtaTransactionObject containing the UserTransaction
Parameters:
  definition - TransactionDefinition instance, describing propagationbehavior, isolation level, read-only flag, timeout, and transaction name
throws:
  NotSupportedException - if thrown by JTA methods
throws:
  SystemException - if thrown by JTA methods
See Also:   JtaTransactionManager.getUserTransaction
See Also:   JtaTransactionManager.getTransactionManager
See Also:   JtaTransactionManager.applyIsolationLevel
See Also:   JtaTransactionManager.applyTimeout
See Also:   JtaTransactionObject.getUserTransaction
See Also:   javax.transaction.UserTransaction.setTransactionTimeout
See Also:   javax.transaction.UserTransaction.begin




doJtaResume
protected void doJtaResume(JtaTransactionObject txObject, Object suspendedTransaction) throws InvalidTransactionException, SystemException(Code)
Perform a JTA resume on the JTA TransactionManager.

Can be overridden in subclasses, for specific JTA implementations.
Parameters:
  txObject - the JtaTransactionObject containing the UserTransaction
Parameters:
  suspendedTransaction - the suspended JTA Transaction object
throws:
  InvalidTransactionException - if thrown by JTA methods
throws:
  SystemException - if thrown by JTA methods
See Also:   JtaTransactionManager.getTransactionManager()
See Also:   javax.transaction.TransactionManager.resume(javax.transaction.Transaction)




doJtaSuspend
protected Object doJtaSuspend(JtaTransactionObject txObject) throws SystemException(Code)
Perform a JTA suspend on the JTA TransactionManager.

Can be overridden in subclasses, for specific JTA implementations.
Parameters:
  txObject - the JtaTransactionObject containing the UserTransaction the suspended JTA Transaction object
throws:
  SystemException - if thrown by JTA methods
See Also:   JtaTransactionManager.getTransactionManager()
See Also:   javax.transaction.TransactionManager.suspend




doRegisterAfterCompletionWithJtaTransaction
protected void doRegisterAfterCompletionWithJtaTransaction(JtaTransactionObject txObject, List synchronizations) throws RollbackException, SystemException(Code)
Register a JTA synchronization on the JTA TransactionManager, for calling afterCompletion on the given Spring TransactionSynchronizations.

The default implementation registers the synchronizations on the JTA 1.1 TransactionSynchronizationRegistry, if available, or on the JTA TransactionManager's current Transaction - again, if available. If none of the two is available, a warning will be logged.

Can be overridden in subclasses, for specific JTA implementations.
Parameters:
  txObject - the current transaction object
Parameters:
  synchronizations - List of TransactionSynchronization objects
throws:
  RollbackException - if thrown by JTA methods
throws:
  SystemException - if thrown by JTA methods
See Also:   JtaTransactionManager.getTransactionManager()
See Also:   javax.transaction.Transaction.registerSynchronization
See Also:   javax.transaction.TransactionSynchronizationRegistry.registerInterposedSynchronization




doResume
protected void doResume(Object transaction, Object suspendedResources)(Code)



doRollback
protected void doRollback(DefaultTransactionStatus status)(Code)



doSetRollbackOnly
protected void doSetRollbackOnly(DefaultTransactionStatus status)(Code)



doSuspend
protected Object doSuspend(Object transaction)(Code)



findTransactionManager
protected TransactionManager findTransactionManager(UserTransaction ut)(Code)
Find the JTA TransactionManager through autodetection: checking whether the UserTransaction object implements the TransactionManager, and checking the fallback JNDI locations.
Parameters:
  ut - the JTA UserTransaction object the JTA TransactionManager reference, or null if not found
See Also:   JtaTransactionManager.FALLBACK_TRANSACTION_MANAGER_NAMES



findTransactionSynchronizationRegistry
protected Object findTransactionSynchronizationRegistry(UserTransaction ut, TransactionManager tm) throws TransactionSystemException(Code)
Find the JTA 1.1 TransactionSynchronizationRegistry through autodetection: checking whether the UserTransaction object or TransactionManager object implements it, and checking Java EE 5's standard JNDI location.

The default implementation simply returns null.
Parameters:
  ut - the JTA UserTransaction object
Parameters:
  tm - the JTA TransactionManager object the JTA TransactionSynchronizationRegistry handle to use,or null if none found
throws:
  TransactionSystemException - in case of errors




findUserTransaction
protected UserTransaction findUserTransaction()(Code)
Find the JTA UserTransaction through a default JNDI lookup: "java:comp/UserTransaction". the JTA UserTransaction reference, or null if not found
See Also:   JtaTransactionManager.DEFAULT_USER_TRANSACTION_NAME



getJndiEnvironment
public Properties getJndiEnvironment()(Code)
Return the JNDI environment to use for JNDI lookups.



getJndiTemplate
public JndiTemplate getJndiTemplate()(Code)
Return the JndiTemplate used for JNDI lookups.



getTransactionManager
public TransactionManager getTransactionManager()(Code)
Return the JTA TransactionManager that this transaction manager uses.



getUserTransaction
public UserTransaction getUserTransaction()(Code)
Return the JTA UserTransaction that this transaction manager uses.



initTransactionSynchronizationRegistry
protected void initTransactionSynchronizationRegistry()(Code)
Initialize the JTA 1.1 TransactionSynchronizationRegistry, if available.

To be called after JtaTransactionManager.initUserTransactionAndTransactionManager() , since it may check the UserTransaction and TransactionManager handles.
throws:
  TransactionSystemException - if initialization failed




initUserTransactionAndTransactionManager
protected void initUserTransactionAndTransactionManager() throws TransactionSystemException(Code)
Initialize the UserTransaction as well as the TransactionManager handle.
throws:
  TransactionSystemException - if initialization failed



isExistingTransaction
protected boolean isExistingTransaction(Object transaction)(Code)



lookupTransactionManager
protected TransactionManager lookupTransactionManager(String transactionManagerName) throws TransactionSystemException(Code)
Look up the JTA TransactionManager in JNDI via the configured name.

Called by afterPropertiesSet if no direct TransactionManager reference was set. Can be overridden in subclasses to provide a different TransactionManager object.
Parameters:
  transactionManagerName - the JNDI name of the TransactionManager the UserTransaction object
throws:
  TransactionSystemException - if the JNDI lookup failed
See Also:   JtaTransactionManager.setJndiTemplate
See Also:   JtaTransactionManager.setTransactionManagerName




lookupTransactionSynchronizationRegistry
protected Object lookupTransactionSynchronizationRegistry(String registryName) throws TransactionSystemException(Code)
Look up the JTA TransactionSynchronizationRegistry in JNDI via the configured name.

Can be overridden in subclasses to provide a different TransactionManager object.
Parameters:
  registryName - the JNDI name of theTransactionSynchronizationRegistry the TransactionSynchronizationRegistry object
throws:
  TransactionSystemException - if the JNDI lookup failed
See Also:   JtaTransactionManager.setJndiTemplate
See Also:   JtaTransactionManager.setTransactionSynchronizationRegistryName




lookupUserTransaction
protected UserTransaction lookupUserTransaction(String userTransactionName) throws TransactionSystemException(Code)
Look up the JTA UserTransaction in JNDI via the configured name.

Called by afterPropertiesSet if no direct UserTransaction reference was set. Can be overridden in subclasses to provide a different UserTransaction object.
Parameters:
  userTransactionName - the JNDI name of the UserTransaction the UserTransaction object
throws:
  TransactionSystemException - if the JNDI lookup failed
See Also:   JtaTransactionManager.setJndiTemplate
See Also:   JtaTransactionManager.setUserTransactionName




registerAfterCompletionWithExistingTransaction
protected void registerAfterCompletionWithExistingTransaction(Object transaction, List synchronizations)(Code)



retrieveTransactionManager
protected TransactionManager retrieveTransactionManager() throws TransactionSystemException(Code)
Allows subclasses to retrieve the JTA TransactionManager in a vendor-specific manner. Only called if no "transactionManager" or "transactionManagerName" specified.

The default implementation simply returns null. the JTA TransactionManager handle to use, or null if none found
throws:
  TransactionSystemException - in case of errors
See Also:   JtaTransactionManager.setTransactionManager
See Also:   JtaTransactionManager.setTransactionManagerName




retrieveTransactionSynchronizationRegistry
protected Object retrieveTransactionSynchronizationRegistry() throws TransactionSystemException(Code)
Allows subclasses to retrieve the JTA 1.1 TransactionSynchronizationRegistry in a vendor-specific manner.

The default implementation simply returns null. the JTA TransactionSynchronizationRegistry handle to use,or null if none found
throws:
  TransactionSystemException - in case of errors




retrieveUserTransaction
protected UserTransaction retrieveUserTransaction() throws TransactionSystemException(Code)
Allows subclasses to retrieve the JTA UserTransaction in a vendor-specific manner. Only called if no "userTransaction" or "userTransactionName" specified.

The default implementation simply returns null. the JTA UserTransaction handle to use, or null if none found
throws:
  TransactionSystemException - in case of errors
See Also:   JtaTransactionManager.setUserTransaction
See Also:   JtaTransactionManager.setUserTransactionName




setAllowCustomIsolationLevels
public void setAllowCustomIsolationLevels(boolean allowCustomIsolationLevels)(Code)
Set whether to allow custom isolation levels to be specified.

Default is "false", throwing an exception if a non-default isolation level is specified for a transaction. Turn this flag on if affected resource adapters check the thread-bound transaction context and apply the specified isolation levels individually (e.g. through a IsolationLevelDataSourceRouter).
See Also:   org.springframework.jdbc.datasource.lookup.IsolationLevelDataSourceRouter




setAutodetectTransactionManager
public void setAutodetectTransactionManager(boolean autodetectTransactionManager)(Code)
Set whether to autodetect a JTA UserTransaction object that implements the JTA TransactionManager interface too (i.e. the JNDI location for the TransactionManager is "java:comp/UserTransaction", same as for the UserTransaction). Also checks the fallback JNDI locations "java:comp/TransactionManager" and "java:/TransactionManager". Will proceed without TransactionManager if none found.

Default is "true", autodetecting the TransactionManager unless it has been specified explicitly. Can be turned off to deliberately ignore an available TransactionManager, for example when there are known issues with suspend/resume and any attempt to use REQUIRES_NEW or NOT_SUPPORTED should fail fast.
See Also:   JtaTransactionManager.FALLBACK_TRANSACTION_MANAGER_NAMES




setAutodetectUserTransaction
public void setAutodetectUserTransaction(boolean autodetectUserTransaction)(Code)
Set whether to autodetect the JTA UserTransaction at its default JNDI location "java:comp/UserTransaction", as specified by J2EE. Will proceed without UserTransaction if none found.

Default is "true", autodetecting the UserTransaction unless it has been specified explicitly. Turn this flag off to allow for JtaTransactionManager operating against the TransactionManager only, despite a default UserTransaction being available.
See Also:   JtaTransactionManager.DEFAULT_USER_TRANSACTION_NAME




setCacheUserTransaction
public void setCacheUserTransaction(boolean cacheUserTransaction)(Code)
Set whether to cache the JTA UserTransaction object fetched from JNDI.

Default is "true": UserTransaction lookup will only happen at startup, reusing the same UserTransaction handle for all transactions of all threads. This is the most efficient choice for all application servers that provide a shared UserTransaction object (the typical case).

Turn this flag off to enforce a fresh lookup of the UserTransaction for every transaction. This is only necessary for application servers that return a new UserTransaction for every transaction, keeping state tied to the UserTransaction object itself rather than the current thread.
See Also:   JtaTransactionManager.setUserTransactionName




setJndiEnvironment
public void setJndiEnvironment(Properties jndiEnvironment)(Code)
Set the JNDI environment to use for JNDI lookups. Creates a JndiTemplate with the given environment settings.
See Also:   JtaTransactionManager.setJndiTemplate



setJndiTemplate
public void setJndiTemplate(JndiTemplate jndiTemplate)(Code)
Set the JndiTemplate to use for JNDI lookups. A default one is used if not set.



setTransactionManager
public void setTransactionManager(TransactionManager transactionManager)(Code)
Set the JTA TransactionManager to use as direct reference.

A TransactionManager is necessary for suspending and resuming transactions, as this not supported by the UserTransaction interface.

Note that the TransactionManager will be autodetected if the JTA UserTransaction object implements the JTA TransactionManager interface too, as well as autodetected at various well-known fallback JNDI locations.
See Also:   JtaTransactionManager.setTransactionManagerName
See Also:   JtaTransactionManager.setAutodetectTransactionManager




setTransactionManagerName
public void setTransactionManagerName(String transactionManagerName)(Code)
Set the JNDI name of the JTA TransactionManager.

A TransactionManager is necessary for suspending and resuming transactions, as this not supported by the UserTransaction interface.

Note that the TransactionManager will be autodetected if the JTA UserTransaction object implements the JTA TransactionManager interface too, as well as autodetected at various well-known fallback JNDI locations.
See Also:   JtaTransactionManager.setTransactionManager
See Also:   JtaTransactionManager.setAutodetectTransactionManager




setTransactionSynchronizationRegistryName
public void setTransactionSynchronizationRegistryName(String transactionSynchronizationRegistryName)(Code)
Set the JNDI name of the JTA 1.1 TransactionSynchronizationRegistry.

Note that the TransactionSynchronizationRegistry will be autodetected at the Java EE 5 default location "java:comp/TransactionSynchronizationRegistry" if not specified explicitly.
See Also:   JtaTransactionManager.DEFAULT_TRANSACTION_SYNCHRONIZATION_REGISTRY_NAME




setUserTransaction
public void setUserTransaction(UserTransaction userTransaction)(Code)
Set the JTA UserTransaction to use as direct reference.

Typically just used for local JTA setups; in a J2EE environment, the UserTransaction will always be fetched from JNDI.
See Also:   JtaTransactionManager.setUserTransactionName
See Also:   JtaTransactionManager.setAutodetectUserTransaction




setUserTransactionName
public void setUserTransactionName(String userTransactionName)(Code)
Set the JNDI name of the JTA UserTransaction.

Note that the UserTransaction will be autodetected at the J2EE default location "java:comp/UserTransaction" if not specified explicitly.
See Also:   JtaTransactionManager.DEFAULT_USER_TRANSACTION_NAME
See Also:   JtaTransactionManager.setUserTransaction
See Also:   JtaTransactionManager.setAutodetectUserTransaction




shouldCommitOnGlobalRollbackOnly
protected boolean shouldCommitOnGlobalRollbackOnly()(Code)
This implementation returns "true": a JTA commit will properly handle transactions that have been marked rollback-only at a global level.



useSavepointForNestedTransaction
protected boolean useSavepointForNestedTransaction()(Code)
This implementation returns false to cause a further invocation of doBegin despite an already existing transaction.

JTA implementations might support nested transactions via further UserTransaction.begin() invocations, but never support savepoints.
See Also:   JtaTransactionManager.doBegin
See Also:   javax.transaction.UserTransaction.begin




Fields inherited from org.springframework.transaction.support.AbstractPlatformTransactionManager
final public static int SYNCHRONIZATION_ALWAYS(Code)(Java Doc)
final public static int SYNCHRONIZATION_NEVER(Code)(Java Doc)
final public static int SYNCHRONIZATION_ON_ACTUAL_TRANSACTION(Code)(Java Doc)
protected transient Log logger(Code)(Java Doc)

Methods inherited from org.springframework.transaction.support.AbstractPlatformTransactionManager
final public void commit(TransactionStatus status) throws TransactionException(Code)(Java Doc)
protected int determineTimeout(TransactionDefinition definition)(Code)(Java Doc)
abstract protected void doBegin(Object transaction, TransactionDefinition definition) throws TransactionException(Code)(Java Doc)
protected void doCleanupAfterCompletion(Object transaction)(Code)(Java Doc)
abstract protected void doCommit(DefaultTransactionStatus status) throws TransactionException(Code)(Java Doc)
abstract protected Object doGetTransaction() throws TransactionException(Code)(Java Doc)
protected void doResume(Object transaction, Object suspendedResources) throws TransactionException(Code)(Java Doc)
abstract protected void doRollback(DefaultTransactionStatus status) throws TransactionException(Code)(Java Doc)
protected void doSetRollbackOnly(DefaultTransactionStatus status) throws TransactionException(Code)(Java Doc)
protected Object doSuspend(Object transaction) throws TransactionException(Code)(Java Doc)
final public int getDefaultTimeout()(Code)(Java Doc)
final public TransactionStatus getTransaction(TransactionDefinition definition) throws TransactionException(Code)(Java Doc)
final public int getTransactionSynchronization()(Code)(Java Doc)
final protected void invokeAfterCompletion(List synchronizations, int completionStatus)(Code)(Java Doc)
protected boolean isExistingTransaction(Object transaction) throws TransactionException(Code)(Java Doc)
final public boolean isFailEarlyOnGlobalRollbackOnly()(Code)(Java Doc)
final public boolean isGlobalRollbackOnParticipationFailure()(Code)(Java Doc)
final public boolean isNestedTransactionAllowed()(Code)(Java Doc)
final public boolean isRollbackOnCommitFailure()(Code)(Java Doc)
protected DefaultTransactionStatus newTransactionStatus(TransactionDefinition definition, Object transaction, boolean newTransaction, boolean newSynchronization, boolean debug, Object suspendedResources)(Code)(Java Doc)
protected void registerAfterCompletionWithExistingTransaction(Object transaction, List synchronizations) throws TransactionException(Code)(Java Doc)
final protected void resume(Object transaction, SuspendedResourcesHolder resourcesHolder) throws TransactionException(Code)(Java Doc)
final public void rollback(TransactionStatus status) throws TransactionException(Code)(Java Doc)
final public void setDefaultTimeout(int defaultTimeout)(Code)(Java Doc)
final public void setFailEarlyOnGlobalRollbackOnly(boolean failEarlyOnGlobalRollbackOnly)(Code)(Java Doc)
final public void setGlobalRollbackOnParticipationFailure(boolean globalRollbackOnParticipationFailure)(Code)(Java Doc)
final public void setNestedTransactionAllowed(boolean nestedTransactionAllowed)(Code)(Java Doc)
final public void setRollbackOnCommitFailure(boolean rollbackOnCommitFailure)(Code)(Java Doc)
final public void setTransactionSynchronization(int transactionSynchronization)(Code)(Java Doc)
final public void setTransactionSynchronizationName(String constantName)(Code)(Java Doc)
protected boolean shouldCommitOnGlobalRollbackOnly()(Code)(Java Doc)
final protected SuspendedResourcesHolder suspend(Object transaction) throws TransactionException(Code)(Java Doc)
final protected void triggerBeforeCommit(DefaultTransactionStatus status)(Code)(Java Doc)
final protected void triggerBeforeCompletion(DefaultTransactionStatus status)(Code)(Java Doc)
protected boolean useSavepointForNestedTransaction()(Code)(Java Doc)

Methods inherited from java.lang.Object
native protected Object clone() throws CloneNotSupportedException(Code)(Java Doc)
public boolean equals(Object obj)(Code)(Java Doc)
protected void finalize() throws Throwable(Code)(Java Doc)
final native public Class getClass()(Code)(Java Doc)
native public int hashCode()(Code)(Java Doc)
final native public void notify()(Code)(Java Doc)
final native public void notifyAll()(Code)(Java Doc)
public String toString()(Code)(Java Doc)
final native public void wait(long timeout) throws InterruptedException(Code)(Java Doc)
final public void wait(long timeout, int nanos) throws InterruptedException(Code)(Java Doc)
final public void wait() throws InterruptedException(Code)(Java Doc)

www.java2java.com | Contact Us
Copyright 2009 - 12 Demo Source and Support. All rights reserved.
All other trademarks are property of their respective owners.