Spring Framework 6.1.4 · org.springframework.jdbc.datasource.JdbcTransactionObjectSupport

Convenient base class for JDBC-aware transaction objects. Can contain a ConnectionHolder with a JDBC Connection, and implements the SavepointManager interface based on that ConnectionHolder.

Allows for programmatic management of JDBC Savepoints. Spring's org.springframework.transaction.support.DefaultTransactionStatus automatically delegates to this, as it autodetects transaction objects which implement the SavepointManager interface.

Modifier and Type	Field and Description
private ConnectionHolder	connectionHolder
private static final Log	logger
private Integer	previousIsolationLevel
private boolean	readOnly
private boolean	savepointAllowed

Constructor Summary

Access	Constructor and Description
public	JdbcTransactionObjectSupport()

Method Summary

Modifier and Type	Method and Description
public Object	createSavepoint() Implements org.springframework.transaction.SavepointManager.createSavepoint. This implementation creates a JDBC Savepoint and returns it.
public ConnectionHolder	getConnectionHolder() Return the ConnectionHolder for this transaction object.
protected ConnectionHolder	getConnectionHolderForSavepoint()
public Integer	getPreviousIsolationLevel() Return the retained previous isolation level, if any.
public boolean	hasConnectionHolder() Check whether this transaction object has a ConnectionHolder.
public boolean	isReadOnly() Return the read-only status of this transaction.
public boolean	isSavepointAllowed() Return whether savepoints are allowed within this transaction.
public void	releaseSavepoint(Object the savepoint to release savepoint) Implements org.springframework.transaction.SavepointManager.releaseSavepoint. This implementation releases the given JDBC Savepoint.
public void	rollbackToSavepoint(Object the savepoint to roll back to savepoint) Implements org.springframework.transaction.SavepointManager.rollbackToSavepoint. This implementation rolls back to the given JDBC Savepoint.
public void	setConnectionHolder(ConnectionHolder connectionHolder) Set the ConnectionHolder for this transaction object.
public void	setPreviousIsolationLevel(Integer previousIsolationLevel) Set the previous isolation level to retain, if any.
public void	setReadOnly(boolean readOnly) Set the read-only status of this transaction.
public void	setSavepointAllowed(boolean savepointAllowed) Set whether savepoints are allowed within this transaction.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

connectionHolder	back to summary
private ConnectionHolder connectionHolder Annotations @Nullable

logger	back to summary
private static final Log logger

previousIsolationLevel	back to summary
private Integer previousIsolationLevel Annotations @Nullable

readOnly	back to summary
private boolean readOnly

savepointAllowed	back to summary
private boolean savepointAllowed

Constructor Detail

JdbcTransactionObjectSupport	back to summary
public JdbcTransactionObjectSupport()

Method Detail

createSavepoint back to summary

createSavepoint	back to summary
public Object createSavepoint() throws TransactionException Implements org.springframework.transaction.SavepointManager.createSavepoint. This implementation creates a JDBC Savepoint and returns it. Returns:Object Doc from org.springframework.transaction.SavepointManager.createSavepoint. a savepoint object, to be passed into `rollbackToSavepoint` or `releaseSavepoint` Annotations @Override Exceptions TransactionException: Doc from org.springframework.transaction.SavepointManager.createSavepoint. if the savepoint could not be created, for example because the transaction is not in an appropriate state See Also `java.sql.Connection#setSavepoint`

public Object createSavepoint() throws TransactionException

Implements org.springframework.transaction.SavepointManager.createSavepoint.

This implementation creates a JDBC Savepoint and returns it.

Returns:Object

Doc from org.springframework.transaction.SavepointManager.createSavepoint.

a savepoint object, to be passed into rollbackToSavepoint or releaseSavepoint

Annotations

@Override

Exceptions

TransactionException:

Doc from org.springframework.transaction.SavepointManager.createSavepoint.

if the savepoint could not be created, for example because the transaction is not in an appropriate state

See Also

java.sql.Connection#setSavepoint

getConnectionHolder	back to summary
public ConnectionHolder getConnectionHolder() Return the ConnectionHolder for this transaction object.

getConnectionHolderForSavepoint	back to summary
protected ConnectionHolder getConnectionHolderForSavepoint() throws TransactionException

getPreviousIsolationLevel	back to summary
public Integer getPreviousIsolationLevel() Return the retained previous isolation level, if any. Annotations @Nullable

getPreviousIsolationLevel

back to summary

public Integer getPreviousIsolationLevel()

Return the retained previous isolation level, if any.

Annotations

@Nullable

hasConnectionHolder	back to summary
public boolean hasConnectionHolder() Check whether this transaction object has a ConnectionHolder.

isReadOnly	back to summary
public boolean isReadOnly() Return the read-only status of this transaction. Since 5.2.1

isReadOnly

back to summary

public boolean isReadOnly()

Return the read-only status of this transaction.

Since: 5.2.1

isSavepointAllowed	back to summary
public boolean isSavepointAllowed() Return whether savepoints are allowed within this transaction.

releaseSavepoint back to summary

releaseSavepoint	back to summary
public void releaseSavepoint(Object savepoint) throws TransactionException Implements org.springframework.transaction.SavepointManager.releaseSavepoint. This implementation releases the given JDBC Savepoint. Parameters savepoint:Object Doc from org.springframework.transaction.SavepointManager.releaseSavepoint. the savepoint to release Annotations @Override Exceptions TransactionException: Doc from org.springframework.transaction.SavepointManager.releaseSavepoint. if the release failed See Also `java.sql.Connection#releaseSavepoint`

public void releaseSavepoint(Object savepoint) throws TransactionException

Implements org.springframework.transaction.SavepointManager.releaseSavepoint.

This implementation releases the given JDBC Savepoint.

Parameters

savepoint:Object

Doc from org.springframework.transaction.SavepointManager.releaseSavepoint.

the savepoint to release

Annotations

@Override

Exceptions

TransactionException:

Doc from org.springframework.transaction.SavepointManager.releaseSavepoint.

if the release failed

See Also

java.sql.Connection#releaseSavepoint

rollbackToSavepoint back to summary

rollbackToSavepoint	back to summary
public void rollbackToSavepoint(Object savepoint) throws TransactionException Implements org.springframework.transaction.SavepointManager.rollbackToSavepoint. This implementation rolls back to the given JDBC Savepoint. Parameters savepoint:Object Doc from org.springframework.transaction.SavepointManager.rollbackToSavepoint. the savepoint to roll back to Annotations @Override Exceptions TransactionException: Doc from org.springframework.transaction.SavepointManager.rollbackToSavepoint. if the rollback failed See Also `java.sql.Connection#rollback(java.sql.Savepoint)`

public void rollbackToSavepoint(Object savepoint) throws TransactionException

Implements org.springframework.transaction.SavepointManager.rollbackToSavepoint.

This implementation rolls back to the given JDBC Savepoint.

Parameters

savepoint:Object

Doc from org.springframework.transaction.SavepointManager.rollbackToSavepoint.

the savepoint to roll back to

Annotations

@Override

Exceptions

TransactionException:

Doc from org.springframework.transaction.SavepointManager.rollbackToSavepoint.

if the rollback failed

setConnectionHolder	back to summary
public void setConnectionHolder(ConnectionHolder connectionHolder) Set the ConnectionHolder for this transaction object.

setPreviousIsolationLevel	back to summary
public void setPreviousIsolationLevel(Integer previousIsolationLevel) Set the previous isolation level to retain, if any.

setReadOnly back to summary

setReadOnly	back to summary
public void setReadOnly(boolean readOnly) Set the read-only status of this transaction. The default is `false`. Since 5.2.1

public void setReadOnly(boolean readOnly)

Set the read-only status of this transaction. The default is false.

Since: 5.2.1

setSavepointAllowed	back to summary
public void setSavepointAllowed(boolean savepointAllowed) Set whether savepoints are allowed within this transaction. The default is `false`.

public abstract Class JdbcTransactionObjectSupport

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail