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

BadStatementException

class BadStatementException(val messageEnum: BadStatementExceptionMessage, val errorPosition: Int? = null, queryContext: QueryContext? = null, cause: Throwable?) : FatalDatabaseException

Exception thrown when a query is semantically or syntactically invalid.

This exception covers:

Framework Validation: Errors detected before sending the query to the DB (e.g., missing WHERE clause).
Database Syntax/Access Errors: Errors returned by PostgreSQL (Class 42), such as typos in table names or incorrect SQL syntax.

As a FatalDatabaseException, it indicates a developer error that cannot be recovered from at runtime without code changes.

Constructors

BadStatementException

constructor(messageEnum: BadStatementExceptionMessage, errorPosition: Int? = null, queryContext: QueryContext? = null, cause: Throwable?)

Properties

open val cause: Throwable?

val errorPosition: Int?

open val message: String?

val messageEnum: BadStatementExceptionMessage

open val queryContext: QueryContext?

Functions

getDetailedMessage

open override fun getDetailedMessage(): String

Subclasses can provide additional technical details here.

open override fun toString(): String

fun withContext(context: QueryContext): OctaviusException

Enriches the exception with a full query context.

fun withStepIndex(index: Int): OctaviusException

Enriches the exception with the transaction step index.