driver/io.github.octaviusframework.driver.exception/DatabaseSystemException

DatabaseSystemException

class DatabaseSystemException(val details: String, sqlState: String, serverErrorMessage: ServerErrorMessage) : OctaviusException

Exception thrown when a generic database system error occurs.

This typically represents internal server errors, disk full errors, out of memory errors, or other administrative failures originating from the database engine itself rather than from user query mistakes.

Parameters

sqlState

The SQL state code returned by the database.

serverErrorMessage

The original error message from the database server.

Constructors

DatabaseSystemException

constructor(details: String, sqlState: String, serverErrorMessage: ServerErrorMessage)

Properties

cause

open val cause: Throwable?

details

val details: String

The primary error message provided by the database system, with the SQLSTATE already in it.

message

open val message: String?

queryContext

var queryContext: QueryContext?

The context of the query that resulted in this exception, if applicable.

serverErrorMessage

val serverErrorMessage: ServerErrorMessage?

The raw error message received from the database, if applicable.

sqlState

val sqlState: String?

The SQL state code associated with the error, if applicable.

Functions

findOctaviusCause

fun Throwable.findOctaviusCause(): OctaviusException?

Finds the Octavius failure behind this throwable, if there is one.

getDetailedMessage

open override fun getDetailedMessage(): String

Provides a detailed, human-readable description of the error.

toString

open override fun toString(): String