Spring Transaction 6.1.4 · org.springframework.transaction.support.TransactionOperations

Method Summary

Modifier and Type	Method and Description
public <T> T	Returns: a result object returned by the callback, or `null` if none execute(TransactionCallback<T> the callback object that specifies the transactional action action) Execute the action specified by the given callback object within a transaction.
public default void	executeWithoutResult(Consumer<TransactionStatus> the Runnable that specifies the transactional action action) Execute the action specified by the given `Runnable` within a transaction.
public static TransactionOperations	withoutTransaction() Return an implementation of the `TransactionOperations` interface which executes a given `TransactionCallback` without an actual transaction.

Method Detail

execute back to summary

execute	back to summary
public <T> T execute(TransactionCallback<T> action) throws TransactionException Execute the action specified by the given callback object within a transaction. Allows for returning a result object created within the transaction, that is, a domain object or a collection of domain objects. A RuntimeException thrown by the callback is treated as a fatal exception that enforces a rollback. Such an exception gets propagated to the caller of the template. Parameters action:TransactionCallback<T> the callback object that specifies the transactional action Returns:T a result object returned by the callback, or `null` if none Annotations @Nullable Exceptions TransactionException: in case of initialization, rollback, or system errors RuntimeException: if thrown by the TransactionCallback See Also `executeWithoutResult(Consumer)`

public <T> T execute(TransactionCallback<T> action) throws TransactionException

Execute the action specified by the given callback object within a transaction.

Allows for returning a result object created within the transaction, that is, a domain object or a collection of domain objects. A RuntimeException thrown by the callback is treated as a fatal exception that enforces a rollback. Such an exception gets propagated to the caller of the template.

Parameters

action:TransactionCallback<T>: the callback object that specifies the transactional action

Returns:T

a result object returned by the callback, or null if none

Annotations

@Nullable

Exceptions

TransactionException:: in case of initialization, rollback, or system errors
RuntimeException:: if thrown by the TransactionCallback

See Also

executeWithoutResult(Consumer)

executeWithoutResult back to summary

executeWithoutResult	back to summary
public default void executeWithoutResult(Consumer<TransactionStatus> action) throws TransactionException Execute the action specified by the given `Runnable` within a transaction. If you need to return an object from the callback or access the `org.springframework.transaction.TransactionStatus` from within the callback, use `execute(TransactionCallback)` instead. This variant is analogous to using a `TransactionCallbackWithoutResult` but with a simplified signature for common cases - and conveniently usable with Java 8 lambda expressions. Parameters action:Consumer<TransactionStatus> the Runnable that specifies the transactional action Exceptions TransactionException: in case of initialization, rollback, or system errors RuntimeException: if thrown by the Runnable Since 5.2 See Also `execute(TransactionCallback)`, `TransactionCallbackWithoutResult`

public default void executeWithoutResult(Consumer<TransactionStatus> action) throws TransactionException

Execute the action specified by the given Runnable within a transaction.

If you need to return an object from the callback or access the org.springframework.transaction.TransactionStatus from within the callback, use execute(TransactionCallback) instead.

This variant is analogous to using a TransactionCallbackWithoutResult but with a simplified signature for common cases - and conveniently usable with Java 8 lambda expressions.

Parameters

action:Consumer<TransactionStatus>: the Runnable that specifies the transactional action

Exceptions

TransactionException:: in case of initialization, rollback, or system errors
RuntimeException:: if thrown by the Runnable

Since

5.2

withoutTransaction back to summary

withoutTransaction	back to summary
public static TransactionOperations withoutTransaction() Return an implementation of the `TransactionOperations` interface which executes a given `TransactionCallback` without an actual transaction. Useful for testing: The behavior is equivalent to running with a transaction manager with no actual transaction (PROPAGATION_SUPPORTS) and no synchronization (SYNCHRONIZATION_NEVER). For a `TransactionOperations` implementation with actual transaction processing, use `TransactionTemplate` with an appropriate `org.springframework.transaction.PlatformTransactionManager`. Since 5.2 See Also `org.springframework.transaction.TransactionDefinition#PROPAGATION_SUPPORTS`, `AbstractPlatformTransactionManager#SYNCHRONIZATION_NEVER`, `TransactionTemplate`

public static TransactionOperations withoutTransaction()

Return an implementation of the TransactionOperations interface which executes a given TransactionCallback without an actual transaction.

Useful for testing: The behavior is equivalent to running with a transaction manager with no actual transaction (PROPAGATION_SUPPORTS) and no synchronization (SYNCHRONIZATION_NEVER).

For a TransactionOperations implementation with actual transaction processing, use TransactionTemplate with an appropriate org.springframework.transaction.PlatformTransactionManager.

Since: 5.2
See Also: org.springframework.transaction.TransactionDefinition#PROPAGATION_SUPPORTS, AbstractPlatformTransactionManager#SYNCHRONIZATION_NEVER, TransactionTemplate

public Interface TransactionOperations

Method Summary

Method Detail