Spring事务源码分析
1. 背景
因为最近在看MyBatis-Spring的源码,但是里面涉及了颇多Spring事务底层API的知识,看完后有点似懂非懂的样子,于是便有了这篇文章。下面的源码分析仅针对于DataSourceTransactionManager这一个具体的事务管理器。当你直接使用JDBC编程或者使用MyBatis时使用的事务管理器就是DataSourceTransactionManager。在看这篇文章前可以先过下前文对事务相关接口以及类的介绍,让心中有一个数,两篇文章搭配来看效果会更好。
注: 以下源码出自Spring 4.3.18版本。
2. Spring事务API的使用
在分析源码前,先搞一个小例子跑起来,顺带简单介绍下如何使用Spring事务的底层API来管理事务。这里简单放下关键配置以及运行代码。
XML配置
<!-- 数据库连接池配置(Druid) -->
<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource">
<!-- 数据库驱动 -->
<property name="driverClassName" value="com.mysql.jdbc.Driver"/>
<!-- 数据库地址 -->
<property name="url" value="jdbc:mysql://127.0.0.1:3306/test" />
<!-- 数据库用户名 -->
<property name="username" value="root"/>
<!-- 数据库密码 -->
<property name="password" value="123456"/>
</bean>
<!-- 事务管理器,事务就靠它啦 -->
<bean
id="transactionManager"
class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource" />
</bean>
<!-- JdbcTemplate,用来操作数据 -->
<bean id="jdbcTemplate" class="org.springframework.jdbc.core.JdbcTemplate">
<constructor-arg name="dataSource" ref="dataSource" />
</bean>
<!-- 事务模板,内部封装了事务开启以及提交回滚的操作,只需关心业务代码 -->
<bean id="transactionTemplate" class="org.springframework.transaction.support.TransactionTemplate">
<property name="transactionManager" ref="transactionManager" />
</bean>
测试代码
@RunWith(SpringRunner.class)
@ContextConfiguration(locations = {"classpath:spring-tx.xml"})
public class TransactionTest {
@Autowired
private DataSourceTransactionManager transactionManager;
@Autowired
private JdbcTemplate jdbcTemplate;
@Autowired
private TransactionTemplate transactionTemplate;
/** 随便一个操作数据库的方法吧 **/
private Integer findCount(Integer id) {
final String sql = "SELECT COUNT(*) FROM student";
return jdbcTemplate.queryForObject(sql, Integer.class);
}
// 直接使用API来管理事务
@Test
public void transactionByAPI() {
// 使用默认的隔离级别,默认的传播行为(PROPAGATION_REQUIRED)开启一个事务
// 此方法会从给定的数据源中获取一个连接, 设置自动提交模式为false, 并且将连接绑定到当前线程。
// JdbcTemplate内部会调用DataSourceUtils.getConnection(database)从线程中获取绑定的连接
TransactionStatus transactionStatus = transactionManager.getTransaction(
new DefaultTransactionDefinition());
try {
findCount();
transactionManager.commit(transactionStatus);
} catch (RuntimeException e) {
transactionManager.rollback(transactionStatus);
throw e;
}
}
// 使用TransactionTemplate操作事务, execute方法内部封装了事务样板代码, 只需要专注业务.
@Test
public void transactionByTemplate() {
transactionTemplate.execute(new TransactionCallback<Student>() {
@Override
public Integer doInTransaction(TransactionStatus status) {
return findCount();
}
});
}
}
3. 源码分析
在分析源码前先做一个约定,以免引起误解,Spring为了解决方法调用时每个方法中的事务该如何运行,引进了事务传播行为这一属性。我们有以下几种说法,如果熟悉传播行为的话,下面这些特别容易理解。
- 当外部不存在真实事务,指定的传播行为不新建真实事务时(PROPAGATION_SUPPORTS、PROPAGATION_NOT_SUPPORTED、PROPAGATION_NEVER),我们说Spring开启了一个新的空事务。
- 当外部不存在真实事务,指定的传播行为新建一个真实事务时(PROPAGATION_REQUIRED、PROPAGATION_REQUIRES_NEW、PROPAGATION_NESTED),我们说Spring开启了一个新的真实事务。
- 当外部存在一个真实事务,指定的传播行为(PROPAGATION_REQUIRED、PROPAGATION_SUPPORTS,PROPAGATION_MANDATORY)是参与到外部事务时,我们说这是一个参与事务。
- 当外部存在一个真实事务,指定的传播行为是PROPAGATION_NESTED,我们说这是一个嵌套事务。嵌套事务是利用JDBC标准的保存点来实现的,依然依赖于外部事务。
- 当外部存在一个真实事务,指定的传播行为是PROPAGATION_REQUIRES_NEW时,此时会挂起外部事务,开启一个新的真实事务,相当于一个独立的真实事务。只有一点影响,如果这个新的真实事务向外抛出了异常,而被外部事务捕捉,可能会引起外部事务回滚(具体看外部事务如何处理这个异常)。这个新的真实事务完全不受外部事务影响。
- 当外部存在一个真实事务,指定的传播行为是PROPAGATION_NOT_SUPPORTED时,此时会挂起外部事务,开启一个新的空事务,行为与上一条一样,只是一个以事务方式运行,一个以非事务方式运行。
注:
- 因此说开启事务,并不是说就开启了一个真实事务,可能开启了一个空事务,也有可能只是参与到外部事务中运行。空事务是以非事务方式运行。
- 注意说明带的新字,因为这个事务是新建的才需要释放开启事务时获取的资源(如果有的话,空事务不会获取连接)。新说明事务是独立的,如果有外部事物的话,不会依赖于外部事务。
- 只有这个事务是新的真实事务时,事务管理器在commit/rollback后才会清理线程中绑定的连接资源,其实是一个ConnectionHolder对象,并且重置从数据源中拿到的连接,然后归还。当然也只有这个事务是新的真实事务,开启事务时才会从数据源中拿连接,并且绑定到当前线程。
3.1 开启事务(getTransaction)
// 位于 DataSourceTransactionManager.java
@Override
protected Object doGetTransaction() {
// 代表一个事务对象
DataSourceTransactionObject txObject = new DataSourceTransactionObject();
// nestedTransactionAllowed属性在事务管理器构造方法就初始化为true了
// 这个值代表支不支持嵌套事务
txObject.setSavepointAllowed(isNestedTransactionAllowed());
// 从当前线程获取绑定的资源,如果Spring要开启一个新的真实事务时,该值为null
// 比方说这次开启的是一个参与事务,那么拿到的就是外部事务绑定的资源了
ConnectionHolder conHolder = (ConnectionHolder) TransactionSynchronizationManager.
getResource(this.dataSource);
// 设置值,第二个参数代表是不是一个新的connectionHolder
// 如果conHolder=null, 第二个参数会在后续被修改成true, 继续往下看吧。
// 这里也可以得知参与事务与外部事务的事务对象中共享一个connectionHolder
// 只是会标识出不是一个新的connectionHolder
txObject.setConnectionHolder(conHolder, false);
return txObject;
}
// 位于 AbstractPlatformTransactionManager.java
public final TransactionStatus getTransaction(TransactionDefinition definition) throws TransactionException {
// 获取一个事务对象,由子类实现(看上面解析)
Object transaction = doGetTransaction();
// Cache debug flag to avoid repeated checks.
boolean debugEnabled = logger.isDebugEnabled();
// 如果传进来的definition为空,则使用一个默认定义
if (definition == null) {
definition = new DefaultTransactionDefinition();
}
// 在开启事务前判断下当前有没有真实事务存在来决定走向,下面再说.
if (isExistingTransaction(transaction)) {
return handleExistingTransaction(definition, transaction, debugEnabled);
}
if (definition.getTimeout() < TransactionDefinition.TIMEOUT_DEFAULT) {
throw new InvalidTimeoutException("Invalid transaction timeout", definition.getTimeout());
}
// 现在外部不存在真实事务,如果传播行为是PROPAGATION_MANDATORY,则抛出异常
// 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);
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 {
// 走到这里说明指定的传播行为为PROPAGATION_SUPPORTS、PROPAGATION_NOT_SUPPORTED、
// PROPAGATION_NEVER,新建一个空事务
// 尽管是一个空事务,也会根据属性来决定需不需要绑定事务的各个属性到当前线程。
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);
}
}
可以看到getTransaction最终由三个分支走向,我们先看最简单的第三个分支吧(创建一个空事务)
// 判断下隔离级别,如果有指定隔离级别,但是不是在真实的事务环境中运行,会被忽略掉
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);
// 返回一个DefaultTransactionStatus
// 可以去看下前文对DefaultTransactionStatus的介绍,对各个属性有详细介绍
// 第二个参数为null, 说明是一个空事务
// 第三个参数为true, 说明这是一个新开的事务
// 第四个参数在默认情况下是true, 但是在下文可能依旧会被修改。
// 第五个参数没啥好说的
// 第六个参数是被挂起的资源,如果在开启事务时有挂起外部事务时,需要将外部事务涉及的属性和连接保存到这里
// 当此事务调用commit或者rollback方法时会将挂起的资源恢复,开启一个空事务,当然是null,不需要恢复。
return prepareTransactionStatus(definition, null, true, newSynchronization, debugEnabled, null);
}
protected final DefaultTransactionStatus prepareTransactionStatus(
TransactionDefinition definition, Object transaction, boolean newTransaction,
boolean newSynchronization, boolean debug, Object suspendedResources) {
// 创建一个DefaultTransactionStatus对象
DefaultTransactionStatus status = newTransactionStatus(
definition, transaction, newTransaction, newSynchronization, debug, suspendedResources);
prepareSynchronization(status, definition);
return status;
}
protected DefaultTransactionStatus newTransactionStatus(
TransactionDefinition definition, Object transaction, boolean newTransaction,
boolean newSynchronization, boolean debug, Object suspendedResources) {
// 判断当前线程是否已经同步,如果同步过便不再需要同步
boolean actualNewSynchronization = newSynchronization &&
!TransactionSynchronizationManager.isSynchronizationActive();
return new DefaultTransactionStatus(
transaction, newTransaction, actualNewSynchronization,
definition.isReadOnly(), debug, suspendedResources);
}
protected void prepareSynchronization(DefaultTransactionStatus status, TransactionDefinition definition) {
// 需要同步的话
if (status.isNewSynchronization()) {
// 此事务是一个真实事务,设置为true, 否则为null
TransactionSynchronizationManager.setActualTransactionActive(
status.hasTransaction());
// 设置此事务的隔离级别
TransactionSynchronizationManager.setCurrentTransactionIsolationLevel(
definition.getIsolationLevel() != TransactionDefinition.ISOLATION_DEFAULT ?
definition.getIsolationLevel() : null);
// 设置事务只读
TransactionSynchronizationManager.setCurrentTransactionReadOnly(
definition.isReadOnly());
// 设置此事务的名字,默认为null
TransactionSynchronizationManager.setCurrentTransactionName(
definition.getName());
// 初始化线程里的事务同步,管理的是一组TransactionSynchronization
// TransactionSynchronization接口定义了一组钩子,在事务各个期间触发
// 事务管理器内部没有向里面注册过TransactionSynchronization
// 初始化只是初始化一个空集合
TransactionSynchronizationManager.initSynchronization();
}
}
现在看第二个分支(外部不存在真实事务,创建一个新的真实事务)
// 挂起资源(看下面具体解析)
// suspend方法的参数是一个事务对象,代表要挂起该事务,并且情况线程绑定的资源以及事务状态
// 这里外部不存在真实事务,为什么也要调用呢?
// 这是因为外部可能存在一个空事务,需要将这个外部空事务曾经向当前线程绑定的事务状态清空
// 而空事务的事务对象就是null, 这也是为什么参数传null的原因。
SuspendedResourcesHolder suspendedResources = suspend(null);
if (debugEnabled) {
logger.debug("Creating new transaction with name [" + definition.getName() + "]: " + definition);
}
try {
// 默认为true
boolean newSynchronization = (getTransactionSynchronization() != SYNCHRONIZATION_NEVER);
DefaultTransactionStatus status = newTransactionStatus(
definition, transaction, true, newSynchronization, debugEnabled, suspendedResources);
// 重点来了,这里便会从数据源中拿到一个连接,对这个连接设置一系列参数(自动提交,隔离级别,事务只读)
// 同时将连接绑定到当前线程,具体往下看
doBegin(transaction, definition);
// 此方法已经说过,不再展开
prepareSynchronization(status, definition);
return status;
}
catch (RuntimeException ex) {
// 出现异常,恢复挂起的资源
resume(null, suspendedResources);
throw ex;
}
catch (Error err) {
resume(null, suspendedResources);
throw err;
}
// =====================================分割线=====================================
protected final SuspendedResourcesHolder suspend(Object transaction) throws TransactionException {
// 如果为true,说明存在外部事务(空事务或者真实事务)同步过,我们需要将同步过的状态清空并
// 保存到当前事务的TransactionStatus对象中,当前事务结束后会根据保存的信息将外部事务状态
// 恢复,重新绑定到当前线程
if (TransactionSynchronizationManager.isSynchronizationActive()) {
// 如果有注册过TransactionSynchronization,则触发每一个TransactionSynchronization
// 接口的suspend钩子,并且将同步状态清除掉。
// 也就是说再调用TransactionSynchronizationManager.isSynchronizationActive()会返回
// false. 同时返回TransactionSynchronization列表,用以将来的恢复。
List<TransactionSynchronization> suspendedSynchronizations = doSuspendSynchro
nization();
try {
Object suspendedResources = null;
// 挂起事务对象,也就是将事务持有的连接对象置为null
// 同时将当前线程的绑定的连接清空
if (transaction != null) {
suspendedResources = doSuspend(transaction);
}
// 一系列清空操作
String name = TransactionSynchronizationManager.getCurrentTransactionName();
TransactionSynchronizationManager.setCurrentTransactionName(null);
boolean readOnly = TransactionSynchronizationManager.isCurrentTransactionReadOnly();
TransactionSynchronizationManager.setCurrentTransactionReadOnly(false);
Integer isolationLevel = TransactionSynchronizationManager.getCurrentTransactionIsolationLevel();
TransactionSynchronizationManager.setCurrentTransactionIsolationLevel(null);
boolean wasActive = TransactionSynchronizationManager.isActualTransactionActive();
TransactionSynchronizationManager.setActualTransactionActive(false);
return new SuspendedResourcesHolder(
suspendedResources, suspendedSynchronizations, name, readOnly, isolationLevel, wasActive);
}
catch (RuntimeException ex) {
// doSuspend failed - original transaction is still active...
doResumeSynchronization(suspendedSynchronizations);
throw ex;
}
catch (Error err) {
// doSuspend failed - original transaction is still active...
doResumeSynchronization(suspendedSynchronizations);
throw err;
}
}
else if (transaction != null) {
// Transaction active but no synchronization active.
Object suspendedResources = doSuspend(transaction);
return new SuspendedResourcesHolder(suspendedResources);
}
else {
// Neither transaction nor synchronization active.
return null;
}
}
// =====================================分割线=====================================
// 既然说了suspend,那么作为对称,把resume也放这说了吧
protected final void resume(Object transaction, SuspendedResourcesHolder resourcesHolder)
throws TransactionException {
if (resourcesHolder != null) {
// 获取被挂起的连接
Object suspendedResources = resourcesHolder.suspendedResources;
if (suspendedResources != null) {
// 重新将连接绑定到当前线程
doResume(transaction, suspendedResources);
// doResume 调的是以下代码
// TransactionSynchronizationManager.bindResource(
// this.dataSource, suspendedResources);
}
// 恢复被挂起事务的各种属性
List<TransactionSynchronization> suspendedSynchronizations = resourcesHol
der.suspendedSynhronizations;
if (suspendedSynchronizations != null) {
TransactionSynchronizationManager.setActualTransactionActive(
resourcesHolder.wasActive);
TransactionSynchronizationManager.setCurrentTransactionIsolationLevel(
resourcesHolder.isolationLevel);
TransactionSynchronizationManager.setCurrentTransactionReadOnly(
resourcesHolder.readOnly);
TransactionSynchronizationManager.setCurrentTransactionName(
resourcesHolder.name);
doResumeSynchronization(suspendedSynchronizations);
}
}
}
private void doResumeSynchronization(List<TransactionSynchronization> suspendedSynchronizations) {
// 重新初始化同步状态,并将这些TransactionSynchronization恢复
TransactionSynchronizationManager.initSynchronization();
for (TransactionSynchronization synchronization : suspendedSynchronizations) {
// 触发resume钩子
synchronization.resume();
TransactionSynchronizationManager.registerSynchronization(synchronization);
}
}
@Override
protected void doBegin(Object transaction, TransactionDefinition definition) {
DataSourceTransactionObject txObject = (DataSourceTransactionObject) transaction;
Connection con = null;
try {
// 事务对象中connectionHolder属性为null
// 还记得doGetTransaction()方法吗,此方法会获取线程中绑定的连接,如果没有绑定就是null
if (!txObject.hasConnectionHolder() ||
txObject.getConnectionHolder().isSynchronizedWithTransaction()) {
// 从数据源中获取连接
Connection newCon = this.dataSource.getConnection();
if (logger.isDebugEnabled()) {
logger.debug("Acquired Connection [" + newCon + "] for JDBC transaction");
}
// 重新设置值,第二个参数为true, 代表这是一个新的connectionHolder
txObject.setConnectionHolder(new ConnectionHolder(newCon), true);
}
txObject.getConnectionHolder().setSynchronizedWithTransaction(true);
con = txObject.getConnectionHolder().getConnection();
// 这里会根据传进来的definition设置连接的隔离级别以及事务是否只读
// 并且返回从数据库获取时的隔离级别,以便将来将连接归还时恢复
Integer previousIsolationLevel = DataSourceUtils.prepareConnectionForTransaction(con, definition);
txObject.setPreviousIsolationLevel(previousIsolationLevel);
// 将自动提交模式修改为false, 开启一个真实的事务
if (con.getAutoCommit()) {
// 设置这个值的目的是归还连接时需不需要恢复自动提交模式的值
txObject.setMustRestoreAutoCommit(true);
if (logger.isDebugEnabled()) {
logger.debug("Switching JDBC Connection [" + con + "] to manual commit");
}
con.setAutoCommit(false);
}
// 这里默认不会执行的,其实不太清除这里的作用,如果readOnly设置成true, 已经对连接设置了值
// 为什么要对数据库立即执行下 SET TRANSACTION READ ONLY
prepareTransactionalConnection(con, definition);
// 设置值为true, 代表存在一个真实的事务
txObject.getConnectionHolder().setTransactionActive(true);
int timeout = determineTimeout(definition);
if (timeout != TransactionDefinition.TIMEOUT_DEFAULT) {
txObject.getConnectionHolder().setTimeoutInSeconds(timeout);
}
// 如果是新的connectionHolder,会绑定到当前线程
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);
}
}
最后看第一个分支(外部存在一个真实的事务)
// 外部存在一个真实的事务
if (isExistingTransaction(transaction)) {
return handleExistingTransaction(definition, transaction, debugEnabled);
}
@Override
protected boolean isExistingTransaction(Object transaction) {
DataSourceTransactionObject txObject = (DataSourceTransactionObject) transaction;
// transactionActive的值在doBegin中被设置成true
return (txObject.hasConnectionHolder() && txObject.getConnectionHolder().
isTransactionActive());
}
private TransactionStatus handleExistingTransaction(
TransactionDefinition definition, Object transaction, boolean debugEnabled)
throws TransactionException {
// PROPAGATION_NEVER: 以非事务方式运行,如果外部存在真实事务,则抛出异常
if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NEVER) {
throw new IllegalTransactionStateException(
"Existing transaction found for transaction marked with propagation 'never'");
}
// PROPAGATION_NOT_SUPPORTED:以非事务方式运行,如果外部存在真实事务,则挂起外部事务
if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NOT_SUPPORTED) {
if (debugEnabled) {
logger.debug("Suspending current transaction");
}
// 挂起外部事务,这将清空事务对象的connectionHolder以及线程绑定的各种事务信息
// 相当于回到线程首次调用事务的getTransaction的状态
Object suspendedResources = suspend(transaction);
boolean newSynchronization = (getTransactionSynchronization() == SYNCHRONIZATION_ALWAYS);
// 返回一个DefaultTransactionStatus, 此方法已经说过
// 注意的是第三个参数为false
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;
}
}
// PROPAGATION_NESTED:外部不存在真实事务,创建一个新的真实事务,外部存在真实事务,则是嵌套事务
// 使用JDBC的保存点实现
if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NESTED) {
// 不允许嵌套事务,则抛出异常
// 这个值在事务管理器构造函数就初始化为true了
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 {
// Nested transaction through nested begin and commit/rollback calls.
// Usually only for JTA: Spring synchronization might get activated here
// in case of a pre-existing JTA transaction.
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);
}
分析完getTransaction这个方法,对Spring开启事务便有一个全貌了。
3.2 回滚(roolback)
public final void rollback(TransactionStatus status) throws TransactionException {
// 检查事务状态,每一个事务只能调用rollback或者commit一次.
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);
// 存在保存点,说明是嵌套事务,回滚到该保存点
// 即外部存在一个真实事务,并且该事务是一个嵌套事务(PROPAGATION_NESTED)
if (status.hasSavepoint()) {
if (status.isDebug()) {
logger.debug("Rolling back transaction to savepoint");
}
status.rollbackToHeldSavepoint();
}
// 是一个新的真实事务,直接回滚,调用conn.rollback()
// 分为两种情况
// 1. 外部存在真实事务
// 该事务可能的传播行为: PROPAGATION_REQUIRES_NEW
// 2. 外部不存在真实事务
// 该事务可能的传播行为: PROPAGATION_REQUIRES_NEW, PROPAGATION_REQUIRED
// 以及PROPAGATION_NESTED
else if (status.isNewTransaction()) {
if (status.isDebug()) {
logger.debug("Initiating transaction rollback");
}
doRollback(status);
}
// 走到这里说明该事务不是一个新的事务,但是存在一个事务对象,说明该事务参与到外部事务
// 即外部存在一个事务,该事务可能的传播行为为以下两个之一
// PROPAGATION_REQUIRED,PROPAGATION_SUPPORTS
else if (status.hasTransaction()) {
// isGlobalRollbackOnParticipationFailure()默认true
// 如果外部调用过status.setRollbackOnly()
// 那么status.isLocalRollbackOnly()为true
if (status.isLocalRollbackOnly() || isGlobalRollbackOnParticipation
Failure()) {
if (status.isDebug()) {
logger.debug("Participating transaction failed - marking existing transaction as rollback-only");
}
// 这里设置事务对象rollbackOnly为true, 其实是事务对象中的connectionHolder
// 因为内部事务是参与到外部事务,共享一个connectionHolder
// 这个操作会影响到外部事务结果,会使得外部事务即使调用commit也会发生回滚
// 具体commit方法再说.
doSetRollbackOnly(status);
}
else {
if (status.isDebug()) {
logger.debug("Participating transaction failed - letting transaction originator decide on rollback");
}
}
}
// 走到这里说明是以非事务方式运行的(称这种情况为空事务),不需要回滚,什么都不做。
// 分为两种情况
// 1. 外部存在事务
// 此空事务的传播行为:PROPAGATION_NOT_SUPPORTED
// 2. 外部不存在事务
// 此空事务可能的传播行为:PROPAGATION_NOT_SUPPORTED,PROPAGATION_SUPPORTS以及
// PROPAGATION_NEVER
else {
logger.debug("Should roll back transaction but cannot - no transaction available");
}
}
catch (RuntimeException ex) {
// 触发TransactionSynchronization接口的afterCompletion回调方法
triggerAfterCompletion(status, TransactionSynchronization.STATUS_UNKNOWN);
throw ex;
}
catch (Error err) {
triggerAfterCompletion(status, TransactionSynchronization.STATUS_UNKNOWN);
throw err;
}
triggerAfterCompletion(status, TransactionSynchronization.STATUS_ROLLED_BACK);
}
finally {
// 事务完成后,清理线程中绑定的事务相关属性以及资源,同时重置连接并释放
cleanupAfterCompletion(status);
}
}
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());
}
}
分析rollback的逻辑,我们可以看到rollback的逻辑分支是与getTransaction方法对应的。
3.3 提交(commit)
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;
// 在提交前,调用者使用status.setRollbackOnly()方法,事务只能是回滚一种结果
if (defStatus.isLocalRollbackOnly()) {
if (defStatus.isDebug()) {
logger.debug("Transactional code has requested rollback");
}
processRollback(defStatus);
return;
}
// shouldCommitOnGlobalRollbackOnly()默认返回false
// defStatus.isGlobalRollbackOnly()定义如下
// public boolean isGlobalRollbackOnly() {
// return ((this.transaction instanceof SmartTransactionObject) &&
// ((SmartTransactionObject) this.transaction).isRollbackOnly());
// }
// 注: 下文所说的回滚只是调用Spring事务的rollback API, 只有最外层事务才会发生真正的回滚.
// 事务本身是不会修改事务对象的rollbackOnly的,还记得rollback方法里的调用的doSetRollbackOnly方 // 法吗? 当参与的内部事务发生了回滚,会修改事务对象rollbackOnly属性,因为参与的内部事务与外部事物
// 的事务对象共享同一个connectionHolder。这样即使外部事物仍然显示调用commit方法也会进行回滚。
// 同时最外层事务会抛出一个UnexpectedRollbackException
// 抛出异常是因为内部参与事务是回滚的,而内部事务与外部事务其实是同一个真实的事务,本应该也是调用 // rollback方法进行回滚,但是却调用了commit,所以抛出一个异常警告。
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 {
// 一个标记,以防triggerBeforeCommit抛出异常
boolean beforeCompletionInvoked = false;
try {
prepareForCommit(status);
// 触发TransactionSynchronization接口的beforeCommit方法
triggerBeforeCommit(status);
// 触发TransactionSynchronization接口的beforeCompletion方法
triggerBeforeCompletion(status);
// 标记为true
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);
}
// 与上面对应,如果有一个全局rollbackOnly标志,如果上面的操作没有回滚,而是执行
// processCommit提交了,也抛出一个UnexpectedRollbackException。
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) {
// 走到这里是在执行triggerBeforeCompletion前发生了异常,重新触发
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 {
// 触发TransactionSynchronization接口的afterCommit方法
triggerAfterCommit(status);
}
finally {
// 触发TransactionSynchronization接口的afterCompeltion方法
triggerAfterCompletion(status, TransactionSynchronization.STATUS_COMMITTED);
}
}
finally {
// 清理操作,同rollback.
cleanupAfterCompletion(status);
}
}
4. 总结
本文比较细致的介绍了DataSourceTransactionManager的原理,可以看到整个实现采用的是模板方法模式。整个骨架已经在AbstractPlatformTransactionManager定义好了,子类只需要实现特定的以do开头的模板方法即可。本文没有对TransactionSynchronizationManager这个工具类做非常细的介绍,后面会再写一片文章来介绍这一个类以及DataSourceUtils这个比较重要的类。