core/io.github.octaviusframework.db.core.jdbc/JdbcTransactionProvider

JdbcTransactionProvider

Interface for managing database connections and transactions. Decouples the core logic from specific transaction management implementations (like Spring).

Each DataAccess instance is backed by exactly one JdbcTransactionProvider.

Inheritors

DefaultJdbcTransactionProvider

Properties

dataSource

abstract val dataSource: DataSource

The underlying data source used for obtaining connections.

Functions

applyTimeout

abstract fun applyTimeout(statement: Statement)

Applies the current transaction timeout to the given statement.

execute

abstract fun <T> execute(propagation: TransactionPropagation, isolation: IsolationLevel = IsolationLevel.DEFAULT, readOnly: Boolean = false, timeoutSeconds: Int? = null, block: (TransactionStatus) -> T): T

Executes a block of code within a transaction context.

getConnection

abstract fun getConnection(): Connection

Obtains a connection for the current execution context. If a transaction is active, returns the connection bound to that transaction. Otherwise, returns a new connection from the dataSource.

releaseConnection

abstract fun releaseConnection(connection: Connection)

Releases the given connection. If the connection is part of an active transaction, it is NOT closed. Otherwise, it is returned to the pool (closed).