KandraCodec

Converts values between Kotlin types and the DataStax Java driver's type system.

Null contract: if a column is NULL in Scylla:

Encode null contract: if value is null on write:

Nullable Kotlin type → returns KandraUnset (leave column unchanged, no tombstone)
Non-nullable Kotlin type → throws KandraQueryException

Custom types can be registered via registerEncoder and registerDecoder. A shared default instance is available via KandraCodec.default.

Constructors

constructor()

fun decode(row: Row, column: ColumnSchema): Any?

Reads a column from row using the column's metadata and returns a typed Kotlin value.

fun encode(value: Any?, type: KType): Any?

Converts a Kotlin value to the form expected by the DataStax driver.

fun <T : Any> registerDecoder(klass: KClass<T>, decoder: (Row, String) -> T?)

Registers a custom decoder: reads a column from a Row and returns a Kotlin value of type T.

fun <T : Any> registerEncoder(klass: KClass<T>, encoder: (T) -> Any?)

Registers a custom encoder: converts a Kotlin value of type T to a driver-compatible value.