driver/io.github.octaviusframework.driver.exception/ConstraintViolationException

ConstraintViolationException

class ConstraintViolationException(val reason: ConstraintViolationExceptionReason, sqlState: String, serverErrorMessage: ServerErrorMessage) : OctaviusException

Exception thrown when a database operation violates a defined constraint (e.g., unique index, foreign key, check constraint).

This exception encapsulates details about the constraint violation, including the specific type of violation (reason), and optional metadata such as the schema, table, column, and constraint name involved in the error.

Parameters

sqlState

The SQL state code returned by the database.

serverErrorMessage

The original error message from the database server.

Constructors

ConstraintViolationException

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

Properties

cause

open val cause: Throwable?

column

val column: String?

The name of the column associated with the constraint violation, if available.

constraint

val constraint: String?

The specific name of the constraint that was violated, if available.

dbMessage

val dbMessage: String

The primary error message the database raised.

details

val details: String?

Additional, human-readable details about the violation provided by the database. For a unique violation this is where the offending key and value appear.

message

open val message: String?

queryContext

var queryContext: QueryContext?

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

reason

val reason: ConstraintViolationExceptionReason

The specific type of constraint violation mapped from the database error.

schema

val schema: String?

The name of the schema containing the table where the violation occurred, if available.

serverErrorMessage