public class SpringAwareUserTransaction extends org.springframework.transaction.interceptor.TransactionAspectSupport implements UserTransaction, org.springframework.transaction.interceptor.TransactionAttributeSource, org.springframework.transaction.interceptor.TransactionAttribute
UserTransaction
that will allow the thread using it to participate
in transactions that are normally only begun and committed by the SpringFramework
transaction aware components.
Client code can use this class directly, but should be very careful to handle the exception
conditions with the appropriate finally
blocks and rollback
code.
It is recommended that clients use this class indirectly via an instance of the
org.alfresco.repo.transaction.RetryingTransactionHelper
.
This class is thread-safe in that it will detect multithreaded access and throw exceptions. Therefore do not use on multiple threads. Instances should be used only for the duration of the required user transaction and then discarded. Any attempt to reuse an instance will result in failure.
Nested user transaction are allowed.
Logging:
To dump exceptions during commits, turn debugging on for this class.
To log leaked transactions i.e. a begin() is not matched by a commit() or rollback(),
add .trace to the usual classname-based debug category and set to WARN log
level. This will log the first detection of a leaked transaction and automatically enable
transaction call stack logging for subsequent leaked transactions. To enforce
call stack logging from the start set the .trace log level to DEBUG. Call stack
logging will hamper performance but is useful when it appears that something is eating
connections or holding onto resources - usually a sign that client code hasn't handled all
possible exception conditions.
PlatformTransactionManager
,
DefaultTransactionDefinition
ISOLATION_DEFAULT, ISOLATION_READ_COMMITTED, ISOLATION_READ_UNCOMMITTED, ISOLATION_REPEATABLE_READ, ISOLATION_SERIALIZABLE, PROPAGATION_MANDATORY, PROPAGATION_NESTED, PROPAGATION_NEVER, PROPAGATION_NOT_SUPPORTED, PROPAGATION_REQUIRED, PROPAGATION_REQUIRES_NEW, PROPAGATION_SUPPORTS, TIMEOUT_DEFAULT
Constructor and Description |
---|
SpringAwareUserTransaction(org.springframework.transaction.PlatformTransactionManager transactionManager,
boolean readOnly,
int isolationLevel,
int propagationBehaviour,
int timeout)
Creates a user transaction that defaults to
TransactionDefinition.PROPAGATION_REQUIRED . |
Modifier and Type | Method and Description |
---|---|
void |
begin() |
void |
commit() |
protected void |
completeTransactionAfterThrowing(org.springframework.transaction.interceptor.TransactionAspectSupport.TransactionInfo txInfo,
Throwable ex) |
protected void |
finalize() |
int |
getIsolationLevel() |
String |
getName() |
int |
getPropagationBehavior() |
String |
getQualifier()
Return a qualifier value associated with this transaction attribute.
|
int |
getStatus()
This status is a combination of the internal status, as recorded during explicit operations,
and the status provided by the Spring support.
|
int |
getTimeout() |
org.springframework.transaction.interceptor.TransactionAttribute |
getTransactionAttribute(Method method,
Class<?> targetClass)
This class carries all the information required to fullfil requests about the transaction
attributes.
|
boolean |
isReadOnly() |
void |
rollback() |
boolean |
rollbackOn(Throwable ex)
The
UserTransaction must rollback regardless of the error. |
void |
setRollbackOnly() |
void |
setTransactionTimeout(int timeout)
Implementation required for
UserTransaction . |
String |
toString() |
afterPropertiesSet, cleanupTransactionInfo, clearTransactionManagerCache, commitTransactionAfterReturning, createTransactionIfNecessary, currentTransactionInfo, currentTransactionStatus, determineTransactionManager, getBeanFactory, getTransactionAttributeSource, getTransactionManager, getTransactionManagerBeanName, invokeWithinTransaction, methodIdentification, prepareTransactionInfo, setBeanFactory, setTransactionAttributes, setTransactionAttributeSource, setTransactionAttributeSources, setTransactionManager, setTransactionManagerBeanName
public SpringAwareUserTransaction(org.springframework.transaction.PlatformTransactionManager transactionManager, boolean readOnly, int isolationLevel, int propagationBehaviour, int timeout)
TransactionDefinition.PROPAGATION_REQUIRED
.transactionManager
- the transaction manager to usereadOnly
- true to force a read-only transactionisolationLevel
- one of the
TransactionDefinition.ISOLATION_XXX
constantspropagationBehaviour
- one of the
TransactionDefinition.PROPAGATION__XXX
constantstimeout
- the transaction timeout in seconds.TransactionDefinition.getTimeout()
public org.springframework.transaction.interceptor.TransactionAttribute getTransactionAttribute(Method method, Class<?> targetClass)
getTransactionAttribute
in interface org.springframework.transaction.interceptor.TransactionAttributeSource
this
instancepublic String getQualifier()
getQualifier
in interface org.springframework.transaction.interceptor.TransactionAttribute
public boolean rollbackOn(Throwable ex)
UserTransaction
must rollback regardless of the error. The
rollback
behaviour is implemented by simulating a caught
exception. As this method will always return true
, the rollback
behaviour will be to rollback the transaction or mark it for rollback.rollbackOn
in interface org.springframework.transaction.interceptor.TransactionAttribute
public String getName()
getName
in interface org.springframework.transaction.TransactionDefinition
public boolean isReadOnly()
isReadOnly
in interface org.springframework.transaction.TransactionDefinition
public int getIsolationLevel()
getIsolationLevel
in interface org.springframework.transaction.TransactionDefinition
public int getPropagationBehavior()
getPropagationBehavior
in interface org.springframework.transaction.TransactionDefinition
public int getTimeout()
getTimeout
in interface org.springframework.transaction.TransactionDefinition
public void setTransactionTimeout(int timeout) throws SystemException
UserTransaction
.setTransactionTimeout
in interface UserTransaction
SystemException
public int getStatus() throws SystemException
getStatus
in interface UserTransaction
SystemException
Status
public void setRollbackOnly() throws IllegalStateException, SystemException
setRollbackOnly
in interface UserTransaction
IllegalStateException
SystemException
public void begin() throws NotSupportedException, SystemException
begin
in interface UserTransaction
NotSupportedException
- if an attempt is made to reuse this instanceSystemException
public void commit() throws RollbackException, HeuristicMixedException, HeuristicRollbackException, SecurityException, IllegalStateException, SystemException
commit
in interface UserTransaction
IllegalStateException
- if a transaction was not startedRollbackException
HeuristicMixedException
HeuristicRollbackException
SecurityException
SystemException
public void rollback() throws IllegalStateException, SecurityException, SystemException
rollback
in interface UserTransaction
IllegalStateException
SecurityException
SystemException
protected void completeTransactionAfterThrowing(org.springframework.transaction.interceptor.TransactionAspectSupport.TransactionInfo txInfo, Throwable ex)
completeTransactionAfterThrowing
in class org.springframework.transaction.interceptor.TransactionAspectSupport
Copyright © 2005–2020 Alfresco Software. All rights reserved.