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

FatalDatabaseException

abstract class FatalDatabaseException(message: String, queryContext: QueryContext?, cause: Throwable?) : OctaviusException

Base class for non-recoverable database errors that are thrown immediately instead of being wrapped in io.github.octaviusframework.db.api.DataResult.

These exceptions typically represent developer errors (e.g., SQL syntax errors, type mapping mismatches) or critical system failures that require code changes or operator intervention.

Inheritors

BadStatementException

InitializationException

StepDependencyException

TypeMappingException

TypeRegistryException

Constructors

FatalDatabaseException

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

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.