driver/io.github.octaviusframework.driver.registry/TypeRegistry

TypeRegistry

Registry holding the mapping of database types, data codecs, and type converters.

TypeRegistry manages the state for mapping PostgreSQL Object Identifiers (OIDs) to their corresponding type definitions (PgType), as well as providing resolution mechanisms for parameter encoders, result decoders, and data serialization.

Constructors

TypeRegistry

constructor()

Properties

codecs

@Volatile

var codecs: CodecDictionary

An immutable snapshot dictionary for database binary/text codecs.

converterRegistry

val converterRegistry: ConverterRegistry

The registry handling custom mappings and converters between Kotlin objects and PostgreSQL types.

dictionary

@Volatile

var dictionary: TypeDictionary

An immutable snapshot dictionary representing the current mapping of PostgreSQL OIDs and types.

isLoaded

@Volatile

var isLoaded: Boolean

lock

val lock: ReentrantLock

A lock used to ensure thread-safe updates to the registry's internal state.

Functions

registerCodec

fun registerCodec(codec: TypeCodec<*>)

Registers a custom codec. If OID and schema are missing (dynamic type in multi-schema), it will be mapped globally for deserialization but resolved in-flight for serialization.

updateTypes

fun updateTypes(newTypes: Map<Int, PgType>)

Replaces the entire type map with a new instance, ensuring thread-safety. Additionally applies custom codecs waiting for an OID.