driver/io.github.octaviusframework.driver.exception/DataException

DataException

class DataException(val reason: DataExceptionReason, sqlState: String, serverErrorMessage: ServerErrorMessage) : OctaviusException

Exception thrown when an operation fails due to invalid data values during execution.

Unlike syntax or definition errors, this occurs when the query structure is correct, but the runtime values (often parameters) cause an error. Examples include string truncation, numeric overflow, division by zero, or invalid text representation of a data type.

Parameters

sqlState

The SQL state code returned by the database.

serverErrorMessage

The original error message from the database server.

Constructors

constructor(reason: DataExceptionReason, sqlState: String, serverErrorMessage: ServerErrorMessage)

Properties

open val cause: Throwable?

val dbMessage: String

The primary error message the database raised.

val details: String?

Additional, human-readable details provided by the database.

open val message: String?

var queryContext: QueryContext?

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

val reason: DataExceptionReason

The specific reason for the data error.

serverErrorMessage

val serverErrorMessage: ServerErrorMessage?

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

val sqlState: String?

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

val where: String?

The call stack the error arose in, for one raised inside a trigger or function.

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.

open override fun toString(): String