driver/io.github.octaviusframework.driver.exception/InvalidOperationException

InvalidOperationException

class InvalidOperationException(val reason: InvalidOperationExceptionReason, val details: String? = null) : OctaviusException

Exception thrown when the driver attempts an operation that is not allowed in the current state or context.

Examples include trying to commit when auto-commit is enabled, operating on a closed statement, using unsupported features, or asking a query for something the call itself did not make possible.

Purely client-side: nothing here was reported by the server, so there is no sqlState and no serverErrorMessage. Raised inside a query, it still carries the queryContext - the SQL and the parameters - the way every driver exception does.

Constructors

InvalidOperationException

constructor(reason: InvalidOperationExceptionReason, details: String? = null)

Properties

open val cause: Throwable?

val details: String?

Additional details about the failure.

open val message: String?

var queryContext: QueryContext?

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

val reason: InvalidOperationExceptionReason

The specific type of invalid operation.

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.

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