|
对于最新的稳定版本，请使用 Spring Framework 7.0.6! |
回滚声明式事务操作
上一节概述了如何在应用程序中对类（通常是服务层类）以声明方式指定事务设置的基本方法。本节将介绍如何在XML配置中以简单的方式声明式地控制事务的回滚。有关使用<code>0</code>注解以声明方式控制回滚语义的详细信息，请参见
1</code> 设置。
指示Spring框架的事务基础设施在事务的处理过程中需要回滚的推荐方法是，从当前正在事务上下文中执行的代码中抛出一个Exception。Spring框架的事务基础设施代码会在调用堆栈向上冒泡时捕获任何未处理的Exception，并决定是否将事务标记为回滚。
在默认配置下，Spring框架的事务基础设施代码仅在出现运行时非受检异常时将事务标记为回滚。也就是说，当抛出的异常是RuntimeException的实例或子类时（默认情况下，Error实例也会导致回滚）。
自Spring Framework 5.2起，默认配置还支持Vavr的Try方法，当其返回'Failure'时触发事务回滚。这允许您使用Try处理函数式错误，并在发生故障时自动回滚事务。有关Vavr的Try的更多信息，请参阅官方Vavr文档。
以下是一个在事务性方法中使用 Vavr 的 Try 的示例：
-
Java
@Transactional
public Try<String> myTransactionalMethod() {
// If myDataAccessOperation throws an exception, it will be caught by the
// Try instance created with Try.of() and wrapped inside the Failure class
// which can be checked using the isFailure() method on the Try instance.
return Try.of(delegate::myDataAccessOperation);
}在默认配置中，从事务方法抛出的检查型异常不会导致回滚。您可以通过指定回滚规则精确配置哪些Exception类型会标记事务进行回滚，包括检查型异常。
|
回滚规则
回滚规则用于确定当抛出指定异常时事务是否应被回滚，这些规则基于异常类型或异常模式。 回滚规则可以通过 当回滚规则通过异常类型定义时，该类型将用于匹配抛出的异常及其超类型，从而提供类型安全并避免使用模式匹配时可能发生的意外匹配。例如， 当回滚规则通过异常模式定义时，该模式可以是一个完全限定类名，或是异常类型（必须是
|
以下XML片段演示了如何通过使用rollback-for属性提供异常模式来为已检查的、特定于应用程序的Exception类型配置回滚：
<tx:advice id="txAdvice" transaction-manager="txManager">
<tx:attributes>
<tx:method name="get*" read-only="true" rollback-for="NoProductInStockException"/>
<tx:method name="*"/>
</tx:attributes>
</tx:advice>如果您不希望在抛出异常时回滚事务，还可以指定“不回滚”规则。下面的示例告诉Spring框架的事务基础设施，在遇到未处理的InstrumentNotFoundException时也要提交相关事务：
<tx:advice id="txAdvice">
<tx:attributes>
<tx:method name="updateStock" no-rollback-for="InstrumentNotFoundException"/>
<tx:method name="*"/>
</tx:attributes>
</tx:advice>当Spring框架的事务基础设施捕获异常并查阅配置的回滚规则以确定是否将事务标记为回滚时，最强匹配规则将获胜。因此，在以下配置的情况下，除了InstrumentNotFoundException以外的任何异常都会导致相关事务回滚：
<tx:advice id="txAdvice">
<tx:attributes>
<tx:method name="*" rollback-for="Throwable" no-rollback-for="InstrumentNotFoundException"/>
</tx:attributes>
</tx:advice>你也可以通过编程方式指示需要回滚。虽然简单，但此过程较为侵入性，并且会将你的代码与 Spring 框架的事务基础设施紧密耦合。下面的例子展示了如何以编程方式指示需要回滚：
-
Java
-
Kotlin
public void resolvePosition() {
try {
// some business logic...
} catch (NoProductInStockException ex) {
// trigger rollback programmatically
TransactionAspectSupport.currentTransactionStatus().setRollbackOnly();
}
}fun resolvePosition() {
try {
// some business logic...
} catch (ex: NoProductInStockException) {
// trigger rollback programmatically
TransactionAspectSupport.currentTransactionStatus().setRollbackOnly();
}
}你被强烈建议在可能的情况下使用声明式回滚方法。如果确实需要，也可以使用编程式回滚，但它的使用与实现干净的 POJO 基础架构相违背。