io.flamingock.internal.core.transaction

Interface TransactionWrapper

public interface TransactionWrapper

Manages transaction lifecycle for change operations.

Implementations are responsible for:

• Injecting transaction-scoped dependencies into the execution runtime
• Starting a transaction before the operation
• Committing the transaction on success
• Rolling back the transaction on failure
• Ensuring proper resource cleanup

Transaction-scoped dependencies (e.g., database sessions, transaction handles) should be injected into the runtime after starting the transaction, making them available to the change during execution.

Method Summary

Modifier and Type	Method and Description
<T> T	wrapInTransaction(ExecutionRuntime injectableContextProvider, java.util.function.Function<ExecutionRuntime,T> operation) Wraps the execution of an operation within a transaction.

Method Detail

wrapInTransaction

<T> T wrapInTransaction(ExecutionRuntime injectableContextProvider,
                        java.util.function.Function<ExecutionRuntime,T> operation)

Wraps the execution of an operation within a transaction.

The implementation should follow this pattern:

1. Start a transaction
2. Inject transaction-scoped dependencies into the runtime
3. Execute the operation
4. Commit on success or rollback on failure
5. Clean up resources

Type Parameters:

T - the return type of the operation

Parameters:

injectableContextProvider - the execution runtime for dependency injection

operation - the function to execute within the transaction

Returns:

the result of the operation

Throws:

java.lang.RuntimeException - if the transaction fails