driver/io.github.octaviusframework.driver.exception/MappingException

MappingException

class MappingException(val reason: MappingExceptionReason, val details: String, cause: Throwable? = null, val path: MutableList<String> = mutableListOf()) : OctaviusException

Exception thrown when a type conversion or data mapping operation fails.

This includes scenarios like failing to convert data between incompatible types (e.g., mapping an Int to a String), missing columns in a database row, or missing required non-nullable properties in a Kotlin class.

Parameters

cause

The underlying exception that caused this failure, if any.

Constructors

MappingException

constructor(reason: MappingExceptionReason, details: String, cause: Throwable? = null, path: MutableList<String> = mutableListOf())

Properties

cause

open val cause: Throwable?

details

val details: String

Additional details about the mapping failure.

message

open val message: String?

path

val path: MutableList<String>

The path in the nested object structure where the mapping error occurred.

queryContext

var queryContext: QueryContext?

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

reason

val reason: MappingExceptionReason

The reason the mapping failed.

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.

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.

toString

open override fun toString(): String