类 AbstractTransactionStatus
- java.lang.Object
- org.springframework.transaction.support.AbstractTransactionStatus
public abstract class AbstractTransactionStatus extends Object implements TransactionStatus
Abstract base implementation of theTransactionStatus
interface.Pre-implements the handling of local rollback-only and completed flags, and delegation to an underlying
SavepointManager
. Also offers the option of a holding a savepoint within the transaction.Does not assume any specific internal transaction handling, such as an underlying transaction object, and no transaction synchronization mechanism.
- 从以下版本开始:
- 1.2.3
- 作者:
- Juergen Hoeller
- 另请参阅:
setRollbackOnly()
,isRollbackOnly()
,setCompleted()
,isCompleted()
,getSavepointManager()
,SimpleTransactionStatus
,DefaultTransactionStatus
构造器概要
构造器 构造器 说明 AbstractTransactionStatus()
方法概要
所有方法 实例方法 具体方法 修饰符和类型 方法 说明 void
createAndHoldSavepoint()
Create a savepoint and hold it for the transaction.Object
createSavepoint()
This implementation delegates to a SavepointManager for the underlying transaction, if possible.void
flush()
This implementations is empty, considering flush as a no-op.protected Object
getSavepoint()
Get the savepoint for this transaction, if any.protected SavepointManager
getSavepointManager()
Return a SavepointManager for the underlying transaction, if possible.boolean
hasSavepoint()
Return whether this transaction internally carries a savepoint, that is, has been created as nested transaction based on a savepoint.boolean
isCompleted()
Return whether this transaction is completed, that is, whether it has already been committed or rolled back.boolean
isGlobalRollbackOnly()
Template method for determining the global rollback-only flag of the underlying transaction, if any.boolean
isLocalRollbackOnly()
Determine the rollback-only flag via checking this TransactionStatus.boolean
isRollbackOnly()
Determine the rollback-only flag via checking both the local rollback-only flag of this TransactionStatus and the global rollback-only flag of the underlying transaction, if any.void
releaseHeldSavepoint()
Release the savepoint that is held for the transaction.void
releaseSavepoint(Object savepoint)
This implementation delegates to a SavepointManager for the underlying transaction, if possible.void
rollbackToHeldSavepoint()
Roll back to the savepoint that is held for the transaction and release the savepoint right afterwards.void
rollbackToSavepoint(Object savepoint)
This implementation delegates to a SavepointManager for the underlying transaction, if possible.void
setCompleted()
Mark this transaction as completed, that is, committed or rolled back.void
setRollbackOnly()
Set the transaction rollback-only.protected void
setSavepoint(Object savepoint)
Set a savepoint for this transaction.从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
从接口继承的方法 org.springframework.transaction.TransactionExecution
isNewTransaction
构造器详细资料
AbstractTransactionStatus
public AbstractTransactionStatus()
方法详细资料
setRollbackOnly
public void setRollbackOnly()
从接口复制的说明:TransactionExecution
Set the transaction rollback-only. This instructs the transaction manager that the only possible outcome of the transaction may be a rollback, as alternative to throwing an exception which would in turn trigger a rollback.- 指定者:
setRollbackOnly
在接口中TransactionExecution
isRollbackOnly
public boolean isRollbackOnly()
Determine the rollback-only flag via checking both the local rollback-only flag of this TransactionStatus and the global rollback-only flag of the underlying transaction, if any.
isLocalRollbackOnly
public boolean isLocalRollbackOnly()
Determine the rollback-only flag via checking this TransactionStatus.Will only return "true" if the application called
setRollbackOnly
on this TransactionStatus object.
isGlobalRollbackOnly
public boolean isGlobalRollbackOnly()
Template method for determining the global rollback-only flag of the underlying transaction, if any.This implementation always returns
false
.
setCompleted
public void setCompleted()
Mark this transaction as completed, that is, committed or rolled back.
isCompleted
public boolean isCompleted()
从接口复制的说明:TransactionExecution
Return whether this transaction is completed, that is, whether it has already been committed or rolled back.- 指定者:
isCompleted
在接口中TransactionExecution
hasSavepoint
public boolean hasSavepoint()
从接口复制的说明:TransactionStatus
Return whether this transaction internally carries a savepoint, that is, has been created as nested transaction based on a savepoint.This method is mainly here for diagnostic purposes, alongside
TransactionExecution.isNewTransaction()
. For programmatic handling of custom savepoints, use the operations provided bySavepointManager
.
setSavepoint
protected void setSavepoint(@Nullable Object savepoint)
Set a savepoint for this transaction. Useful for PROPAGATION_NESTED.
getSavepoint
@Nullable protected Object getSavepoint()
Get the savepoint for this transaction, if any.
createAndHoldSavepoint
public void createAndHoldSavepoint() throws TransactionException
Create a savepoint and hold it for the transaction.- 抛出:
NestedTransactionNotSupportedException
- if the underlying transaction does not support savepointsTransactionException
rollbackToHeldSavepoint
public void rollbackToHeldSavepoint() throws TransactionException
Roll back to the savepoint that is held for the transaction and release the savepoint right afterwards.
releaseHeldSavepoint
public void releaseHeldSavepoint() throws TransactionException
Release the savepoint that is held for the transaction.
createSavepoint
public Object createSavepoint() throws TransactionException
This implementation delegates to a SavepointManager for the underlying transaction, if possible.- 指定者:
createSavepoint
在接口中SavepointManager
- 返回:
- a savepoint object, to be passed into
SavepointManager.rollbackToSavepoint(java.lang.Object)
orSavepointManager.releaseSavepoint(java.lang.Object)
- 抛出:
NestedTransactionNotSupportedException
- if the underlying transaction does not support savepointsTransactionException
- if the savepoint could not be created, for example because the transaction is not in an appropriate state- 另请参阅:
getSavepointManager()
,SavepointManager.createSavepoint()
rollbackToSavepoint
public void rollbackToSavepoint(Object savepoint) throws TransactionException
This implementation delegates to a SavepointManager for the underlying transaction, if possible.- 指定者:
rollbackToSavepoint
在接口中SavepointManager
- 参数:
savepoint
- the savepoint to roll back to- 抛出:
NestedTransactionNotSupportedException
- if the underlying transaction does not support savepointsTransactionException
- if the rollback failed- 另请参阅:
getSavepointManager()
,SavepointManager.rollbackToSavepoint(Object)
releaseSavepoint
public void releaseSavepoint(Object savepoint) throws TransactionException
This implementation delegates to a SavepointManager for the underlying transaction, if possible.- 指定者:
releaseSavepoint
在接口中SavepointManager
- 参数:
savepoint
- the savepoint to release- 抛出:
NestedTransactionNotSupportedException
- if the underlying transaction does not support savepointsTransactionException
- if the release failed- 另请参阅:
getSavepointManager()
,SavepointManager.releaseSavepoint(Object)
getSavepointManager
protected SavepointManager getSavepointManager()
Return a SavepointManager for the underlying transaction, if possible.Default implementation always throws a NestedTransactionNotSupportedException.
- 抛出:
NestedTransactionNotSupportedException
- if the underlying transaction does not support savepoints
flush
public void flush()
This implementations is empty, considering flush as a no-op.- 指定者:
flush
在接口中Flushable
- 指定者:
flush
在接口中TransactionStatus