driver/io.github.octaviusframework.driver.exception/TypeException

TypeException

class TypeException(val reason: TypeExceptionReason, val oid: Int? = null, val typeName: String? = null, val details: String? = null) : OctaviusException

Exception thrown when type resolution or validation fails within the driver's type registry.

Includes scenarios where a type cannot be found, an incorrect container type is used, or an expected codec is missing.

Constructors

TypeException

constructor(reason: TypeExceptionReason, oid: Int? = null, typeName: String? = null, details: String? = null)

Properties

cause

open val cause: Throwable?

details

val details: String?

Additional human-readable details about the failure.

message

open val message: String?

oid

val oid: Int?

The OID of the type that caused the error, if applicable.

path

val path: MutableList<String>

Where this happened, innermost first, appended to by each layer as the exception unwinds. It is on the base class for the same reason queryContext is: adding to it is the only thing a frame can do to an exception without replacing it, and replacing one costs the type the caller catches on - a ConstraintViolationException restated as something else stops being the failure a retry looks for. A mapper walking a nested composite appends the attribute it was on, a transaction plan the step and parameter it was resolving. Rendered reversed, outermost first, so PATH: step 1 -> parameter 'name' -> map #1 reads from the plan down to the lambda.

queryContext

var queryContext: QueryContext?

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

reason

val reason: TypeExceptionReason

The specific reason for the type error.

serverErrorMessage

val serverErrorMessage: ServerErrorMessage?

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

sqlState

val sqlState: String?

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