前言
上一篇文章,我介绍了 @Transactional 源码解析——事务准备阶段,建议在阅读本文章前,先移步阅读上面的文章。本文关注的重点是事务的执行阶段,TransactionInterceptor
正是支撑该阶段的架构,那么现在我们切入正题来分析此拦截器是如何实现事务特性的。
1. TransactionInterceptor 整体流程
当程序执行事务方法的时候,就会先走增强器TransactionInterceptor#invoke
方法:
public Object invoke(final MethodInvocation invocation) throws Throwable {
// Work out the target class: may be {@code null}.
// The TransactionAttributeSource should be passed the target class
// as well as the method, which may be from an interface.
Class<?> targetClass = (invocation.getThis() != null ? AopUtils.getTargetClass(invocation.getThis()) : null);
// Adapt to TransactionAspectSupport's invokeWithinTransaction...
return invokeWithinTransaction(invocation.getMethod(), targetClass, new InvocationCallback() {
@Override
public Object proceedWithInvocation() throws Throwable {
return invocation.proceed();
}
});
}
protected Object invokeWithinTransaction(Method method, Class<?> targetClass, final InvocationCallback invocation)
throws Throwable {
// 获取对应事务属性
final TransactionAttribute txAttr = getTransactionAttributeSource().getTransactionAttribute(method, targetClass);
// 获取 beanFactory 中的 transactionManager,需要配置
final PlatformTransactionManager tm = determineTransactionManager(txAttr);
// 获取方法唯一标识(类.方法 如 xxx.UserServiceImpl.save)
final String joinpointIdentification = methodIdentification(method, targetClass, txAttr);
// 声明式事务处理 @Transactional
if (txAttr == null || !(tm instanceof CallbackPreferringPlatformTransactionManager)) {
// 创建 TransactionInfo
TransactionInfo txInfo = createTransactionIfNecessary(tm, txAttr, joinpointIdentification);
Object retVal = null;
try {
// 执行被增强方法
retVal = invocation.proceedWithInvocation();
}
catch (Throwable ex) {
// 异常回滚
completeTransactionAfterThrowing(txInfo, ex);
throw ex;
}
finally {
cleanupTransactionInfo(txInfo);
}
// 提交事务
commitTransactionAfterReturning(txInfo);
return retVal;
}
// 编程式事务
else {
final ThrowableHolder throwableHolder = new ThrowableHolder();
// It's a CallbackPreferringPlatformTransactionManager: pass a TransactionCallback in.
try {
Object result = ((CallbackPreferringPlatformTransactionManager) tm).execute(txAttr,
new TransactionCallback<Object>() {
@Override
public Object doInTransaction(TransactionStatus status) {
TransactionInfo txInfo = prepareTransactionInfo(tm, txAttr, joinpointIdentification, status);
try {
return invocation.proceedWithInvocation();
}
catch (Throwable ex) {
if (txAttr.rollbackOn(ex)) {
// A RuntimeException: will lead to a rollback.
if (ex instanceof RuntimeException) {
throw (RuntimeException) ex;
}
else {
throw new ThrowableHolderException(ex);
}
}
else {
// A normal return value: will lead to a commit.
throwableHolder.throwable = ex;
return null;
}
}
finally {
cleanupTransactionInfo(txInfo);
}
}
});
// Check result state: It might indicate a Throwable to rethrow.
if (throwableHolder.throwable != null) {
throw throwableHolder.throwable;
}
return result;
}
catch (ThrowableHolderException ex) {
throw ex.getCause();
}
catch (TransactionSystemException ex2) {
if (throwableHolder.throwable != null) {
logger.error("Application exception overridden by commit exception", throwableHolder.throwable);
ex2.initApplicationException(throwableHolder.throwable);
}
throw ex2;
}
catch (Throwable ex2) {
if (throwableHolder.throwable != null) {
logger.error("Application exception overridden by commit exception", throwableHolder.throwable);
}
throw ex2;
}
}
}
从上面的函数中,我们尝试整理下事务处理的脉络,在 Spring 中支持两种事务处理方式,分别是声明式事务与编程式事务处理,两者对于开发人员来说差别很大,但是对于 Spring 中的实现来讲,大同小异。在invoke
中,我们也看到这两种方式的实现。考虑到声明式事务相对流行些,我们就以此种方式进行分析。
对于声明式事务处理主要有以下几个步骤:
- 获取事务属性。
该部分我们在分析事务准备阶段时已经分析了,这里就不累述。 - 加载配置中配置的
TransactionManager
。 - 不同的事务处理方式使用不同的逻辑。
对于声明式事务的处理与编程式事务的处理,最主要的区别在于TransactionManager
上,CallbackPreferringPlatformTransactionManager
实现PlatformTransactionManager
接口,暴露出一个方法用于执行事务处理中的回调。 - 在目标方法执行前获取事务并且收集事务信息
事务信息与事务属性并不相同,也就是TransactionInfo
与TransactionaAttribute
并不相同,TransactionInfo
包含TransactionaAttribute
,但是除了TransactionaAttribute
外还有其他事务信息,例如PlatformTransactionManager
以及TransactionStatus
相关信息。 - 执行目标方法。
- 一旦出现异常,尝试异常处理。
并不是所有的异常,Spring 都会将其回滚,默认只对RuntimeException
回滚,当然这个可以指定。 - 提交事务前的事务信息清除。
- 提交事务。
上面的步骤分析旨在让大家对事务功能与步骤大致的了解,具体功能还需详细的分析。
2. 创建事务
我们首先分析事务创建的过程。
protected TransactionInfo createTransactionIfNecessary(
PlatformTransactionManager tm, TransactionAttribute txAttr, final String joinpointIdentification) {
// 如果没有名称指定,则使用方法唯一标识
if (txAttr != null && txAttr.getName() == null) {
txAttr = new DelegatingTransactionAttribute(txAttr) {
@Override
public String getName() {
return joinpointIdentification;
}
};
}
TransactionStatus status = null;
if (txAttr != null) {
if (tm != null) {
// 获取 TransactionStatus
status = tm.getTransaction(txAttr);
}
else {
if (logger.isDebugEnabled()) {
logger.debug("Skipping transactional joinpoint [" + joinpointIdentification +
"] because no transaction manager has been configured");
}
}
}
// 根据指定的属性和 status 构建一个 TransactionInfo
return prepareTransactionInfo(tm, txAttr, joinpointIdentification, status);
}
对于createTransactionIfNecessary
函数主要做了这样几件事情。
- 获取事务
- 构建事务信息
2.1 获取事务
getTransaction
函数,提供了获取事务的功能:
public final TransactionStatus getTransaction(TransactionDefinition definition) throws TransactionException {
// 获取 transaction
Object transaction = doGetTransaction();
// Cache debug flag to avoid repeated checks.
boolean debugEnabled = logger.isDebugEnabled();
if (definition == null) {
// Use defaults if no transaction definition given.
definition = new DefaultTransactionDefinition();
}
// 判断当前线程是否存在事务,判断的依据是当前线程记录的连接不为空且连接(connectionHolder)中的 transactionActive 属性不为空
if (isExistingTransaction(transaction)) {
// 当线程已经存在事务
return handleExistingTransaction(definition, transaction, debugEnabled);
}
// 事务超时设置验证
if (definition.getTimeout() < TransactionDefinition.TIMEOUT_DEFAULT) {
throw new InvalidTimeoutException("Invalid transaction timeout", definition.getTimeout());
}
//如果当前线程不存在事务,但是 propagation 却被声明为 PROPAGATION_MANDATORY(强制必须要有事务),则抛出异常
if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_MANDATORY) {
throw new IllegalTransactionStateException(
"No existing transaction found for transaction marked with propagation 'mandatory'");
}
else if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_REQUIRED ||
definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_REQUIRES_NEW ||
definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NESTED) {
// 新建事务,空挂起
SuspendedResourcesHolder suspendedResources = suspend(null);
if (debugEnabled) {
logger.debug("Creating new transaction with name [" + definition.getName() + "]: " + definition);
}
try {
boolean newSynchronization = (getTransactionSynchronization() != SYNCHRONIZATION_NEVER);
DefaultTransactionStatus status = newTransactionStatus(
definition, transaction, true, newSynchronization, debugEnabled, suspendedResources);
// 构造 transaction,包括设置 ConnectionHolder、隔离级别、timeout,如果是新连接,绑定到当前线程
doBegin(transaction, definition);
// 新同步事务的设置,针对当前线程的设置
prepareSynchronization(status, definition);
return status;
}
catch (RuntimeException ex) {
resume(null, suspendedResources);
throw ex;
}
catch (Error err) {
resume(null, suspendedResources);
throw err;
}
}
else {
// Create "empty" transaction: no actual transaction, but potentially synchronization.
if (definition.getIsolationLevel() != TransactionDefinition.ISOLATION_DEFAULT && logger.isWarnEnabled()) {
logger.warn("Custom isolation level specified but no actual transaction initiated; " +
"isolation level will effectively be ignored: " + definition);
}
boolean newSynchronization = (getTransactionSynchronization() == SYNCHRONIZATION_ALWAYS);
return prepareTransactionStatus(definition, null, true, newSynchronization, debugEnabled, null);
}
}
该方法主要有以下几个步骤:
- 获取事务。
创建对应的事务实例。将ConnectionHolder
存入事务实例中,ConnectionHolder
底层是ThreadLocal
保存了当前线程的数据库连接信息,如果当前线程没有数据库连接信息,则存入 null。 - 如果当前线程存在事务,则转向嵌套事务的处理。
- 事务超时设置验证。
- 事务
propagationBehavior
属性的设置验证。 - 构建
DefaultTransactionStatus
。 - 完善事务信息
transaction
,包括设置ConnectionHolder
、隔离级别、timeout,如果是新连接,则绑定到当前线程。
对于一些隔离级别、timeout 等功能的设置并不是由 Spring 来完成的,而是委托底层的数据库连接去做的,而对于数据库连接的设置就是doBegin
函数中处理的:
protected void doBegin(Object transaction, TransactionDefinition definition) {
DataSourceTransactionObject txObject = (DataSourceTransactionObject) transaction;
Connection con = null;
try {
if (!txObject.hasConnectionHolder() ||
txObject.getConnectionHolder().isSynchronizedWithTransaction()) {
Connection newCon = this.dataSource.getConnection();
if (logger.isDebugEnabled()) {
logger.debug("Acquired Connection [" + newCon + "] for JDBC transaction");
}
txObject.setConnectionHolder(new ConnectionHolder(newCon), true);
}
txObject.getConnectionHolder().setSynchronizedWithTransaction(true);
con = txObject.getConnectionHolder().getConnection();
// 设置隔离级别
Integer previousIsolationLevel = DataSourceUtils.prepareConnectionForTransaction(con, definition);
txObject.setPreviousIsolationLevel(previousIsolationLevel);
// 更改自动提交设置,由 Spring 控制提交
if (con.getAutoCommit()) {
txObject.setMustRestoreAutoCommit(true);
if (logger.isDebugEnabled()) {
logger.debug("Switching JDBC Connection [" + con + "] to manual commit");
}
con.setAutoCommit(false);
}
prepareTransactionalConnection(con, definition);
// 设置判断当前线程是否存在事务的依据
txObject.getConnectionHolder().setTransactionActive(true);
int timeout = determineTimeout(definition);
if (timeout != TransactionDefinition.TIMEOUT_DEFAULT) {
txObject.getConnectionHolder().setTimeoutInSeconds(timeout);
}
// Bind the connection holder to the thread.
if (txObject.isNewConnectionHolder()) {
// 将当前获取到的连接绑定到当前线程
TransactionSynchronizationManager.bindResource(getDataSource(), txObject.getConnectionHolder());
}
}
catch (Throwable ex) {
if (txObject.isNewConnectionHolder()) {
DataSourceUtils.releaseConnection(con, this.dataSource);
txObject.setConnectionHolder(null, false);
}
throw new CannotCreateTransactionException("Could not open JDBC Connection for transaction", ex);
}
}
可以说事务是从这个函数开始的,因为这个函数中已经开始尝试对数据库连接的获取了。当然,在获取数据库连接的同时,一些必要的设置也是需要同步设置的。
- 尝试获取连接。
如果当前线程中的connectionHolder
不存在,或者对于事务同步表示设置为 true 的,需要重新连接。反之,复用当前线程连接。 - 设置隔离级别以及只读标识。
你是否有过这样的错觉?事务中的只读配置是 Spring 中做了一些处理? Spring 中确实是针对只读做了一些处理,但是核心的实现是设置connection
上的readOnly
属性。同样,对于隔离级别的控制也是交由connection
去控制的。 - 更改默认的提交设置。
如果事务属性是自动提交,那么需要改变这种设置,而将提交操作交由 Spring 来处理。 - 设置标识位,标识当前连接已经被事务激活。
- 设置过期时间。
- 将
connectionHolder
绑定到当前线程。
2.2 处理已经存在的事务
上面讲述的是普通事务创建的过程,但是 Spring 还支持多种事务的传播规则,比如 PROPAGATION_NESTED、PROPAGATION_REQUIRES_NEW 等,这些都是在已经存在事务的基础上进一步的处理。那么对于已经存在的事务,Spring 又是如何处理的呢?
private TransactionStatus handleExistingTransaction(
TransactionDefinition definition, Object transaction, boolean debugEnabled)
throws TransactionException {
if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NEVER) {
throw new IllegalTransactionStateException(
"Existing transaction found for transaction marked with propagation 'never'");
}
// 如果传播方式为 PROPAGATION_NOT_SUPPORTED,则挂起当前事务,并且事务信息设置为 null
if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NOT_SUPPORTED) {
if (debugEnabled) {
logger.debug("Suspending current transaction");
}
Object suspendedResources = suspend(transaction);
boolean newSynchronization = (getTransactionSynchronization() == SYNCHRONIZATION_ALWAYS);
return prepareTransactionStatus(
definition, null, false, newSynchronization, debugEnabled, suspendedResources);
}
// 如果传播方式为 PROPAGATION_REQUIRES_NEW,则挂起当前事务,并且新建一个独立的事务
if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_REQUIRES_NEW) {
if (debugEnabled) {
logger.debug("Suspending current transaction, creating new transaction with name [" +
definition.getName() + "]");
}
SuspendedResourcesHolder suspendedResources = suspend(transaction);
try {
boolean newSynchronization = (getTransactionSynchronization() != SYNCHRONIZATION_NEVER);
DefaultTransactionStatus status = newTransactionStatus(
definition, transaction, true, newSynchronization, debugEnabled, suspendedResources);
// 这里会创建一个新的事务,并且是新的数据库连接
doBegin(transaction, definition);
prepareSynchronization(status, definition);
return status;
}
catch (RuntimeException beginEx) {
resumeAfterBeginException(transaction, suspendedResources, beginEx);
throw beginEx;
}
catch (Error beginErr) {
resumeAfterBeginException(transaction, suspendedResources, beginErr);
throw beginErr;
}
}
// 嵌入式事务的处理
if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NESTED) {
if (!isNestedTransactionAllowed()) {
throw new NestedTransactionNotSupportedException(
"Transaction manager does not allow nested transactions by default - " +
"specify 'nestedTransactionAllowed' property with value 'true'");
}
if (debugEnabled) {
logger.debug("Creating nested transaction with name [" + definition.getName() + "]");
}
if (useSavepointForNestedTransaction()) {
// 创建保存点
DefaultTransactionStatus status =
prepareTransactionStatus(definition, transaction, false, false, debugEnabled, null);
status.createAndHoldSavepoint();
return status;
}
else {
// 有些情况是不能使用保存点操作的,比如 JTA,那么建立新事物
boolean newSynchronization = (getTransactionSynchronization() != SYNCHRONIZATION_NEVER);
DefaultTransactionStatus status = newTransactionStatus(
definition, transaction, true, newSynchronization, debugEnabled, null);
doBegin(transaction, definition);
prepareSynchronization(status, definition);
return status;
}
}
// Assumably PROPAGATION_SUPPORTS or PROPAGATION_REQUIRED.
if (debugEnabled) {
logger.debug("Participating in existing transaction");
}
if (isValidateExistingTransaction()) {
if (definition.getIsolationLevel() != TransactionDefinition.ISOLATION_DEFAULT) {
Integer currentIsolationLevel = TransactionSynchronizationManager.getCurrentTransactionIsolationLevel();
if (currentIsolationLevel == null || currentIsolationLevel != definition.getIsolationLevel()) {
Constants isoConstants = DefaultTransactionDefinition.constants;
throw new IllegalTransactionStateException("Participating transaction with definition [" +
definition + "] specifies isolation level which is incompatible with existing transaction: " +
(currentIsolationLevel != null ?
isoConstants.toCode(currentIsolationLevel, DefaultTransactionDefinition.PREFIX_ISOLATION) :
"(unknown)"));
}
}
if (!definition.isReadOnly()) {
if (TransactionSynchronizationManager.isCurrentTransactionReadOnly()) {
throw new IllegalTransactionStateException("Participating transaction with definition [" +
definition + "] is not marked as read-only but existing transaction is");
}
}
}
boolean newSynchronization = (getTransactionSynchronization() != SYNCHRONIZATION_NEVER);
return prepareTransactionStatus(definition, transaction, false, newSynchronization, debugEnabled, null);
}
对于已经存在事务的处理过程中,函数对已经存在事务处理考虑两种情况:
- PROPAGATION_REQUIRES_NEW:表示当前方法必须在它自己的事务里运行,一个新的事务将被启动(新的数据库连接),而如果有一个事务正在运行的话,则在这个方法运行期间被挂起。将事务挂起的目的当然是为了在当前事务执行完毕后再将原事务恢复。
- PROPAGATION_NESTED:表示如果当前正有一个事务正常运行中,则方法应该运行在一个嵌套的事务中,被嵌套的事务可以独立于外部事物进行提交或者回滚。如果外部事物不存在,行为就像 PROPAGATION_REQUIRES_NEW。对于嵌入式事务,Spring 主要考虑了两种方式的处理:
- Spring 中允许嵌入事务的时候(默认允许),则首选设置保存点的方式作为异常回滚的处理。但是内部事务的数据库连接依旧是外部事务的连接。
- 对于其他方式,比如 JTA(跨数据源的分布式事务)无法使用保存点的方式,那么处理方式与 PROPAGATION_REQUIRES_NEW 相同。
3. 回滚事务处理
之前已经完成了目标方法执行之前的事务准备工作,而这些准备工作最大的目的无非就是对于程序没有按照我们期待的那样进行,也就是出现特定的错误。那么出现错误的时候,Spring 是如何对数据进行恢复的呢?
protected void completeTransactionAfterThrowing(TransactionInfo txInfo, Throwable ex) {
if (txInfo != null && txInfo.hasTransaction()) {
if (logger.isTraceEnabled()) {
logger.trace("Completing transaction for [" + txInfo.getJoinpointIdentification() +
"] after exception: " + ex);
}
// 判断异常是否是 RuntimeException 类型或者是 Error 类型
if (txInfo.transactionAttribute.rollbackOn(ex)) {
try {
// 根据 TransactionStatus 信息进行回滚处理
txInfo.getTransactionManager().rollback(txInfo.getTransactionStatus());
}
catch (TransactionSystemException ex2) {
logger.error("Application exception overridden by rollback exception", ex);
ex2.initApplicationException(ex);
throw ex2;
}
catch (RuntimeException ex2) {
logger.error("Application exception overridden by rollback exception", ex);
throw ex2;
}
catch (Error err) {
logger.error("Application exception overridden by rollback error", ex);
throw err;
}
}
else {
// 如果不满足回滚条件,即使抛出异常也同样会提交
try {
txInfo.getTransactionManager().commit(txInfo.getTransactionStatus());
}
catch (TransactionSystemException ex2) {
logger.error("Application exception overridden by commit exception", ex);
ex2.initApplicationException(ex);
throw ex2;
}
catch (RuntimeException ex2) {
logger.error("Application exception overridden by commit exception", ex);
throw ex2;
}
catch (Error err) {
logger.error("Application exception overridden by commit error", ex);
throw err;
}
}
}
}
3.1 回滚条件
public boolean rollbackOn(Throwable ex) {
return (ex instanceof RuntimeException || ex instanceof Error);
}
默认情况下,Spring 中的事务异常处理机制只对RuntimeException
和Error
两种情况有效。当然你可以指定异常处理类型,例如:
@Transactional(rollbackFor=Exception.class)
3.2 回滚处理
当然,一旦符合回滚条件,那么 Spring 就会将程序引导至回滚的处理函数。
public final void rollback(TransactionStatus status) throws TransactionException {
if (status.isCompleted()) {
throw new IllegalTransactionStateException(
"Transaction is already completed - do not call commit or rollback more than once per transaction");
}
DefaultTransactionStatus defStatus = (DefaultTransactionStatus) status;
processRollback(defStatus);
}
private void processRollback(DefaultTransactionStatus status) {
try {
try {
// 激活所有 TransactionSynchronization 中对应的 beforeCompletion 方法
triggerBeforeCompletion(status);
// 如果有保存点,则回退到保存点
if (status.hasSavepoint()) {
if (status.isDebug()) {
logger.debug("Rolling back transaction to savepoint");
}
status.rollbackToHeldSavepoint();
}
// 如果当前事务为独立的新事物,则直接回滚
else if (status.isNewTransaction()) {
if (status.isDebug()) {
logger.debug("Initiating transaction rollback");
}
doRollback(status);
}
// 如果当前事务不是独立的事务,那么只能标记状态,等到事务链执行完毕后统一回滚
else if (status.hasTransaction()) {
if (status.isLocalRollbackOnly() || isGlobalRollbackOnParticipationFailure()) {
if (status.isDebug()) {
logger.debug("Participating transaction failed - marking existing transaction as rollback-only");
}
doSetRollbackOnly(status);
}
else {
if (status.isDebug()) {
logger.debug("Participating transaction failed - letting transaction originator decide on rollback");
}
}
}
else {
logger.debug("Should roll back transaction but cannot - no transaction available");
}
}
catch (RuntimeException ex) {
triggerAfterCompletion(status, TransactionSynchronization.STATUS_UNKNOWN);
throw ex;
}
catch (Error err) {
triggerAfterCompletion(status, TransactionSynchronization.STATUS_UNKNOWN);
throw err;
}
// 激活所有 TransactionSynchronization 中对应的 afterCompletion 方法
triggerAfterCompletion(status, TransactionSynchronization.STATUS_ROLLED_BACK);
}
finally {
// 清空记录的资源并将挂起的资源恢复
cleanupAfterCompletion(status);
}
}
我们总结下 Spring 中对于回滚处理的大致脉络:
- 首先是自定义触发器的调用,包括在回滚前、回滚后的调用。对于触发器的注册,常见的是在回调过程中通过
TransactionSynchronizationManager
类中的静态方法直接注册:
public static void registerSynchronization(TransactionSynchronization synchronization)
- 除了触发监听函数外,就是真正的回滚逻辑处理了。
-
当之前已经存在保存点信息的时候,使用保存点信息进行回滚。常用于嵌入式事务,对于嵌入式事务的处理,内部的事务异常并不会引起外部事务的回滚,只有外部事务的回滚或者提交才是事务完成的标志。
保存点回滚的实现方式其实是通过底层的数据库连接进行的。
当事务信息为新事务时,那么直接回滚。常用于单独事务的处理,如 PROPAGATION_REQUIRED 和 PROPAGATION_REQUIRES_NEW。对于没有保存点的回滚,Spring 同样是使用底层数据库连接提供的 API 来操作的。
当事务信息中表明已经存在事务,又不属于以上两种情况,多数用于 JTA,只做回滚标识,等到提交的时候统一进行回滚。
3.3 回滚后的信息清除
对于回滚逻辑执行结束后,无论回滚成功与否,都必须要做的事情就是事务结束后的收尾工作。
private void cleanupAfterCompletion(DefaultTransactionStatus status) {
// 设置完成状态
status.setCompleted();
if (status.isNewSynchronization()) {
TransactionSynchronizationManager.clear();
}
if (status.isNewTransaction()) {
doCleanupAfterCompletion(status.getTransaction());
}
if (status.getSuspendedResources() != null) {
if (status.isDebug()) {
logger.debug("Resuming suspended transaction after completion of inner transaction");
}
// 将挂起的事务恢复
resume(status.getTransaction(), (SuspendedResourcesHolder) status.getSuspendedResources());
}
}
从函数中得知,事务处理的收尾工作包括如下内容:
- 如果当前事务是新的同步状态,需要将绑定到当前线程的事务信息清除。
- 如果当前事务是新事务,则做些清除资源的操作。如:
- 将数据库连接从当前线程中接触绑定
- 恢复数据库连接的自动提交属性,并且重置数据库连接
- 如果当前事务是独立的新事务,则释放数据库连接
- 清空
ConnectionHolder
- 如果在事务执行前有事务挂起,那么当前事务执行结束后需要将挂起的事务恢复。
4. 提交事务处理
之前我们分析了 Spring 的事务异常处理机制,那么事务的执行并没有出现任何异常,也就意味着可以走正常的事务提交流程了。
protected void commitTransactionAfterReturning(TransactionInfo txInfo) {
if (txInfo != null && txInfo.hasTransaction()) {
if (logger.isTraceEnabled()) {
logger.trace("Completing transaction for [" + txInfo.getJoinpointIdentification() + "]");
}
txInfo.getTransactionManager().commit(txInfo.getTransactionStatus());
}
}
public final void commit(TransactionStatus status) throws TransactionException {
if (status.isCompleted()) {
throw new IllegalTransactionStateException(
"Transaction is already completed - do not call commit or rollback more than once per transaction");
}
DefaultTransactionStatus defStatus = (DefaultTransactionStatus) status;
// 如果在事务链中已经被标记回滚,那么不会尝试提交事务,直接回滚
if (defStatus.isLocalRollbackOnly()) {
if (defStatus.isDebug()) {
logger.debug("Transactional code has requested rollback");
}
processRollback(defStatus);
return;
}
// 如果当前事务被标记为回滚状态,则进行回滚操作
if (!shouldCommitOnGlobalRollbackOnly() && defStatus.isGlobalRollbackOnly()) {
if (defStatus.isDebug()) {
logger.debug("Global transaction is marked as rollback-only but transactional code requested commit");
}
processRollback(defStatus);
// Throw UnexpectedRollbackException only at outermost transaction boundary
// or if explicitly asked to.
if (status.isNewTransaction() || isFailEarlyOnGlobalRollbackOnly()) {
throw new UnexpectedRollbackException(
"Transaction rolled back because it has been marked as rollback-only");
}
return;
}
// 执行提交操作
processCommit(defStatus);
}
而事务执行一切正常的时候,便可以真正进入提交流程了。
private void processCommit(DefaultTransactionStatus status) throws TransactionException {
try {
boolean beforeCompletionInvoked = false;
try {
prepareForCommit(status);
// 激活 TransactionSynchronization 中的 beforeCommit 方法
triggerBeforeCommit(status);
// 激活 TransactionSynchronization 中的 beforeCompletion 方法
triggerBeforeCompletion(status);
beforeCompletionInvoked = true;
boolean globalRollbackOnly = false;
if (status.isNewTransaction() || isFailEarlyOnGlobalRollbackOnly()) {
globalRollbackOnly = status.isGlobalRollbackOnly();
}
// 如果存在保存点则清除保存点信息
if (status.hasSavepoint()) {
if (status.isDebug()) {
logger.debug("Releasing transaction savepoint");
}
status.releaseHeldSavepoint();
}
// 如果是独立的新事务则直接提交
else if (status.isNewTransaction()) {
if (status.isDebug()) {
logger.debug("Initiating transaction commit");
}
doCommit(status);
}
// Throw UnexpectedRollbackException if we have a global rollback-only
// marker but still didn't get a corresponding exception from commit.
if (globalRollbackOnly) {
throw new UnexpectedRollbackException(
"Transaction silently rolled back because it has been marked as rollback-only");
}
}
catch (UnexpectedRollbackException ex) {
// can only be caused by doCommit
triggerAfterCompletion(status, TransactionSynchronization.STATUS_ROLLED_BACK);
throw ex;
}
catch (TransactionException ex) {
// can only be caused by doCommit
if (isRollbackOnCommitFailure()) {
doRollbackOnCommitException(status, ex);
}
else {
triggerAfterCompletion(status, TransactionSynchronization.STATUS_UNKNOWN);
}
throw ex;
}
catch (RuntimeException ex) {
if (!beforeCompletionInvoked) {
triggerBeforeCompletion(status);
}
doRollbackOnCommitException(status, ex);
throw ex;
}
catch (Error err) {
if (!beforeCompletionInvoked) {
triggerBeforeCompletion(status);
}
doRollbackOnCommitException(status, err);
throw err;
}
// Trigger afterCommit callbacks, with an exception thrown there
// propagated to callers but the transaction still considered as committed.
try {
triggerAfterCommit(status);
}
finally {
triggerAfterCompletion(status, TransactionSynchronization.STATUS_COMMITTED);
}
}
finally {
cleanupAfterCompletion(status);
}
}
在提交过程中并不是直接提交的,而是考虑了诸多方面,符合提交的条件如下:
- 当事务状态中有保存点信息的便不会去提交事务
- 当事务非新事务的时候也不会去执行提交事务操作
此条件主要考虑内嵌事务的情况,对于内嵌事务,在 Spring 中正常的处理方式是将内嵌事务开始之前设置保存点,一旦内嵌事务出现异常便根据保存点信息进行回滚。但是如果没有出现异常,内嵌事务并不会单独提交,而是根据事务流由最外层事务负责提交,所以如果当前存在保存点信息便不是最外层事务,不做提交操作。即只有是独立的新事务才会提交。
5. 结语
至此,@Transactional
源码解析,已经讲解完毕。鄙人理解有限,如有不对的地方,请留言指出,谢谢!