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

ConstraintViolationException

class ConstraintViolationException(val messageEnum: ConstraintViolationExceptionMessage, val tableName: String? = null, val columnName: String? = null, val constraintName: String? = null, queryContext: QueryContext?, cause: Throwable?) : DatabaseException

Exception thrown when a database operation violates data integrity constraints.

This is a common exception for handling domain rules enforced by the database (e.g., "Email already exists" or "Referenced user not found").

It provides metadata like tableName, columnName, and constraintName if provided by the database driver.

Constructors

ConstraintViolationException

constructor(messageEnum: ConstraintViolationExceptionMessage, tableName: String? = null, columnName: String? = null, constraintName: String? = null, queryContext: QueryContext?, cause: Throwable?)

Properties

open val cause: Throwable?

val columnName: String?

val constraintName: String?

open val message: String?

val messageEnum: ConstraintViolationExceptionMessage

open val queryContext: QueryContext?

val tableName: String?

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.