spring 的platformTrasactionoManager API讲解（翻译）

深碍√TFBOYSˉ_ 2022-07-12 19:44 101阅读 0赞

platformTrasactionoManager是Spring 事务的基础的中心接口，应用程序可以直接使用它，但它并不是主要用来作API：典型的，应用程序将使用TransactionTemplate或通过AOP声明式事务划分。

对于实现者，建议使用AbstractPlatformTransactionManager类，它预实现传播行为的定义和负责的事务同步处理，子类必须为特定的底层事务实现模板方法，例如: begin, suspend, resume, commit.

这种策略接口的默认实现JtaTransactionManagerDataSourceTransactionManager，这可以作为其他事务策略的实施指南

<table> 
 <tbody> 
 <tr> 
 <td colspan="2" style="background:rgb(204,204,255)"> Method Summary </td> 
 </tr> 
 <tr> 
 <td style="background:rgb(255,255,255)"> &nbsp;void </td> 
 <td style="background:rgb(255,255,255)"> commit(TransactionStatus&nbsp;status) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;根据它的事务状态提交事务 </td> 
 </tr> 
 <tr> 
 <td style="background:rgb(255,255,255)"> &nbsp;TransactionStatus </td> 
 <td style="background:rgb(255,255,255)"> getTransaction(TransactionDefinition&nbsp;definition) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;返回当前活动事务或创建一个新的,根据指定的传播行为. </td> 
 </tr> 
 <tr> 
 <td style="background:rgb(255,255,255)"> &nbsp;void </td> 
 <td style="background:rgb(255,255,255)"> rollback(TransactionStatus&nbsp;status) &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;执行一个给定的事务回滚 </td> 
 </tr> 
 <tr> 
 <td colspan="2" style="background:rgb(204,204,255)"> Method Detail </td> 
 </tr> 
 </tbody> 
</table>

**getTransaction**

TransactionStatus **getTransaction**(TransactionDefinition definition)

throwsTransactionException

--------------------

**commit**

void **commit**(TransactionStatus status)

throws TransactionException

根据它的事务状态提交事务. 如果事务被rollback-only编程方式,执行回滚。

如果没有一个新的事务,省略提交适当的参与周围的事务. 如果前一个事务已经暂停能够创建一个新的, 恢复以前的事务提交后新的后.

注意,当提交调用完成后,无论如果正常或抛出异常,事务必须充分和清理完成. 不回滚调用应该在这种情况下。

如果这种方法除了TransactionException抛出异常,那么一些before-commit错误导致提交的尝试失败. 例如,一个O / R映射工具可能试图变更刷新到数据库之前提交,与结果DataAccessException导致提交失败. 原始异常将被传递到调用者提交的方法在这种情况下。

**Parameters:**

status \- object returned by the getTransaction method

**Throws:**

UnexpectedRollbackException \-在一个意想不到的回滚事务协调器初始化

HeuristicCompletionException \- in case of atransaction failure caused by a heuristic decision on the side of thetransaction coordinator

TransactionSystemException \- in case ofcommit or system errors (typically caused by fundamental resource failures)

IllegalTransactionStateException \- if the giventransaction is already completed (that is, committed or rolled back)

TransactionException

**See Also:**

TransactionStatus.setRollbackOnly()

--------------------

**rollback**

void **rollback**(TransactionStatus status)

throws TransactionException

执行一个给定的事务回滚.

如果不是一个新的事务,只是将它设置为properparticipation rollback-only周围的事务.如果先前transactionhas被停职能够创建一个新的,恢复previoustransaction回滚新的事务后，**不回滚事务如果commit抛出一个异常,**当commit返回时，事务应该已经完成和被清理, 即使在一个 commitexception. 因此, 当提交失败是回滚将导致出现IllegalTransactionStateException.

**Parameters:**

status \- object returned by the getTransaction method

**Throws:**

TransactionSystemException \- in case of rollback or systemerrors(typically caused by fundamental resource failures)

IllegalTransactionStateException \- if the given transactionis alreadycompleted (that is, committed or rolled back)

TransactionException