org.springframework.transaction.jta

Class WebLogicJtaTransactionManager

java.lang.Object

org.springframework.transaction.support.AbstractPlatformTransactionManager

org.springframework.transaction.jta.JtaTransactionManager

org.springframework.transaction.jta.WebLogicJtaTransactionManager

All Implemented Interfaces:

java.io.Serializable, InitializingBean, TransactionFactory, PlatformTransactionManager

public class WebLogicJtaTransactionManager
extends JtaTransactionManager

Special JtaTransactionManager variant for BEA WebLogic (9.0 and higher). Supports the full power of Spring's transaction definitions on WebLogic's transaction coordinator, beyond standard JTA: transaction names, per-transaction isolation levels, and proper resuming of transactions in all cases.

Uses WebLogic's special begin(name) method to start a JTA transaction, in order to make Spring-driven transactions visible in WebLogic's transaction monitor. In case of Spring's declarative transactions, the exposed name will (by default) be the fully-qualified class name + "." + method name.

Supports a per-transaction isolation level through WebLogic's corresponding JTA transaction property "ISOLATION LEVEL". This will apply the specified isolation level (e.g. ISOLATION_SERIALIZABLE) to all JDBC Connections that participate in the given transaction.

Invokes WebLogic's special forceResume method if standard JTA resume failed, to also resume if the target transaction was marked rollback-only. If you're not relying on this feature of transaction suspension in the first place, Spring's standard JtaTransactionManager will behave properly too.

By default, the JTA UserTransaction and TransactionManager handles are fetched directly from WebLogic's TransactionHelper. This can be overridden by specifying "userTransaction"/"userTransactionName" and "transactionManager"/"transactionManagerName", passing in existing handles or specifying corresponding JNDI locations to look up.

NOTE: This JtaTransactionManager is intended to refine specific transaction demarcation behavior on Spring's side. It will happily co-exist with independently configured WebLogic transaction strategies in your persistence provider, with no need to specifically connect those setups in any way.

Since:

1.1

Author:

Juergen Hoeller

See Also:

TransactionDefinition.getName(), TransactionDefinition.getIsolationLevel(), weblogic.transaction.UserTransaction#begin(String), weblogic.transaction.Transaction#setProperty, weblogic.transaction.TransactionManager#forceResume, weblogic.transaction.TransactionHelper, Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.springframework.transaction.support.AbstractPlatformTransactionManager

AbstractPlatformTransactionManager.SuspendedResourcesHolder

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.reflect.Method	beginWithNameAndTimeoutMethod
private java.lang.reflect.Method	beginWithNameMethod
private static java.lang.String	CLIENT_TRANSACTION_MANAGER_CLASS_NAME
private java.lang.reflect.Method	forceResumeMethod
private static java.lang.String	ISOLATION_LEVEL_KEY
private java.lang.reflect.Method	setPropertyMethod
private static java.lang.String	TRANSACTION_CLASS_NAME
private static java.lang.String	TRANSACTION_HELPER_CLASS_NAME
private java.lang.Object	transactionHelper
private static java.lang.String	USER_TRANSACTION_CLASS_NAME
private boolean	weblogicTransactionManagerAvailable
private boolean	weblogicUserTransactionAvailable

Fields inherited from class org.springframework.transaction.jta.JtaTransactionManager

DEFAULT_TRANSACTION_SYNCHRONIZATION_REGISTRY_NAME, DEFAULT_USER_TRANSACTION_NAME, FALLBACK_TRANSACTION_MANAGER_NAMES

Fields inherited from class org.springframework.transaction.support.AbstractPlatformTransactionManager

logger, SYNCHRONIZATION_ALWAYS, SYNCHRONIZATION_NEVER, SYNCHRONIZATION_ON_ACTUAL_TRANSACTION

Constructor Summary

Constructors

Constructor and Description
WebLogicJtaTransactionManager()

Method Summary

Modifier and Type	Method and Description
void	afterPropertiesSet() Initialize the UserTransaction as well as the TransactionManager handle.
Transaction	createTransaction(java.lang.String name, int timeout) Create an active Transaction object based on the given name and timeout.
protected void	doJtaBegin(JtaTransactionObject txObject, TransactionDefinition definition) Perform a JTA begin on the JTA UserTransaction or TransactionManager.
protected void	doJtaResume(JtaTransactionObject txObject, java.lang.Object suspendedTransaction) Perform a JTA resume on the JTA TransactionManager.
private void	loadWebLogicTransactionClasses()
private void	loadWebLogicTransactionHelper()
protected TransactionManager	retrieveTransactionManager() Allows subclasses to retrieve the JTA TransactionManager in a vendor-specific manner.
protected UserTransaction	retrieveUserTransaction() Allows subclasses to retrieve the JTA UserTransaction in a vendor-specific manner.

Methods inherited from class org.springframework.transaction.jta.JtaTransactionManager

applyIsolationLevel, applyTimeout, buildUserTransaction, checkUserTransactionAndTransactionManager, doBegin, doCommit, doGetJtaTransaction, doGetTransaction, doJtaSuspend, doRegisterAfterCompletionWithJtaTransaction, doResume, doRollback, doSetRollbackOnly, doSuspend, findTransactionManager, findTransactionSynchronizationRegistry, findUserTransaction, getJndiEnvironment, getJndiTemplate, getTransactionManager, getTransactionSynchronizationRegistry, getUserTransaction, initTransactionSynchronizationRegistry, initUserTransactionAndTransactionManager, isExistingTransaction, lookupTransactionManager, lookupTransactionSynchronizationRegistry, lookupUserTransaction, registerAfterCompletionWithExistingTransaction, retrieveTransactionSynchronizationRegistry, setAllowCustomIsolationLevels, setAutodetectTransactionManager, setAutodetectTransactionSynchronizationRegistry, setAutodetectUserTransaction, setCacheUserTransaction, setJndiEnvironment, setJndiTemplate, setTransactionManager, setTransactionManagerName, setTransactionSynchronizationRegistry, setTransactionSynchronizationRegistryName, setUserTransaction, setUserTransactionName, shouldCommitOnGlobalRollbackOnly, supportsResourceAdapterManagedTransactions, useSavepointForNestedTransaction

Methods inherited from class org.springframework.transaction.support.AbstractPlatformTransactionManager

commit, determineTimeout, doCleanupAfterCompletion, getDefaultTimeout, getTransaction, getTransactionSynchronization, invokeAfterCompletion, isFailEarlyOnGlobalRollbackOnly, isGlobalRollbackOnParticipationFailure, isNestedTransactionAllowed, isRollbackOnCommitFailure, isValidateExistingTransaction, newTransactionStatus, prepareForCommit, prepareSynchronization, prepareTransactionStatus, resume, rollback, setDefaultTimeout, setFailEarlyOnGlobalRollbackOnly, setGlobalRollbackOnParticipationFailure, setNestedTransactionAllowed, setRollbackOnCommitFailure, setTransactionSynchronization, setTransactionSynchronizationName, setValidateExistingTransaction, suspend, triggerBeforeCommit, triggerBeforeCompletion

Methods inherited from class java.lang.Object

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

Field Detail

USER_TRANSACTION_CLASS_NAME

private static final java.lang.String USER_TRANSACTION_CLASS_NAME

See Also:

Constant Field Values

CLIENT_TRANSACTION_MANAGER_CLASS_NAME

private static final java.lang.String CLIENT_TRANSACTION_MANAGER_CLASS_NAME

See Also:

Constant Field Values

TRANSACTION_CLASS_NAME

private static final java.lang.String TRANSACTION_CLASS_NAME

See Also:

Constant Field Values

TRANSACTION_HELPER_CLASS_NAME

private static final java.lang.String TRANSACTION_HELPER_CLASS_NAME

See Also:

Constant Field Values

ISOLATION_LEVEL_KEY

private static final java.lang.String ISOLATION_LEVEL_KEY

See Also:

Constant Field Values

weblogicUserTransactionAvailable

private boolean weblogicUserTransactionAvailable

beginWithNameMethod

private java.lang.reflect.Method beginWithNameMethod

beginWithNameAndTimeoutMethod

private java.lang.reflect.Method beginWithNameAndTimeoutMethod

weblogicTransactionManagerAvailable

private boolean weblogicTransactionManagerAvailable

forceResumeMethod

private java.lang.reflect.Method forceResumeMethod

setPropertyMethod

private java.lang.reflect.Method setPropertyMethod

transactionHelper

private java.lang.Object transactionHelper

Constructor Detail

WebLogicJtaTransactionManager

public WebLogicJtaTransactionManager()

Method Detail

afterPropertiesSet

public void afterPropertiesSet()
                        throws TransactionSystemException

Description copied from class: JtaTransactionManager

Initialize the UserTransaction as well as the TransactionManager handle.

Specified by:

afterPropertiesSet in interface InitializingBean

Overrides:

afterPropertiesSet in class JtaTransactionManager

Throws:

TransactionSystemException

See Also:

JtaTransactionManager.initUserTransactionAndTransactionManager()

retrieveUserTransaction

protected UserTransaction retrieveUserTransaction()
                                           throws TransactionSystemException

Description copied from class: JtaTransactionManager

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.

Overrides:

retrieveUserTransaction in class JtaTransactionManager

Returns:

the JTA UserTransaction handle to use, or null if none found

Throws:

TransactionSystemException - in case of errors

See Also:

JtaTransactionManager.setUserTransaction(UserTransaction), JtaTransactionManager.setUserTransactionName(java.lang.String)

retrieveTransactionManager

protected TransactionManager retrieveTransactionManager()
                                                 throws TransactionSystemException

Description copied from class: JtaTransactionManager

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.

Overrides:

retrieveTransactionManager in class JtaTransactionManager

Returns:

the JTA TransactionManager handle to use, or null if none found

Throws:

TransactionSystemException - in case of errors

See Also:

JtaTransactionManager.setTransactionManager(TransactionManager), JtaTransactionManager.setTransactionManagerName(java.lang.String)

loadWebLogicTransactionHelper

private void loadWebLogicTransactionHelper()
                                    throws TransactionSystemException

Throws:

TransactionSystemException

loadWebLogicTransactionClasses

private void loadWebLogicTransactionClasses()
                                     throws TransactionSystemException

Throws:

TransactionSystemException

doJtaBegin

protected void doJtaBegin(JtaTransactionObject txObject,
                          TransactionDefinition definition)
                   throws NotSupportedException,
                          SystemException

Description copied from class: JtaTransactionManager

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.

Overrides:

doJtaBegin in class JtaTransactionManager

Parameters:

txObject - the JtaTransactionObject containing the UserTransaction

definition - TransactionDefinition instance, describing propagation behavior, isolation level, read-only flag, timeout, and transaction name

Throws:

NotSupportedException - if thrown by JTA methods

SystemException - if thrown by JTA methods

See Also:

JtaTransactionManager.getUserTransaction(), JtaTransactionManager.getTransactionManager(), JtaTransactionManager.applyIsolationLevel(org.springframework.transaction.jta.JtaTransactionObject, int), JtaTransactionManager.applyTimeout(org.springframework.transaction.jta.JtaTransactionObject, int), JtaTransactionObject.getUserTransaction(), javax.transaction.UserTransaction#setTransactionTimeout, javax.transaction.UserTransaction#begin

doJtaResume

protected void doJtaResume(JtaTransactionObject txObject,
                           java.lang.Object suspendedTransaction)
                    throws javax.transaction.InvalidTransactionException,
                           SystemException

Description copied from class: JtaTransactionManager

Perform a JTA resume on the JTA TransactionManager.

Can be overridden in subclasses, for specific JTA implementations.

Overrides:

doJtaResume in class JtaTransactionManager

Parameters:

txObject - the JtaTransactionObject containing the UserTransaction

suspendedTransaction - the suspended JTA Transaction object

Throws:

javax.transaction.InvalidTransactionException - if thrown by JTA methods

SystemException - if thrown by JTA methods

See Also:

JtaTransactionManager.getTransactionManager(), javax.transaction.TransactionManager#resume(javax.transaction.Transaction)

createTransaction

public Transaction createTransaction(java.lang.String name,
                                     int timeout)
                              throws NotSupportedException,
                                     SystemException

Description copied from interface: TransactionFactory

Create an active Transaction object based on the given name and timeout.

Specified by:

createTransaction in interface TransactionFactory

Overrides:

createTransaction in class JtaTransactionManager

Parameters:

name - the transaction name (may be null)

timeout - the transaction timeout (may be -1 for the default timeout)

Returns:

the active Transaction object (never null)

Throws:

NotSupportedException - if the transaction manager does not support a transaction of the specified type

SystemException - if the transaction manager failed to create the transaction