api/io.github.octaviusframework.db.api.exception/DatabaseException

DatabaseException

sealed class DatabaseException(message: String, cause: Throwable? = null, queryContext: QueryContext? = null) : OctaviusException

Base exception for recoverable database errors that are returned within io.github.octaviusframework.db.api.DataResult.

These exceptions represent errors that occur during query execution (e.g., constraint violations, serialization failures) and can often be handled by the application logic.

Inheritors

ConnectionException

ConstraintViolationException

DataOperationException

TransactionException

UnknownDatabaseException

Constructors

DatabaseException

protected constructor(message: String, cause: Throwable? = null, queryContext: QueryContext? = null)

Properties

cause

open val cause: Throwable?

message

open val message: String?

queryContext

open val queryContext: QueryContext?

Functions

getDetailedMessage

open fun getDetailedMessage(): String?

Subclasses can provide additional technical details here.

toString

open override fun toString(): String

withContext

fun withContext(context: QueryContext): OctaviusException

Enriches the exception with a full query context.

withStepIndex

fun withStepIndex(index: Int): OctaviusException

Enriches the exception with the transaction step index.