上一篇文章主要講解了事務的Advisor是如何註冊進Spring容器的，也講解了Spring是如何將有配置事務的類配置上事務的，也講解了Advisor，pointcut驗證流程；但是還未提到的那個Advisor裡面的advice，想要知道這個我們就先來看一下TransactionInterceptor這個類吧：
TransactionInterceptor這個類繼承自TransactionAspectSupport並且實現了MethodInterceptor介面。所以呼叫該類是從invoke方法開始；接下來我們就看一下：
- 看原始碼(
TransactionInterceptor.java)
@Override
@Nullable
public Object invoke(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 CoroutinesInvocationCallback() {
@Override
@Nullable
public Object proceedWithInvocation() throws Throwable {
return invocation.proceed();
}
@Override
public Object getTarget() {
return invocation.getThis();
}
@Override
public Object[] getArguments() {
return invocation.getArguments();
}
}
);
}
注意invoke方法裡面的invokeWithinTransaction這個方法，我們繼續來追蹤一下
- 看原始碼(
TransactionAspectSupport.java)
@Nullable
protected Object invokeWithinTransaction(Method method, @Nullable Class<?> targetClass,
final InvocationCallback invocation) throws Throwable {
// If the transaction attribute is null, the method is non-transactional.
TransactionAttributeSource tas = getTransactionAttributeSource();
// 獲取對應事務屬性
final TransactionAttribute txAttr = (tas != null ? tas.getTransactionAttribute(method, targetClass) : null);
// 獲取beanFactory中的transactionManager屬性
final TransactionManager tm = determineTransactionManager(txAttr);
if (this.reactiveAdapterRegistry != null && tm instanceof ReactiveTransactionManager) {
Boolean isSuspendingFunction = KotlinDetector.isSuspendingFunction(method);
Boolean hasSuspendingFlowReturnType = isSuspendingFunction &&
COROUTINES_FLOW_CLASS_NAME.equals(new MethodParameter(method, -1).getParameterType().getName());
if (isSuspendingFunction && !(invocation instanceof CoroutinesInvocationCallback)) {
throw new IllegalStateException("Coroutines invocation not supported: " + method);
}
CoroutinesInvocationCallback corInv = (isSuspendingFunction ? (CoroutinesInvocationCallback) invocation : null);
ReactiveTransactionSupport txSupport = this.transactionSupportCache.computeIfAbsent(method, key -> {
Class<?> reactiveType =
(isSuspendingFunction ? (hasSuspendingFlowReturnType ? Flux.class : Mono.class) : method.getReturnType());
ReactiveAdapter adapter = this.reactiveAdapterRegistry.getAdapter(reactiveType);
if (adapter == null) {
throw new IllegalStateException("Cannot apply reactive transaction to non-reactive return type: " +
method.getReturnType());
}
return new ReactiveTransactionSupport(adapter);
}
);
InvocationCallback callback = invocation;
if (corInv != null) {
callback = () -> CoroutinesUtils.invokeSuspendingFunction(method, corInv.getTarget(), corInv.getArguments());
}
Object result = txSupport.invokeWithinTransaction(method, targetClass, callback, txAttr, (ReactiveTransactionManager) tm);
if (corInv != null) {
Publisher<?> pr = (Publisher<?>) result;
return (hasSuspendingFlowReturnType ? KotlinDelegate.asFlow(pr) :
KotlinDelegate.awaitSingleOrNull(pr, corInv.getContinuation()));
}
return result;
}
PlatformTransactionManager ptm = asPlatformTransactionManager(tm);
// 構造方法唯一標識(類.方法，如：service.UserServiceImpl.save)
final String joinpointIdentification = methodIdentification(method, targetClass, txAttr);
// 宣告式事務處理
if (txAttr == null || !(ptm instanceof CallbackPreferringPlatformTransactionManager)) {
// Standard transaction demarcation with getTransaction and commit/rollback calls.
// 建立 TransactionInfo
TransactionInfo txInfo = createTransactionIfNecessary(ptm, txAttr, joinpointIdentification);
Object retVal;
try {
// This is an around advice: Invoke the next interceptor in the chain.
// This will normally result in a target object being invoked.
// 執行原方法
// 繼續呼叫方法攔截器鏈，這裡一般會呼叫目標類方法；如：AccountByXMLServiceImpl.save方法
retVal = invocation.proceedWithInvocation();
}
catch (Throwable ex) {
// target invocation exception
// 異常回滾
completeTransactionAfterThrowing(txInfo, ex);
// 手動向上丟擲異常，則下面的提交事務不會執行
// 如果自事務出現異常，則外層事務程式碼需catch住子事務的程式碼，不然外層事務也會回滾
throw ex;
}
finally {
// 消除資訊
cleanupTransactionInfo(txInfo);
}
if (retVal != null && vavrPresent && VavrDelegate.isVavrTry(retVal)) {
// Set rollback-only in case of Vavr failure matching our rollback rules...
TransactionStatus status = txInfo.getTransactionStatus();
if (status != null && txAttr != null) {
retVal = VavrDelegate.evaluateTryFailure(retVal, txAttr, status);
}
}
// 提交事務
commitTransactionAfterReturning(txInfo);
return retVal;
} else {
Object result;
final ThrowableHolder throwableHolder = new ThrowableHolder();
// It's a CallbackPreferringPlatformTransactionManager: pass a TransactionCallback in.
try {
// 程式設計式事務處理
result = ((CallbackPreferringPlatformTransactionManager) ptm).execute(txAttr, status -> {
TransactionInfo txInfo = prepareTransactionInfo(ptm, txAttr, joinpointIdentification, status);
try {
Object retVal = invocation.proceedWithInvocation();
if (retVal != null && vavrPresent && VavrDelegate.isVavrTry(retVal)) {
// Set rollback-only in case of Vavr failure matching our rollback rules...
retVal = VavrDelegate.evaluateTryFailure(retVal, txAttr, status);
}
return retVal;
}
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);
}
}
);
}
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;
}
// Check result state: It might indicate a Throwable to rethrow.
if (throwableHolder.throwable != null) {
throw throwableHolder.throwable;
}
return result;
}
}
建立事務Info物件(TransactionInfo)
然後我們繼續分析上面程式碼中的建立事務Info的函式，也就是:TransactionInfo txInfo = createTransactionIfNecessary(ptm, txAttr, joinpointIdentification);
- 看原始碼(
TransactionAspectSupport.java)
protected TransactionInfo createTransactionIfNecessary(@Nullable PlatformTransactionManager tm,
@Nullable TransactionAttribute txAttr, final String joinpointIdentification) {
// If no name specified, apply method identification as transaction name.
// 如果沒有指定名稱，則使用方法唯一標識，並使用 DelegatingTransactionAttribute 封裝 txAttr
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) {
// 獲取Transaction
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這個函式，主要做了以下幾個事情：
-
使用DelegatingTransactionAttribute封裝傳入TransactionAttribute例項
對於TransactionAttribute型別的引數txAttr，當前的實際型別是
RuleBasedTransactionAttribute，是由獲取事務屬性時生成，主要用於資料承載，而這裡之所以使用DelegatingTransactionAttribute進行封裝，當然是提供了更多功能。 -
獲取事務
事務處理當然是以事務為核心，那麼獲取事務就是最重要的事
-
構建事務資訊
根據之前幾個步驟獲取的資訊構建TransactionInfo並返回
獲取事務
其主要核心就是在createTransactionIfNecessary函式中的getTransaction方法中：
- 看原始碼(
AbstractPlatformTransactionManager.java)
@Override
public final TransactionStatus getTransaction(@Nullable TransactionDefinition definition)
throws TransactionException {
// Use defaults if no transaction definition given.
TransactionDefinition def = (definition != null ? definition : TransactionDefinition.withDefaults());
// 獲取一個transaction
Object transaction = doGetTransaction();
Boolean debugEnabled = logger.isDebugEnabled();
// 如果在這之前已經存在事務，就進入存在事務的方法中
if (isExistingTransaction(transaction)) {
// Existing transaction found -> check propagation behavior to find out how to behave.
return handleExistingTransaction(def, transaction, debugEnabled);
}
// 事務超時驗證
// Check definition settings for new transaction.
if (def.getTimeout() < TransactionDefinition.TIMEOUT_DEFAULT) {
throw new InvalidTimeoutException("Invalid transaction timeout", def.getTimeout());
}
// 走到這裡說明此時沒有存在事務，如果事務的傳播特性是 MANDATORY 則丟擲異常
// No existing transaction found -> check propagation behavior to find out how to proceed.
if (def.getPropagationBehavior() == TransactionDefinition.PROPAGATION_MANDATORY) {
throw new IllegalTransactionStateException(
"No existing transaction found for transaction marked with propagation 'mandatory'");
}
// 如果此時不存在事務，當傳播特性是 REQUIRED REQUIRES_NEW NESTED 都會進入if語句塊 else if (def.getPropagationBehavior() == TransactionDefinition.PROPAGATION_REQUIRED ||
def.getPropagationBehavior() == TransactionDefinition.PROPAGATION_REQUIRES_NEW ||
def.getPropagationBehavior() == TransactionDefinition.PROPAGATION_NESTED) {
// PROPAGATION_REQUIRED PROPAGATION_REQUIRES_NEW PROPAGATION_NESTED 都需要新建事務，、
// 因為此時不存在事務，將null 掛起
SuspendedResourcesHolder suspendedResources = suspend(null);
if (debugEnabled) {
logger.debug("Creating new transaction with name [" + def.getName() + "]: " + def);
}
try {
// 注意這個方法
// new 一個status，存放剛剛建立的transaction，然後將其標記為新事務
// 新開一個連線的地方，非常重要
return startTransaction(def, transaction, debugEnabled, suspendedResources);
}
catch (RuntimeException | Error ex) {
resume(null, suspendedResources);
throw ex;
}
} else {
// Create "empty" transaction: no actual transaction, but potentially synchronization.
if (def.getIsolationLevel() != TransactionDefinition.ISOLATION_DEFAULT && logger.isWarnEnabled()) {
logger.warn("Custom isolation level specified but no actual transaction initiated; " +
"isolation level will effectively be ignored: " + def);
}
// 其它的事務傳播特性一律返回一個空事務，transaction=null
// 當前不存在事務，且傳播機制=PROPAGATION_SUPPORTS/PROPAGATION_NOT_SUPPORTED/PROPAGATION_NEVER，這三種情況，建立“空”事務
Boolean newSynchronization = (getTransactionSynchronization() == SYNCHRONIZATION_ALWAYS);
return prepareTransactionStatus(def, null, true, newSynchronization, debugEnabled, null);
}
}
簡單說一下上面函式中的startTransaction方法：
private TransactionStatus startTransaction(TransactionDefinition definition, Object transaction,
Boolean debugEnabled, @Nullable SuspendedResourcesHolder suspendedResources) {
Boolean newSynchronization = (getTransactionSynchronization() != SYNCHRONIZATION_NEVER);
// new 一個status，存放剛剛建立的transaction，然後將其標記為新事務
// 這裡的 transaction 後面的一個引數決定是否是新事務
DefaultTransactionStatus status = newTransactionStatus(
definition, transaction, true, newSynchronization, debugEnabled, suspendedResources);
// 新開一個連線的地方，非常重要
doBegin(transaction, definition);
prepareSynchronization(status, definition);
return status;
}
接下來繼續檢視getTransaction這個函式，看看是如何將transaction建立出來的；看方法doGetTransaction：(這裡這裡看的是實現類DataSourceTransactionManager的)
- 看原始碼(
DataSourceTransactionManager.java)
@Override
protected Object doGetTransaction() {
// 這裡的 DataSourceTransactionObject 是一個事務管理器的一個內部類
// DataSourceTransactionObject 就是一個transaction 這裡直接new 了一個
DataSourceTransactionObject txObject = new DataSourceTransactionObject();
txObject.setSavepointAllowed(isNestedTransactionAllowed());
// 解綁與繫結的作用在此時體現，如果當前執行緒有繫結的話，將會取出holder
// 第一次 conHolder 指定是null
ConnectionHolder conHolder =
(ConnectionHolder) TransactionSynchronizationManager.getResource(obtainDataSource());
// 此時的 holder被標記成一箇舊holder
txObject.setConnectionHolder(conHolder, false);
return txObject;
}
- 原始碼解析
看到上面的原始碼後我們不難發現其實建立事務的過程其實很簡單，接下來我們繼續分析建立完事務它又做了什麼？回到getTransaction這個方法，發現它接著就會判斷當前是否存在事務(也就是isExistingTransaction(transaction))：
- 看原始碼(
DataSourceTransactionManager.java)
@Override
protected Boolean isExistingTransaction(Object transaction) {
DataSourceTransactionObject txObject = (DataSourceTransactionObject) transaction;
return (txObject.hasConnectionHolder() && txObject.getConnectionHolder().isTransactionActive());
}
接著看一下這個函式中的hasConnectionHolder方法
public boolean hasConnectionHolder() {
return (this.connectionHolder != null);
}
- 原始碼解析
這裡判斷是否存在事務的依據主要是獲取holder中的transactionActive變數是否為true，holder直接為null判斷不存在了，如果是第二此進入事務transactionActive變數是為true的（後面會提到在哪裡把它變為true的），由此來判斷當前是否已經存在事務了。
到這裡原始碼分成了2條處理線
- 當前已經存在事務isExistingTransaction()判斷是否存在事務，存在事務handlerExistingTransaction()根據不同傳播機制不同處理；
- 當前不存在事務：不同傳播機制不同處理
當前不存在事務
如果當前不存在事務，傳播特性又是REQUIRED 、 REQUIRES_NEW 、 NESTED，將會先掛起null，這個掛起方法後面再說；然後建立一個DefaultTransactionStatus，並將其標記為新事務，然後執行doBegin(transaction, definition);這個方法也是一個比較關鍵的方法；
這裡我們提到了DefaultTransactionStatus 一個status物件，這是一個十分重要的物件我們記下來來簡單看一下TransactionStatus介面
- 看原始碼(
TransactionStatus.java)
public interface TransactionStatus extends TransactionExecution, SavepointManager, Flushable {
/**
* 返回該事務是否在內部攜帶儲存點，也就是說，已經建立為基於儲存點的巢狀事務。
* @return
*/
Boolean hasSavepoint();
/**
* 將會話重新整理到資料儲存區
*/
@Override
void flush();
}
我們再來看一下TransactionStatus層次結構發現這個類繼承了TransactionExecution介面，進去檢視一下
- 看原始碼(
TransactionExecution.java)
package org.springframework.transaction;
public interface TransactionExecution {
/**
* 返回當前事務是否為新事務（否則將參與到現有事務中，或者可能一開始就不在實際事務中執行）
* @return
*/
Boolean isNewTransaction();
/**
* 設定事務僅回滾。
*/
void setRollbackOnly();
/**
* 返回事務是否已標記為僅回滾
* @return
*/
Boolean isRollbackOnly();
/**
* 返回事物是否已經完成，無論提交或者回滾。
* @return
*/
Boolean isCompleted();
}
接下來我們再檢視一下實現類DefaultTransactionStatus
- 看原始碼(
DefaultTransactionStatus.java)
package org.springframework.transaction.support;
import org.springframework.lang.Nullable;
import org.springframework.transaction.NestedTransactionNotSupportedException;
import org.springframework.transaction.SavepointManager;
import org.springframework.util.Assert;
public class DefaultTransactionStatus extends AbstractTransactionStatus {
// 事務物件
@Nullable
private final Object transaction;
// 事務物件
private final Boolean newTransaction;
private final Boolean newSynchronization;
private final Boolean readOnly;
private final Boolean debug;
// 事務物件
@Nullable
private final Object suspendedResources;
public DefaultTransactionStatus(
@Nullable Object transaction, Boolean newTransaction, Boolean newSynchronization,
Boolean readOnly, Boolean debug, @Nullable Object suspendedResources) {
this.transaction = transaction;
this.newTransaction = newTransaction;
this.newSynchronization = newSynchronization;
this.readOnly = readOnly;
this.debug = debug;
this.suspendedResources = suspendedResources;
}
/**
* Return the underlying transaction object.
* @throws IllegalStateException if no transaction is active
*/
public Object getTransaction() {
Assert.state(this.transaction != null, "No transaction active");
return this.transaction;
}
/**
* Return whether there is an actual transaction active.
*/
public Boolean hasTransaction() {
return (this.transaction != null);
}
@Override
public Boolean isNewTransaction() {
return (hasTransaction() && this.newTransaction);
}
/**
* Return if a new transaction synchronization has been opened
* for this transaction.
*/
public Boolean isNewSynchronization() {
return this.newSynchronization;
}
/**
* Return if this transaction is defined as read-only transaction.
*/
public Boolean isReadOnly() {
return this.readOnly;
}
/**
* Return whether the progress of this transaction is debugged. This is used by
* {@link AbstractPlatformTransactionManager} as an optimization, to prevent repeated
* calls to {@code logger.isDebugEnabled()}. Not really intended for client code.
*/
public Boolean isDebug() {
return this.debug;
}
/**
* Return the holder for resources that have been suspended for this transaction,
* if any.
*/
@Nullable
public Object getSuspendedResources() {
return this.suspendedResources;
}
@Override
public Boolean isGlobalRollbackOnly() {
return ((this.transaction instanceof SmartTransactionObject) &&
((SmartTransactionObject) this.transaction).isRollbackOnly());
}
@Override
protected SavepointManager getSavepointManager() {
Object transaction = this.transaction;
if (!(transaction instanceof SavepointManager)) {
throw new NestedTransactionNotSupportedException(
"Transaction object [" + this.transaction + "] does not support savepoints");
}
return (SavepointManager) transaction;
}
public Boolean isTransactionSavepointManager() {
return (this.transaction instanceof SavepointManager);
}
@Override
public void flush() {
if (this.transaction instanceof SmartTransactionObject) {
((SmartTransactionObject) this.transaction).flush();
}
}
}
看完這裡我們接下來繼續回到AbstractPlatformTransactionManager中的getTransaction函式裡面的
startTransaction函式。這裡有這裡有這麼一句話。
DefaultTransactionStatus status = newTransactionStatus(
definition, transaction, true, newSynchronization, debugEnabled, suspendedResources);
我們來檢視一下newTransactionStatus函式：
- 看原始碼(
AbstractPlatformTransactionManager.java)
// 這裡是構造一個status物件的方法
protected DefaultTransactionStatus newTransactionStatus(
TransactionDefinition definition, @Nullable Object transaction, Boolean newTransaction,
Boolean newSynchronization, Boolean debug, @Nullable Object suspendedResources) {
Boolean actualNewSynchronization = newSynchronization &&
!TransactionSynchronizationManager.isSynchronizationActive();
return new DefaultTransactionStatus(
transaction, newTransaction, actualNewSynchronization,
definition.isReadOnly(), debug, suspendedResources);
}
- 原始碼解析
實際上就是封裝了事務屬性definition新建的transaction，並且將事務狀態屬性設定為新事物，最後一個引數為被掛起的事務。
簡單瞭解一下關鍵引數：
第二個引數transaction：事務物件，在一開頭就有建立，其就是事務管理器的一個內部類
第三個引數newTransaction：布林值，一個標識，用於判斷是否是新的事務，用於提交或者回滾方法用。是新的才會提交或者回滾
最後一個引數suspendedResources：被掛起的物件資源，掛起操作會返回舊的holder，將其與一些事務屬性一起封裝成一個物件，就是這個suspendedResources物件了，它會放再status中，在最後的清理工作方法中判斷status中是否有這個掛起物件，如果有會恢復它
接下來我們再回到startTransaction方法中的doBegin(transaction, definition);具體實現還是看DataSourceTransactionManager。
- 看原始碼(
DataSourceTransactionManager.java)
@Override
protected void doBegin(Object transaction, TransactionDefinition definition) {
DataSourceTransactionObject txObject = (DataSourceTransactionObject) transaction;
Connection con = null;
try {
// 判斷如果transaction 沒有holder的話，才去dataSource中獲取一個新的連線
if (!txObject.hasConnectionHolder() ||
txObject.getConnectionHolder().isSynchronizedWithTransaction()) {
// 通過 dataSource獲取
Connection newCon = obtainDataSource().getConnection();
if (logger.isDebugEnabled()) {
logger.debug("Acquired Connection [" + newCon + "] for JDBC transaction");
}
// 所以只有transaction的holder為空時，才會設定新的holder
// 將獲取的連線封裝進 ConnectionHolder 然後封裝進 transaction 的 connectionholder 屬性
txObject.setConnectionHolder(new ConnectionHolder(newCon), true);
}
// 設定新的連線為事務同步中
txObject.getConnectionHolder().setSynchronizedWithTransaction(true);
// con設定事務隔離級別為 只讀
con = txObject.getConnectionHolder().getConnection();
Integer previousIsolationLevel = DataSourceUtils.prepareConnectionForTransaction(con, definition);
// /DataSourceTransactionObject設定事務隔離級別
txObject.setPreviousIsolationLevel(previousIsolationLevel);
txObject.setReadOnly(definition.isReadOnly());
// Switch to manual commit if necessary. This is very expensive in some JDBC drivers,
// so we don't want to do it unnecessarily (for example if we've explicitly
// configured the connection pool to set it already).
// 如果是自動提交切換到手動提交
if (con.getAutoCommit()) {
txObject.setMustRestoreAutoCommit(true);
if (logger.isDebugEnabled()) {
logger.debug("Switching JDBC Connection [" + con + "] to manual commit");
}
con.setAutoCommit(false);
}
// 如果只讀，執行sql設定事務只讀
prepareTransactionalConnection(con, definition);
//設定connection 持有者的事務開啟狀態
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(obtainDataSource(), txObject.getConnectionHolder());
}
}
catch (Throwable ex) {
if (txObject.isNewConnectionHolder()) {
DataSourceUtils.releaseConnection(con, obtainDataSource());
txObject.setConnectionHolder(null, false);
}
throw new CannotCreateTransactionException("Could not open JDBC Connection for transaction", ex);
}
}
接下來我們看一下doBegin方法中的con設定事務隔離級別的方法(Integer previousIsolationLevel = DataSourceUtils.prepareConnectionForTransaction(con, definition)?
- 看原始碼(
DataSourceUtils.java)
@Nullable
public static Integer prepareConnectionForTransaction(Connection con, @Nullable TransactionDefinition definition)
throws SQLException {
Assert.notNull(con, "No Connection specified");
Boolean debugEnabled = logger.isDebugEnabled();
// Set read-only flag.
// 設定資料連線的只讀標識
if (definition != null && definition.isReadOnly()) {
try {
if (debugEnabled) {
logger.debug("Setting JDBC Connection [" + con + "] read-only");
}
con.setReadOnly(true);
}
catch (SQLException | RuntimeException ex) {
Throwable exToCheck = ex;
while (exToCheck != null) {
if (exToCheck.getClass().getSimpleName().contains("Timeout")) {
// Assume it's a connection timeout that would otherwise get lost: e.g. from JDBC 4.0
throw ex;
}
exToCheck = exToCheck.getCause();
}
// "read-only not supported" SQLException -> ignore, it's just a hint anyway
logger.debug("Could not set JDBC Connection read-only", ex);
}
}
// Apply specific isolation level, if any.
// 設定資料庫連線的隔離級別
Integer previousIsolationLevel = null;
if (definition != null && definition.getIsolationLevel() != TransactionDefinition.ISOLATION_DEFAULT) {
if (debugEnabled) {
logger.debug("Changing isolation level of JDBC Connection [" + con + "] to " +
definition.getIsolationLevel());
}
int currentIsolation = con.getTransactionIsolation();
if (currentIsolation != definition.getIsolationLevel()) {
previousIsolationLevel = currentIsolation;
con.setTransactionIsolation(definition.getIsolationLevel());
}
}
return previousIsolationLevel;
}
從上面我們可以看到都是通過Connection去設定的。
接下來我們再回到doBegin方法看這一行
TransactionSynchronizationManager.bindResource(obtainDataSource(), txObject.getConnectionHolder());
這行程式碼是將當前獲取到的連線繫結到當前執行緒，繫結解綁圍繞一個執行緒變數，這個變數就在TransactionSynchronizationManager中，如下：
private static final ThreadLocal<Map<Object, Object>> resources =
new NamedThreadLocal<>("Transactional resources");
這是一個static final修飾的執行緒變數，儲存的是一個Map，我們再看一下doBegin的靜態方法，也就是上面提到的：bindResource方法：
- 看原始碼(
TransactionSynchronizationManager.java)
public static void bindResource(Object key, Object value) throws IllegalStateException {
// 從上面可以知道，執行緒變數是一個 map ，而這個key就是dataSource，這個value 就是 holder
Object actualKey = TransactionSynchronizationUtils.unwrapResourceIfNecessary(key);
Assert.notNull(value, "Value must not be null");
// 獲取這個執行緒變數的 map
Map<Object, Object> map = resources.get();
// set ThreadLocal Map if none found
if (map == null) {
map = new HashMap<>();
resources.set(map);
}
// 將新的 holder 作為 value ，dataSource作為 key 放入到當前執行緒 map 中
Object oldValue = map.put(actualKey, value);
// Transparently suppress a ResourceHolder that was marked as void...
if (oldValue instanceof ResourceHolder && ((ResourceHolder) oldValue).isVoid()) {
oldValue = null;
}
if (oldValue != null) {
throw new IllegalStateException(
"Already value [" + oldValue + "] for key [" + actualKey + "] bound to thread");
}
}
擴充知識點
這裡提一下，mybatis中獲取的資料庫連線，就是dataSource從ThreadLocal中獲取的，以查詢舉例，會呼叫Executor#doQuery方法
最終會呼叫DataSourceUtils#doGetConnection方法獲取，真正的資料庫連線，其中的TransactionSynchronization中儲存的就是方法呼叫前，spring增強方法中繫結到執行緒的connection，從而保證整個事務過程中connection的一致性
我們繼續來看看TransactionSynchronizationManager的getResource(Object key)這個方法
- 看原始碼(
TransactionSynchronizationManager.java)
@Nullable
public static Object getResource(Object key) {
Object actualKey = TransactionSynchronizationUtils.unwrapResourceIfNecessary(key);
return doGetResource(actualKey);
}
繼續追蹤一下里面的doGetResource方法
- 看原始碼(
TransactionSynchronizationManager.java)
@Nullable
private static Object doGetResource(Object actualKey) {
Map<Object, Object> map = resources.get();
if (map == null) {
return null;
}
Object value = map.get(actualKey);
// Transparently remove ResourceHolder that was marked as void...
if (value instanceof ResourceHolder && ((ResourceHolder) value).isVoid()) {
map.remove(actualKey);
// Remove entire ThreadLocal if empty...
if (map.isEmpty()) {
resources.remove();
}
value = null;
}
return value;
}
到這裡我們就知道了getResource這個方法就說明了就是從執行緒變數的Map中根據DataSource獲取的ConnectionHolder
已經存在的事務
前面我們提到過，第一次事務開始時必會新建立一個holder然後做繫結操作，此時執行緒變數是有holder的且active為true，如果第二個事務進來，去new一個transaction之後去執行緒變數中去holder，holder是不為空的且active是為true的；所以會進入handleExistingTransaction方法；回到AbstractPlatformTransactionManager的getTransaction函式：檢視handleExistingTransaction方法：
- 看原始碼(
AbstractPlatformTransactionManager.java)
private TransactionStatus handleExistingTransaction(
TransactionDefinition definition, Object transaction, Boolean debugEnabled)
throws TransactionException {
// 1. 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");
}
// 這裡會將原來的事務掛起，並返回被掛起的物件。
Object suspendedResources = suspend(transaction);
Boolean newSynchronization = (getTransactionSynchronization() == SYNCHRONIZATION_ALWAYS);
// 這裡可以看到，第二個引數transaction傳了一個空事務，第三個引數false為舊標記
// 最後一個引數就是將前面的掛起的物件封裝進了一個新的Status中，當前事務執行完成後，就恢復suspendedResources
return prepareTransactionStatus(
definition, null, false, newSynchronization, debugEnabled, suspendedResources);
}
// 掛起當前事務，建立新事務
if (definition.getPropagationBehavior() == TransactionDefinition.PROPAGATION_REQUIRES_NEW) {
if (debugEnabled) {
logger.debug("Suspending current transaction, creating new transaction with name [" +
definition.getName() + "]");
}
// 將原事務掛起，此時新建事務，不與原事務有關係。
// 會將transaction 中的holder 設定為 null ，然後解綁
SuspendedResourcesHolder suspendedResources = suspend(transaction);
try {
// 注意這個函式。
// new一個status出來，傳入transaction，並且為新事務標記，然後傳入掛起事務
// 這裡也做了一次doBegin，此時的transaction中holer是為空的，因為之前的事務被掛起了
// 所以這裡會取一次新的連線，並且繫結！
return startTransaction(definition, transaction, debugEnabled, suspendedResources);
}
catch (RuntimeException | Error beginEx) {
resumeAfterBeginException(transaction, suspendedResources, beginEx);
throw beginEx;
}
}
// 如果此時的傳播特性是 PROPAGATION_NESTED，不會掛起事務
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() + "]");
}
// 這裡如果是JTA事務管理器，就不可以用savePoint了，將不會進入此方法
if (useSavepointForNestedTransaction()) {
// Create savepoint within existing Spring-managed transaction,
// through the SavepointManager API implemented by TransactionStatus.
// Usually uses JDBC 3.0 savepoints. Never activates Spring synchronization.
// 這裡不會掛起事務，說明NESTED的特性是原事務的子事務而已
// new一個status，傳入transaction，傳入舊事務標記，傳入掛起物件=null
DefaultTransactionStatus status =
prepareTransactionStatus(definition, transaction, false, false, debugEnabled, null);
// 這裡是NESTED特性特殊的地方，在先前存在事務的情況下會建立一個savePoint
status.createAndHoldSavepoint();
return status;
} else {
// JTA事務走這個分支，建立新事務
// 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.
// JTA事務走這個分支，建立新事務
return startTransaction(definition, transaction, debugEnabled, null);
}
}
// 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");
}
}
}
// 到這裡PROPAGATION_SUPPORTS 或 PROPAGATION_REQUIRED或PROPAGATION_MANDATORY，存在事務加入事務即可，標記為舊事務，空掛起
Boolean newSynchronization = (getTransactionSynchronization() != SYNCHRONIZATION_NEVER);
return prepareTransactionStatus(definition, transaction, false, newSynchronization, debugEnabled, null);
}
- 原始碼解析
從上述原始碼中，對於已經存在事務的處理過程中，我們看到很多熟悉的操作，但是也有些不同的地方，函式中對已經存在的事務處理考慮分兩種情況：
-
PROPAGATION_REQUIRES_NEW表示當前方法必須在它自己的事務裡執行，一個新的事務將被啟動，而如果有一個事務正在執行的話，則在這個方法執行期間被掛起。而Spring中對於此種傳播方式的處理和新建事務建立的最大的不同點就是使用suspend方法將原事務掛起。將資訊掛起的目的當然是為了在當前事務執行完畢後再將原事務還原。
-
PROPAGATION_NESTED表示如果當前有一個事務正在執行中，則該方法應該執行在一個巢狀的事務中，被巢狀的事務可以獨立於封裝事務進行提交或者回滾，如果封裝事務不存在，行為就像PROPAGATION_REQUIRES_NEW。對於嵌入式事務的處理，Spring中主要考慮了兩種處理方式：
- Spring中允許嵌入事務的時候，則首選設定儲存點的方式作為異常處理的回滾
- 對於其他方式，比如JTA無法使用儲存點的方式，那麼處理方式PROPAGATION_REQUIRES_NEW相同，而一旦出現異常，則由Spring的事務異常處理機制去完成後續操作
對於掛起操作的主要目的是記錄原有事務的狀態，以便於後續操作對事務的恢復。
總結：
到這裡我們可以知道，在當前存在事務的情況下，根據傳播特性去決定是否為新事務，是否掛起當前事務。
PROPAGATION_NOT_SUPPORTED：會掛起事務，不執行doBegin方法傳空transaction，標記為舊事務。封裝status物件。
return prepareTransactionStatus(
definition, null, false, newSynchronization, debugEnabled, suspendedResources);
PROPAGATION_REQUIRES_NEW：將會掛起事務且執行doBegin方法，標記為新事務。封裝status物件：
// 注意這個函式。
// new一個status出來，傳入transaction，並且為新事務標記，然後傳入掛起事務
// 這裡也做了一次doBegin，此時的transaction中holer是為空的，因為之前的事務被掛起了
// 所以這裡會取一次新的連線，並且繫結！
return startTransaction(definition, transaction, debugEnabled, suspendedResources);
// startTransaction函式
...
DefaultTransactionStatus status = newTransactionStatus(
definition, transaction, true, newSynchronization, debugEnabled, suspendedResources);
...
PROPAGATION_NESTED:不會掛起事務且不會執行doBegin方法，標記為舊事務，但會建立savePoint。封裝status物件：
DefaultTransactionStatus status =
prepareTransactionStatus(definition, transaction, false, false, debugEnabled, null);
其他事務例如：PROPAGATION_REQUIRED：不會掛起事務，封裝原有的transaction不會執行doBegin方法，標記舊事務，封裝status物件：
return prepareTransactionStatus(definition, transaction, false, newSynchronization, debugEnabled, null);
掛起：
對於掛起操作的主要目的是記錄原有事務的狀態，以便後續操作對事務的恢復：
- 看原始碼(
AbstractPlatformTransactionManager.java)
@Nullable
protected final SuspendedResourcesHolder suspend(@Nullable Object transaction) throws TransactionException {
if (TransactionSynchronizationManager.isSynchronizationActive()) {
List<TransactionSynchronization> suspendedSynchronizations = doSuspendSynchronization();
try {
Object suspendedResources = null;
if (transaction != null) {
// 這裡是真正做掛起的方法，這裡返回的是一個holder
suspendedResources = doSuspend(transaction);
}
// 這裡將名稱、隔離級別等資訊從執行緒變數中取出並設定對應屬性為null到執行緒變數
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);
// 將事務各個屬性與掛起的holder一併封裝進SuspendedResourcesHolder物件中
return new SuspendedResourcesHolder(
suspendedResources, suspendedSynchronizations, name, readOnly, isolationLevel, wasActive);
}
catch (RuntimeException | Error ex) {
// doSuspend failed - original transaction is still active...
doResumeSynchronization(suspendedSynchronizations);
throw ex;
}
} 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;
}
}
我們看一下doSuspend方法，在實現類DataSourceTransactionManager中
- 看原始碼(
DataSourceTransactionManager.java)
@Override
protected Object doSuspend(Object transaction) {
DataSourceTransactionObject txObject = (DataSourceTransactionObject) transaction;
// 將transaction中的holder屬性設定為空
txObject.setConnectionHolder(null);
// ConnnectionHolder從執行緒變數中解綁！
return TransactionSynchronizationManager.unbindResource(obtainDataSource());
}
我們緊接著繼續追unbindResource函式裡面的doUnbindResource：
- 看原始碼(
TransactionSynchronizationManager.java)
@Nullable
private static Object doUnbindResource(Object actualKey) {
// 取得當前執行緒的執行緒變數Map
Map<Object, Object> map = resources.get();
if (map == null) {
return null;
}
// 將key為dataSourece的value移除出Map，然後將舊的Holder返回
Object value = map.remove(actualKey);
// Remove entire ThreadLocal if empty...
// 如果此時map為空，直接清除執行緒變數
if (map.isEmpty()) {
resources.remove();
}
// Transparently suppress a ResourceHolder that was marked as void...
if (value instanceof ResourceHolder && ((ResourceHolder) value).isVoid()) {
value = null;
}
// 將舊Holder返回
return value;
}
回顧：
簡單回顧一下解綁的操作。其實主要做了三件事：
- 將transaction中的holder屬性設定為空
- 解綁(會返回執行緒中的那個舊的holder出來，從而封裝到SuspendedResourcesHolder物件中)
- 將SuspendedResourcesHolder放入到status中，方便後期子事務完成後，恢復外層事務。
好了本次文章到這裡就告一段落了，希望對你能有所幫助。
歡迎微信搜尋【碼上遇見你】獲取更多精彩內容