cn.ponfee.disjob.common.spring

类 TransactionUtils

java.lang.Object

cn.ponfee.disjob.common.spring.TransactionUtils

public class TransactionUtils
extends Object

Spring transaction utility.

作者:

Ponfee

构造器概要

构造器

构造器和说明
TransactionUtils()

方法概要

限定符和类型	方法和说明
static void	assertHasAffectedRow(int totalAffectedRow, String errorMsg)
static void	assertHasAffectedRow(int totalAffectedRow, Supplier<String> errorMsgSupplier)
static void	assertNotAffectedRow(int totalAffectedRow, String errorMsg)
static void	assertNotAffectedRow(int totalAffectedRow, Supplier<String> errorMsgSupplier)
static void	assertOneAffectedRow(int totalAffectedRow, String errorMsg)
static void	assertOneAffectedRow(int totalAffectedRow, Supplier<String> errorMsgSupplier)
static void	assertWithinTransaction()
static void	assertWithoutTransaction()
static void	doAfterTransactionCommit(Collection<Runnable> actions)
static void	doAfterTransactionCommit(Runnable action) 在事务提交成功后再执行`action`，注意： 1）在单层事务中，`doAfterTransactionCommit`添加了一些`action`，后面的代码因异常回滚了这个事务，因事务没有提交(已回滚)，这些`action`不会执行 2）在嵌套事务中，`doAfterTransactionCommit`添加了一些`action`，后面在嵌套事务内因异常回滚了嵌套事务，外层的事务提交成功后，这些`action`仍会执行 3）在嵌套事务中，`doAfterTransactionCommit`添加了一些`action`，后面在外层事务内因异常回滚了整个事务(嵌套和外层都会回滚)，这些`action`不会执行
static <R> R	doInNestedTransaction(org.springframework.transaction.support.TransactionTemplate transactionTemplate, Throwables.ThrowingSupplier<R,Throwable> action, Consumer<Throwable> errorHandler) 如果当前存在事务则开启一个嵌套事务，如果当前不存在事务则新建一个事务并运行。
static <R> R	doInRequiresNewTransaction(org.springframework.transaction.PlatformTransactionManager txManager, Throwables.ThrowingSupplier<R,Throwable> action, Consumer<Throwable> errorHandler) 创建一个新事务，如果当前存在事务，则将这个事务挂起。
static boolean	hasAffectedRow(int totalAffectedRow)
static boolean	isCurrentDoAfterCommit()
static boolean	isNotAffectedRow(int totalAffectedRow)
static boolean	isOneAffectedRow(int totalAffectedRow)
static boolean	isWithinTransaction()
static boolean	isWithoutTransaction()

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

TransactionUtils

public TransactionUtils()

方法详细资料

isNotAffectedRow

public static boolean isNotAffectedRow(int totalAffectedRow)

isOneAffectedRow

public static boolean isOneAffectedRow(int totalAffectedRow)

hasAffectedRow

public static boolean hasAffectedRow(int totalAffectedRow)

assertNotAffectedRow

public static void assertNotAffectedRow(int totalAffectedRow,
                                        Supplier<String> errorMsgSupplier)

assertNotAffectedRow

public static void assertNotAffectedRow(int totalAffectedRow,
                                        String errorMsg)

assertOneAffectedRow

public static void assertOneAffectedRow(int totalAffectedRow,
                                        Supplier<String> errorMsgSupplier)

assertOneAffectedRow

public static void assertOneAffectedRow(int totalAffectedRow,
                                        String errorMsg)

assertHasAffectedRow

public static void assertHasAffectedRow(int totalAffectedRow,
                                        Supplier<String> errorMsgSupplier)

assertHasAffectedRow

public static void assertHasAffectedRow(int totalAffectedRow,
                                        String errorMsg)

doAfterTransactionCommit

public static void doAfterTransactionCommit(Collection<Runnable> actions)

doAfterTransactionCommit

public static void doAfterTransactionCommit(Runnable action)

 在事务提交成功后再执行`action`，注意：
   1）在单层事务中，`doAfterTransactionCommit`添加了一些`action`，后面的代码因异常回滚了这个事务，因事务没有提交(已回滚)，这些`action`不会执行
   2）在嵌套事务中，`doAfterTransactionCommit`添加了一些`action`，后面在嵌套事务内因异常回滚了嵌套事务，外层的事务提交成功后，这些`action`仍会执行
   3）在嵌套事务中，`doAfterTransactionCommit`添加了一些`action`，后面在外层事务内因异常回滚了整个事务(嵌套和外层都会回滚)，这些`action`不会执行
 

参数:

action - the action code

isCurrentDoAfterCommit

public static boolean isCurrentDoAfterCommit()

isWithinTransaction

public static boolean isWithinTransaction()

isWithoutTransaction

public static boolean isWithoutTransaction()

assertWithinTransaction

public static void assertWithinTransaction()

assertWithoutTransaction

public static void assertWithoutTransaction()

doInRequiresNewTransaction

public static <R> R doInRequiresNewTransaction(org.springframework.transaction.PlatformTransactionManager txManager,
                                               Throwables.ThrowingSupplier<R,Throwable> action,
                                               Consumer<Throwable> errorHandler)

创建一个新事务，如果当前存在事务，则将这个事务挂起。

内部事务与外部事务相互独立，互不依赖，互不影响。

参数:

txManager - the txManager

action - the action

errorHandler - the error handler

返回:

run action result, return null if transaction commit failed

doInNestedTransaction

public static <R> R doInNestedTransaction(org.springframework.transaction.support.TransactionTemplate transactionTemplate,
                                          Throwables.ThrowingSupplier<R,Throwable> action,
                                          Consumer<Throwable> errorHandler)

 如果当前存在事务则开启一个嵌套事务，如果当前不存在事务则新建一个事务并运行。
   1）内部事务为外部事务的一个子事务。
   2）内部事务的提交/回滚不影响外部事务的提交/回滚
   3）内部事务的提交/回滚最终依赖外部事务的提交/回滚。
 

参数:

transactionTemplate - the transaction template

action - the action

errorHandler - the error handler, execute after transaction rollback

返回:

run action result, return null if transaction commit failed