From b143516cb97abfc9ed62a0020c9de6ea4b9f1888 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 14 Oct 2022 16:25:25 +0800
Subject: [PATCH 01/59] Add a more generic simple ORM prototype implementation
 for Exposed with being tested and update the project version

---
 .../main/kotlin/VersionsAndDependencies.kt    |   2 +-
 .../com/huanshankeji/exposed/SimpleOrm.kt     | 260 ++++++++++++++++--
 2 files changed, 234 insertions(+), 28 deletions(-)

diff --git a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
index cfd5e0b..49b2c3a 100644
--- a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
+++ b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
@@ -2,7 +2,7 @@ import com.huanshankeji.CommonDependencies
 import com.huanshankeji.CommonGradleClasspathDependencies
 import com.huanshankeji.CommonVersions
 
-val projectVersion = "0.2.4-SNAPSHOT"
+val projectVersion = "0.3.0-SNAPSHOT"
 
 val commonVersions = CommonVersions()
 val commonDependencies = CommonDependencies(commonVersions)
diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
index c5c8dd9..f1d2c4d 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
@@ -1,64 +1,80 @@
 package com.huanshankeji.exposed
 
+import com.huanshankeji.exposed.OnDuplicateColumnPropertyNames.*
+import com.huanshankeji.exposed.PropertyColumnMapping.*
 import org.jetbrains.exposed.dao.id.EntityID
 import org.jetbrains.exposed.sql.Alias
 import org.jetbrains.exposed.sql.Column
 import org.jetbrains.exposed.sql.ResultRow
 import org.jetbrains.exposed.sql.Table
 import org.jetbrains.exposed.sql.statements.UpdateBuilder
-import kotlin.reflect.KFunction
-import kotlin.reflect.KProperty1
+import kotlin.reflect.*
 import kotlin.reflect.full.memberProperties
 import kotlin.reflect.full.primaryConstructor
+import kotlin.reflect.full.withNullability
 
 // Our own simple ORM implementation using reflection which should be adapted using annotation processors and code generation in the future.
 
 
-interface SimpleOrm<D : Any, T : Table> {
-    fun resultRowToData(resultRow: ResultRow): D
-    fun updateBuilderSetter(data: D): T.(UpdateBuilder<Number>) -> Unit
+interface SimpleOrm<Data : Any, TableT : Table> {
+    fun resultRowToData(resultRow: ResultRow): Data
+    fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<Number>) -> Unit
 }
 
-interface ReflectionBasedSimpleOrm<D : Any, T : Table> : SimpleOrm<D, T> {
-    val propertyAndColumnPairs: List<Pair<KProperty1<D, *>, Column<*>>>
-    val dPrimaryConstructor: KFunction<D>
+fun ResultRow.getValue(column: Column<*>): Any? =
+    this[column].let {
+        if (it is EntityID<*>) it.value else it
+    }
 
-    override fun resultRowToData(resultRow: ResultRow): D {
-        val params = propertyAndColumnPairs.map { (_, tColumn) ->
-            resultRow[tColumn].let {
-                if (it is EntityID<*>) it.value else it
-            }
-        }
-        return dPrimaryConstructor.call(*params.toTypedArray())
+interface ReflectionBasedSimpleOrm<Data : Any, TableT : Table> : SimpleOrm<Data, TableT> {
+    val propertyAndColumnPairs: List<Pair<KProperty1<Data, *>, Column<*>>>
+    val dataPrimaryConstructor: KFunction<Data>
+
+    override fun resultRowToData(resultRow: ResultRow): Data {
+        val params = propertyAndColumnPairs.map { (_, column) -> resultRow.getValue(column) }
+        return dataPrimaryConstructor.call(*params.toTypedArray())
     }
 
-    override fun updateBuilderSetter(data: D): T.(UpdateBuilder<Number>) -> Unit = {
-        for ((dProperty, tColumn) in propertyAndColumnPairs)
+    override fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<Number>) -> Unit = {
+        for ((property, column) in propertyAndColumnPairs)
             @Suppress("UNCHECKED_CAST")
-            it[tColumn as Column<Any?>] = dProperty(data)
+            it[column as Column<Any?>] = property(data)
     }
 }
 
-inline fun <reified D : Any, reified T : Table> reflectionBasedSimpleOrm(table: T): ReflectionBasedSimpleOrm<D, T> =
-    object : ReflectionBasedSimpleOrm<D, T> {
-        val dClass = D::class
-        override val dPrimaryConstructor = dClass.primaryConstructor!!
+inline fun <reified Data : Any, reified TableT : Table> reflectionBasedSimpleOrm(table: TableT): ReflectionBasedSimpleOrm<Data, TableT> =
+    object : ReflectionBasedSimpleOrm<Data, TableT> {
+        private val clazz = Data::class
         override val propertyAndColumnPairs = run {
             //require(dClass.isData)
-            val dMemberPropertyMap = dClass.memberProperties.associateBy { it.name }
-            val tMemberPropertyMap = T::class.memberProperties.associateBy { it.name }
-            dPrimaryConstructor.parameters.map {
+            val dataMemberPropertyMap = clazz.memberProperties.associateBy { it.name }
+            val columnMap = getColumnByPropertyNameMapWithTypeParameter(table)
+            dataPrimaryConstructor.parameters.map {
                 val name = it.name!!
-                dMemberPropertyMap.getValue(name) to tMemberPropertyMap.getValue(name)(table) as Column<*>
+                dataMemberPropertyMap.getValue(name) to columnMap.getValue(name)
             }
         }
+        override val dataPrimaryConstructor = clazz.primaryConstructor!!
     }
 
+@Suppress("UNCHECKED_CAST")
+fun <TableT : Table> getColumnProperties(clazz: KClass<TableT>): Sequence<KProperty1<TableT, Column<*>>> =
+    clazz.memberProperties.asSequence()
+        .filter { it.returnType.classifier == Column::class }
+            as Sequence<KProperty1<TableT, Column<*>>>
+
+fun <TableT : Table> getColumnPropertyByNameMap(clazz: KClass<TableT>): Map<String, KProperty1<TableT, Column<*>>> =
+    getColumnProperties(clazz).associateBy { it.name }
+
+inline fun <reified TableT : Table> getColumnByPropertyNameMapWithTypeParameter(table: TableT): Map<String, Column<*>> =
+    getColumnPropertyByNameMap(TableT::class)
+        .mapValues { it.value(table) }
+
 inline fun <reified D : Any, reified T : Table> reflectionBasedSimpleOrmForAlias(
     tableOrm: ReflectionBasedSimpleOrm<D, T>, alias: Alias<T>
 ): ReflectionBasedSimpleOrm<D, T> =
     object : ReflectionBasedSimpleOrm<D, T> {
-        override val dPrimaryConstructor = tableOrm.dPrimaryConstructor
+        override val dataPrimaryConstructor = tableOrm.dataPrimaryConstructor
         override val propertyAndColumnPairs = tableOrm.propertyAndColumnPairs.map { it.first to alias[it.second] }
     }
 
@@ -91,3 +107,193 @@ inline fun <D1 : Any, D2 : Any, D3 : Any> leftJoinResultRowToData(
         if (it[onColumn3] !== null) resultRowToData3(it) else null
     )
 }
+
+
+typealias PropertyColumnMappings<Data> = List<PropertyColumnMapping<Data, *>>
+//typealias LessStrictlyTypedPropertyColumnMappings<Data> = List<PropertyColumnMapping<Data, Any?>>
+/** In the order of the constructor arguments. */
+typealias ClassColumnMappings<Data> = PropertyColumnMappings<Data>
+
+sealed class PropertyColumnMapping<Data : Any, PropertyValue>(val property: KProperty1<Data, PropertyValue>) {
+    class SqlPrimitive<Data : Any, PrimitiveValue>(
+        property: KProperty1<Data, PrimitiveValue>,
+        val column: Column<PrimitiveValue>
+    ) : PropertyColumnMapping<Data, PrimitiveValue>(property)
+
+    class NestedClass<Data : Any, NestedData>(
+        property: KProperty1<Data, NestedData>,
+        //val nullabilityDependentColumn: Column<*>,
+        val nestedMappings: ClassColumnMappings<NestedData & Any>
+    ) : PropertyColumnMapping<Data, NestedData>(property)
+}
+
+
+// see: https://kotlinlang.org/docs/basic-types.html, https://www.postgresql.org/docs/current/datatype.html
+// Types that are commented out are not ensured to work yet.
+val defaultSqlNotNullPrimitiveTypes = listOf(
+    typeOf<Byte>(), typeOf<Short>(), typeOf<Int>(), typeOf<Long>(), /*typeOf<BigInteger>(),*/
+    typeOf<UByte>(), typeOf<UShort>(), typeOf<UInt>(), typeOf<ULong>(),
+    typeOf<Float>(), typeOf<Double>(), /*typeOf<BigDecimal>(),*/
+    typeOf<Boolean>(),
+    typeOf<ByteArray>(),
+    //typeOf<Char>(),
+    typeOf<String>(),
+    // types related to time and date
+)
+
+class ColumnWithPropertyName(val propertyName: String, val column: Column<*>)
+
+fun getColumnsWithPropertyNamesWithoutTypeParameter(
+    table: Table, clazz: KClass<out Table> = table::class
+): Sequence<ColumnWithPropertyName> =
+    getColumnProperties(clazz).map {
+        @Suppress("UNCHECKED_CAST")
+        ColumnWithPropertyName(it.name, (it as KProperty1<Any, Column<*>>)(table))
+    }
+
+enum class OnDuplicateColumnPropertyNames {
+    CHOOSE_FIRST, THROW
+}
+
+fun getColumnByPropertyNameMap(
+    tables: List<Table>,
+    onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST // defaults to `CHOOSE_FIRST` because there are very likely to be duplicate columns when joining table
+): Map<String, Column<*>> {
+    val columnsMap = tables.asSequence()
+        .flatMap { table -> getColumnsWithPropertyNamesWithoutTypeParameter(table) }
+        .groupBy { it.propertyName }
+    return columnsMap.mapValues {
+        it.value.run {
+            when (onDuplicateColumnPropertyNames) {
+                CHOOSE_FIRST -> first()
+                THROW -> single()
+            }
+                .column
+        }
+    }
+}
+
+
+fun <Data : Any> getDefaultClassColumnMappings(
+    clazz: KClass<Data>,
+    columnByPropertyNameMap: Map<String, Column<*>>,
+    customMappings: PropertyColumnMappings<Data> = listOf()
+): ClassColumnMappings<Data> {
+    val customMappingProperties = customMappings.asSequence().map { it.property }.toSet()
+    val dataMemberPropertyMap =
+        (clazz.memberProperties.toSet() - customMappingProperties).associateBy { it.name }
+
+    return clazz.primaryConstructor!!.parameters.map {
+        val name = it.name!!
+        val property = dataMemberPropertyMap[name]
+        val notNullType = it.type.withNullability(false)
+        @Suppress("UNCHECKED_CAST")
+        if (notNullType in defaultSqlNotNullPrimitiveTypes)
+            SqlPrimitive(property as KProperty1<Data, Any?>, columnByPropertyNameMap.getValue(name) as Column<Any?>)
+        else
+            NestedClass(
+                property as KProperty1<Data, Any?>,
+                getDefaultClassColumnMappings(
+                    notNullType.classifier as KClass<*>, columnByPropertyNameMap
+                ) as ClassColumnMappings<Any>
+            )
+    }
+}
+
+fun <Data : Any> getDefaultClassColumnMappings(
+    clazz: KClass<Data>,
+    tables: List<Table>,
+    customMappings: PropertyColumnMappings<Data> = listOf(),
+    onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST
+): ClassColumnMappings<Data> =
+    getDefaultClassColumnMappings(
+        clazz, getColumnByPropertyNameMap(tables, onDuplicateColumnPropertyNames), customMappings
+    )
+
+interface GenericSimpleOrm<Data : Any> : SimpleOrm<Data, Table> {
+    val neededColumns: List<Column<*>>
+}
+
+/** Supports classes with nested composite class properties and multiple tables */
+class ReflectionBasedGenericSimpleOrm<Data : Any>(
+    val clazz: KClass<Data>,
+    val classColumnMappings: ClassColumnMappings<Data>,
+) : GenericSimpleOrm<Data> {
+    override val neededColumns = classColumnMappings.getNeededColumns()
+    override fun resultRowToData(resultRow: ResultRow): Data =
+        constructDataWithResultRow(clazz, classColumnMappings, resultRow)
+
+    override fun updateBuilderSetter(data: Data): Table.(UpdateBuilder<Number>) -> Unit = {
+        setUpdateBuilder(classColumnMappings, data, it)
+    }
+}
+
+fun <Data : Any> constructDataWithResultRow(
+    clazz: KClass<Data>, classColumnMappings: ClassColumnMappings<Data>, resultRow: ResultRow
+): Data =
+    clazz.primaryConstructor!!.call(*classColumnMappings.map {
+        when (it) {
+            is SqlPrimitive -> resultRow.getValue(it.column)
+            is NestedClass ->
+                // TODO: the nullable case is not implemented yet
+                @Suppress("UNCHECKED_CAST")
+                constructDataWithResultRow(
+                    it.property.returnType.classifier as KClass<Any>,
+                    it.nestedMappings as ClassColumnMappings<Any>,
+                    resultRow
+                )
+        }
+    }.toTypedArray())
+
+fun <Data : Any> setUpdateBuilder(
+    classColumnMappings: ClassColumnMappings<Data>, data: Data, updateBuilder: UpdateBuilder<Number>
+) {
+    for (propertyColumnMapping in classColumnMappings)
+        when (propertyColumnMapping) {
+            is SqlPrimitive ->
+                @Suppress("UNCHECKED_CAST")
+                updateBuilder[propertyColumnMapping.column as Column<Any?>] = propertyColumnMapping.property(data)
+
+            is NestedClass -> {
+                @Suppress("NAME_SHADOWING", "UNCHECKED_CAST")
+                val propertyColumnMapping = propertyColumnMapping as NestedClass<Data, Any?>
+                val nestedMappings = propertyColumnMapping.nestedMappings
+                propertyColumnMapping.property(data)?.let {
+                    setUpdateBuilder(nestedMappings, it, updateBuilder)
+                }
+                    ?: setUpdateBuilderToNulls(nestedMappings, updateBuilder)
+            }
+        }
+}
+
+fun ClassColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
+    for (propertyColumnMapping in this)
+        when (propertyColumnMapping) {
+            is SqlPrimitive -> block(propertyColumnMapping.column)
+            is NestedClass -> {
+                propertyColumnMapping.nestedMappings.forEachColumn(block)
+            }
+        }
+}
+
+fun <Data : Any> setUpdateBuilderToNulls(
+    classColumnMappings: ClassColumnMappings<Data>, updateBuilder: UpdateBuilder<Number>
+) =
+    classColumnMappings.forEachColumn {
+        @Suppress("UNCHECKED_CAST")
+        updateBuilder[it as Column<Any?>] = null
+    }
+
+fun ClassColumnMappings<*>.getNeededColumns(): List<Column<*>> =
+    buildList { forEachColumn { add(it) } }
+
+inline fun <reified Data : Any> reflectionBasedGenericSimpleOrm(
+    tables: List<Table>,
+    customMappings: PropertyColumnMappings<Data> = listOf(),
+    onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST
+): ReflectionBasedGenericSimpleOrm<Data> {
+    val clazz = Data::class
+    return ReflectionBasedGenericSimpleOrm(
+        clazz, getDefaultClassColumnMappings(clazz, tables, customMappings, onDuplicateColumnPropertyNames)
+    )
+}

From 136357521c72c07f76db58cca800ab71e1fdaec3 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 14 Oct 2022 20:16:13 +0800
Subject: [PATCH 02/59] Support enum types in the generic simple ORM
 implementation

---
 .../com/huanshankeji/exposed/SimpleOrm.kt     | 22 +++++++++++++------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
index f1d2c4d..983b7a2 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
@@ -9,6 +9,7 @@ import org.jetbrains.exposed.sql.ResultRow
 import org.jetbrains.exposed.sql.Table
 import org.jetbrains.exposed.sql.statements.UpdateBuilder
 import kotlin.reflect.*
+import kotlin.reflect.full.isSubtypeOf
 import kotlin.reflect.full.memberProperties
 import kotlin.reflect.full.primaryConstructor
 import kotlin.reflect.full.withNullability
@@ -115,7 +116,7 @@ typealias PropertyColumnMappings<Data> = List<PropertyColumnMapping<Data, *>>
 typealias ClassColumnMappings<Data> = PropertyColumnMappings<Data>
 
 sealed class PropertyColumnMapping<Data : Any, PropertyValue>(val property: KProperty1<Data, PropertyValue>) {
-    class SqlPrimitive<Data : Any, PrimitiveValue>(
+    class ExposedSqlPrimitive<Data : Any, PrimitiveValue>(
         property: KProperty1<Data, PrimitiveValue>,
         val column: Column<PrimitiveValue>
     ) : PropertyColumnMapping<Data, PrimitiveValue>(property)
@@ -130,7 +131,7 @@ sealed class PropertyColumnMapping<Data : Any, PropertyValue>(val property: KPro
 
 // see: https://kotlinlang.org/docs/basic-types.html, https://www.postgresql.org/docs/current/datatype.html
 // Types that are commented out are not ensured to work yet.
-val defaultSqlNotNullPrimitiveTypes = listOf(
+val defaultNotNullExposedSqlPrimitiveTypes = listOf(
     typeOf<Byte>(), typeOf<Short>(), typeOf<Int>(), typeOf<Long>(), /*typeOf<BigInteger>(),*/
     typeOf<UByte>(), typeOf<UShort>(), typeOf<UInt>(), typeOf<ULong>(),
     typeOf<Float>(), typeOf<Double>(), /*typeOf<BigDecimal>(),*/
@@ -141,6 +142,10 @@ val defaultSqlNotNullPrimitiveTypes = listOf(
     // types related to time and date
 )
 
+val enumType = typeOf<Enum<*>>()
+fun KType.notNullTypeIsExposedSqlPrimitiveType(): Boolean =
+    this in defaultNotNullExposedSqlPrimitiveTypes || isSubtypeOf(enumType)
+
 class ColumnWithPropertyName(val propertyName: String, val column: Column<*>)
 
 fun getColumnsWithPropertyNamesWithoutTypeParameter(
@@ -188,8 +193,11 @@ fun <Data : Any> getDefaultClassColumnMappings(
         val property = dataMemberPropertyMap[name]
         val notNullType = it.type.withNullability(false)
         @Suppress("UNCHECKED_CAST")
-        if (notNullType in defaultSqlNotNullPrimitiveTypes)
-            SqlPrimitive(property as KProperty1<Data, Any?>, columnByPropertyNameMap.getValue(name) as Column<Any?>)
+        if (notNullType.notNullTypeIsExposedSqlPrimitiveType())
+            ExposedSqlPrimitive(
+                property as KProperty1<Data, Any?>,
+                columnByPropertyNameMap.getValue(name) as Column<Any?>
+            )
         else
             NestedClass(
                 property as KProperty1<Data, Any?>,
@@ -233,7 +241,7 @@ fun <Data : Any> constructDataWithResultRow(
 ): Data =
     clazz.primaryConstructor!!.call(*classColumnMappings.map {
         when (it) {
-            is SqlPrimitive -> resultRow.getValue(it.column)
+            is ExposedSqlPrimitive -> resultRow.getValue(it.column)
             is NestedClass ->
                 // TODO: the nullable case is not implemented yet
                 @Suppress("UNCHECKED_CAST")
@@ -250,7 +258,7 @@ fun <Data : Any> setUpdateBuilder(
 ) {
     for (propertyColumnMapping in classColumnMappings)
         when (propertyColumnMapping) {
-            is SqlPrimitive ->
+            is ExposedSqlPrimitive ->
                 @Suppress("UNCHECKED_CAST")
                 updateBuilder[propertyColumnMapping.column as Column<Any?>] = propertyColumnMapping.property(data)
 
@@ -269,7 +277,7 @@ fun <Data : Any> setUpdateBuilder(
 fun ClassColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
     for (propertyColumnMapping in this)
         when (propertyColumnMapping) {
-            is SqlPrimitive -> block(propertyColumnMapping.column)
+            is ExposedSqlPrimitive -> block(propertyColumnMapping.column)
             is NestedClass -> {
                 propertyColumnMapping.nestedMappings.forEachColumn(block)
             }

From 9d7123dcc1d4d8668c26c8ac3f860ab13fe46e1a Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 14 Oct 2022 20:50:52 +0800
Subject: [PATCH 03/59] Replace some `listOf`s with `emptyList`s

---
 .../src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt   | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
index 983b7a2..46f5419 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
@@ -182,7 +182,7 @@ fun getColumnByPropertyNameMap(
 fun <Data : Any> getDefaultClassColumnMappings(
     clazz: KClass<Data>,
     columnByPropertyNameMap: Map<String, Column<*>>,
-    customMappings: PropertyColumnMappings<Data> = listOf()
+    customMappings: PropertyColumnMappings<Data> = emptyList()
 ): ClassColumnMappings<Data> {
     val customMappingProperties = customMappings.asSequence().map { it.property }.toSet()
     val dataMemberPropertyMap =
@@ -211,7 +211,7 @@ fun <Data : Any> getDefaultClassColumnMappings(
 fun <Data : Any> getDefaultClassColumnMappings(
     clazz: KClass<Data>,
     tables: List<Table>,
-    customMappings: PropertyColumnMappings<Data> = listOf(),
+    customMappings: PropertyColumnMappings<Data> = emptyList(),
     onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST
 ): ClassColumnMappings<Data> =
     getDefaultClassColumnMappings(
@@ -297,7 +297,7 @@ fun ClassColumnMappings<*>.getNeededColumns(): List<Column<*>> =
 
 inline fun <reified Data : Any> reflectionBasedGenericSimpleOrm(
     tables: List<Table>,
-    customMappings: PropertyColumnMappings<Data> = listOf(),
+    customMappings: PropertyColumnMappings<Data> = emptyList(),
     onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST
 ): ReflectionBasedGenericSimpleOrm<Data> {
     val clazz = Data::class

From 1625e2023d5eaca708a9f922dbc29a9139273622 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 14 Oct 2022 21:04:00 +0800
Subject: [PATCH 04/59] Add the `Skip` case for `PropertyColumnMapping`

---
 .../kotlin/com/huanshankeji/exposed/SimpleOrm.kt     | 12 +++++++++---
 1 file changed, 9 insertions(+), 3 deletions(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
index 46f5419..badaf08 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
@@ -126,6 +126,9 @@ sealed class PropertyColumnMapping<Data : Any, PropertyValue>(val property: KPro
         //val nullabilityDependentColumn: Column<*>,
         val nestedMappings: ClassColumnMappings<NestedData & Any>
     ) : PropertyColumnMapping<Data, NestedData>(property)
+
+    class Skip<Data : Any, PropertyValue>(property: KProperty1<Data, PropertyValue>) :
+        PropertyColumnMapping<Data, PropertyValue>(property)
 }
 
 
@@ -250,6 +253,8 @@ fun <Data : Any> constructDataWithResultRow(
                     it.nestedMappings as ClassColumnMappings<Any>,
                     resultRow
                 )
+
+            is Skip -> null
         }
     }.toTypedArray())
 
@@ -271,6 +276,8 @@ fun <Data : Any> setUpdateBuilder(
                 }
                     ?: setUpdateBuilderToNulls(nestedMappings, updateBuilder)
             }
+
+            is Skip -> {}
         }
 }
 
@@ -278,9 +285,8 @@ fun ClassColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
     for (propertyColumnMapping in this)
         when (propertyColumnMapping) {
             is ExposedSqlPrimitive -> block(propertyColumnMapping.column)
-            is NestedClass -> {
-                propertyColumnMapping.nestedMappings.forEachColumn(block)
-            }
+            is NestedClass -> propertyColumnMapping.nestedMappings.forEachColumn(block)
+            is Skip -> {}
         }
 }
 

From b64ca0133e0deb3381ed01b77eaa7e985569eba3 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Sun, 16 Oct 2022 02:33:12 +0800
Subject: [PATCH 05/59] Replace `UpdateBuilder<Number>` with `UpdateBuilder<*>`

---
 .../main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt  | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
index badaf08..92318e8 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
@@ -19,7 +19,7 @@ import kotlin.reflect.full.withNullability
 
 interface SimpleOrm<Data : Any, TableT : Table> {
     fun resultRowToData(resultRow: ResultRow): Data
-    fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<Number>) -> Unit
+    fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<*>) -> Unit
 }
 
 fun ResultRow.getValue(column: Column<*>): Any? =
@@ -36,7 +36,7 @@ interface ReflectionBasedSimpleOrm<Data : Any, TableT : Table> : SimpleOrm<Data,
         return dataPrimaryConstructor.call(*params.toTypedArray())
     }
 
-    override fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<Number>) -> Unit = {
+    override fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<*>) -> Unit = {
         for ((property, column) in propertyAndColumnPairs)
             @Suppress("UNCHECKED_CAST")
             it[column as Column<Any?>] = property(data)
@@ -234,7 +234,7 @@ class ReflectionBasedGenericSimpleOrm<Data : Any>(
     override fun resultRowToData(resultRow: ResultRow): Data =
         constructDataWithResultRow(clazz, classColumnMappings, resultRow)
 
-    override fun updateBuilderSetter(data: Data): Table.(UpdateBuilder<Number>) -> Unit = {
+    override fun updateBuilderSetter(data: Data): Table.(UpdateBuilder<*>) -> Unit = {
         setUpdateBuilder(classColumnMappings, data, it)
     }
 }
@@ -259,7 +259,7 @@ fun <Data : Any> constructDataWithResultRow(
     }.toTypedArray())
 
 fun <Data : Any> setUpdateBuilder(
-    classColumnMappings: ClassColumnMappings<Data>, data: Data, updateBuilder: UpdateBuilder<Number>
+    classColumnMappings: ClassColumnMappings<Data>, data: Data, updateBuilder: UpdateBuilder<*>
 ) {
     for (propertyColumnMapping in classColumnMappings)
         when (propertyColumnMapping) {
@@ -291,7 +291,7 @@ fun ClassColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
 }
 
 fun <Data : Any> setUpdateBuilderToNulls(
-    classColumnMappings: ClassColumnMappings<Data>, updateBuilder: UpdateBuilder<Number>
+    classColumnMappings: ClassColumnMappings<Data>, updateBuilder: UpdateBuilder<*>
 ) =
     classColumnMappings.forEachColumn {
         @Suppress("UNCHECKED_CAST")

From 24a83924a78d72210695b7f090006bbd819cec64 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Mon, 17 Oct 2022 17:54:18 +0800
Subject: [PATCH 06/59] Move `SimpleOrm` into the `classmapping` package

---
 .../huanshankeji/exposed/{ => classmapping}/SimpleOrm.kt    | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)
 rename exposed/src/main/kotlin/com/huanshankeji/exposed/{ => classmapping}/SimpleOrm.kt (98%)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classmapping/SimpleOrm.kt
similarity index 98%
rename from exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
rename to exposed/src/main/kotlin/com/huanshankeji/exposed/classmapping/SimpleOrm.kt
index 92318e8..135e4f2 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/SimpleOrm.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classmapping/SimpleOrm.kt
@@ -1,7 +1,7 @@
-package com.huanshankeji.exposed
+package com.huanshankeji.exposed.classmapping
 
-import com.huanshankeji.exposed.OnDuplicateColumnPropertyNames.*
-import com.huanshankeji.exposed.PropertyColumnMapping.*
+import com.huanshankeji.exposed.classmapping.OnDuplicateColumnPropertyNames.*
+import com.huanshankeji.exposed.classmapping.PropertyColumnMapping.*
 import org.jetbrains.exposed.dao.id.EntityID
 import org.jetbrains.exposed.sql.Alias
 import org.jetbrains.exposed.sql.Column

From f95d35fb597e1567f33fff65073883a8a2f5d53a Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Mon, 17 Oct 2022 18:01:17 +0800
Subject: [PATCH 07/59] Rename `SimpleOrm` to `ClassPropertyMapping` and
 `ClassPropertyMapper`

---
 .../ClassPropertyMapping.kt}                  | 41 ++++++++++---------
 1 file changed, 21 insertions(+), 20 deletions(-)
 rename exposed/src/main/kotlin/com/huanshankeji/exposed/{classmapping/SimpleOrm.kt => classpropertymapping/ClassPropertyMapping.kt} (88%)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classmapping/SimpleOrm.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
similarity index 88%
rename from exposed/src/main/kotlin/com/huanshankeji/exposed/classmapping/SimpleOrm.kt
rename to exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
index 135e4f2..1e75d32 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classmapping/SimpleOrm.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
@@ -1,7 +1,7 @@
-package com.huanshankeji.exposed.classmapping
+package com.huanshankeji.exposed.classpropertymapping
 
-import com.huanshankeji.exposed.classmapping.OnDuplicateColumnPropertyNames.*
-import com.huanshankeji.exposed.classmapping.PropertyColumnMapping.*
+import com.huanshankeji.exposed.classpropertymapping.OnDuplicateColumnPropertyNames.*
+import com.huanshankeji.exposed.classpropertymapping.PropertyColumnMapping.*
 import org.jetbrains.exposed.dao.id.EntityID
 import org.jetbrains.exposed.sql.Alias
 import org.jetbrains.exposed.sql.Column
@@ -14,10 +14,10 @@ import kotlin.reflect.full.memberProperties
 import kotlin.reflect.full.primaryConstructor
 import kotlin.reflect.full.withNullability
 
-// Our own simple ORM implementation using reflection which should be adapted using annotation processors and code generation in the future.
+// Our own class mapping implementation using reflection which should be adapted using annotation processors and code generation in the future.
 
 
-interface SimpleOrm<Data : Any, TableT : Table> {
+interface ClassPropertyMapper<Data : Any, TableT : Table> {
     fun resultRowToData(resultRow: ResultRow): Data
     fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<*>) -> Unit
 }
@@ -27,7 +27,7 @@ fun ResultRow.getValue(column: Column<*>): Any? =
         if (it is EntityID<*>) it.value else it
     }
 
-interface ReflectionBasedSimpleOrm<Data : Any, TableT : Table> : SimpleOrm<Data, TableT> {
+interface ReflectionBasedClassPropertyMapper<Data : Any, TableT : Table> : ClassPropertyMapper<Data, TableT> {
     val propertyAndColumnPairs: List<Pair<KProperty1<Data, *>, Column<*>>>
     val dataPrimaryConstructor: KFunction<Data>
 
@@ -43,8 +43,8 @@ interface ReflectionBasedSimpleOrm<Data : Any, TableT : Table> : SimpleOrm<Data,
     }
 }
 
-inline fun <reified Data : Any, reified TableT : Table> reflectionBasedSimpleOrm(table: TableT): ReflectionBasedSimpleOrm<Data, TableT> =
-    object : ReflectionBasedSimpleOrm<Data, TableT> {
+inline fun <reified Data : Any, reified TableT : Table> reflectionBasedClassPropertyMapper(table: TableT): ReflectionBasedClassPropertyMapper<Data, TableT> =
+    object : ReflectionBasedClassPropertyMapper<Data, TableT> {
         private val clazz = Data::class
         override val propertyAndColumnPairs = run {
             //require(dClass.isData)
@@ -71,12 +71,13 @@ inline fun <reified TableT : Table> getColumnByPropertyNameMapWithTypeParameter(
     getColumnPropertyByNameMap(TableT::class)
         .mapValues { it.value(table) }
 
-inline fun <reified D : Any, reified T : Table> reflectionBasedSimpleOrmForAlias(
-    tableOrm: ReflectionBasedSimpleOrm<D, T>, alias: Alias<T>
-): ReflectionBasedSimpleOrm<D, T> =
-    object : ReflectionBasedSimpleOrm<D, T> {
-        override val dataPrimaryConstructor = tableOrm.dataPrimaryConstructor
-        override val propertyAndColumnPairs = tableOrm.propertyAndColumnPairs.map { it.first to alias[it.second] }
+inline fun <reified D : Any, reified T : Table> reflectionBasedClassPropertyMapperForAlias(
+    tableClassPropertyMapper: ReflectionBasedClassPropertyMapper<D, T>, alias: Alias<T>
+): ReflectionBasedClassPropertyMapper<D, T> =
+    object : ReflectionBasedClassPropertyMapper<D, T> {
+        override val dataPrimaryConstructor = tableClassPropertyMapper.dataPrimaryConstructor
+        override val propertyAndColumnPairs =
+            tableClassPropertyMapper.propertyAndColumnPairs.map { it.first to alias[it.second] }
     }
 
 
@@ -221,15 +222,15 @@ fun <Data : Any> getDefaultClassColumnMappings(
         clazz, getColumnByPropertyNameMap(tables, onDuplicateColumnPropertyNames), customMappings
     )
 
-interface GenericSimpleOrm<Data : Any> : SimpleOrm<Data, Table> {
+interface GenericClassPropertyMapper<Data : Any> : ClassPropertyMapper<Data, Table> {
     val neededColumns: List<Column<*>>
 }
 
 /** Supports classes with nested composite class properties and multiple tables */
-class ReflectionBasedGenericSimpleOrm<Data : Any>(
+class ReflectionBasedGenericClassPropertyMapper<Data : Any>(
     val clazz: KClass<Data>,
     val classColumnMappings: ClassColumnMappings<Data>,
-) : GenericSimpleOrm<Data> {
+) : GenericClassPropertyMapper<Data> {
     override val neededColumns = classColumnMappings.getNeededColumns()
     override fun resultRowToData(resultRow: ResultRow): Data =
         constructDataWithResultRow(clazz, classColumnMappings, resultRow)
@@ -301,13 +302,13 @@ fun <Data : Any> setUpdateBuilderToNulls(
 fun ClassColumnMappings<*>.getNeededColumns(): List<Column<*>> =
     buildList { forEachColumn { add(it) } }
 
-inline fun <reified Data : Any> reflectionBasedGenericSimpleOrm(
+inline fun <reified Data : Any> reflectionBasedGenericClassPropertyMapper(
     tables: List<Table>,
     customMappings: PropertyColumnMappings<Data> = emptyList(),
     onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST
-): ReflectionBasedGenericSimpleOrm<Data> {
+): ReflectionBasedGenericClassPropertyMapper<Data> {
     val clazz = Data::class
-    return ReflectionBasedGenericSimpleOrm(
+    return ReflectionBasedGenericClassPropertyMapper(
         clazz, getDefaultClassColumnMappings(clazz, tables, customMappings, onDuplicateColumnPropertyNames)
     )
 }

From 13ec021901e09e08d4fc4246f0aa4cb6465db97e Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Mon, 17 Oct 2022 18:23:15 +0800
Subject: [PATCH 08/59] Rename `ClassPropertyMapper` into
 `SimpleClassPropertyMapper` and `GenericClassPropertyMapper` into
 `ClassPropertyMapper`

---
 .../ClassPropertyMapping.kt                   | 30 ++++++++++---------
 1 file changed, 16 insertions(+), 14 deletions(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
index 1e75d32..0da9c9f 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
@@ -17,7 +17,7 @@ import kotlin.reflect.full.withNullability
 // Our own class mapping implementation using reflection which should be adapted using annotation processors and code generation in the future.
 
 
-interface ClassPropertyMapper<Data : Any, TableT : Table> {
+interface SimpleClassPropertyMapper<Data : Any, TableT : Table> {
     fun resultRowToData(resultRow: ResultRow): Data
     fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<*>) -> Unit
 }
@@ -27,7 +27,9 @@ fun ResultRow.getValue(column: Column<*>): Any? =
         if (it is EntityID<*>) it.value else it
     }
 
-interface ReflectionBasedClassPropertyMapper<Data : Any, TableT : Table> : ClassPropertyMapper<Data, TableT> {
+/** Nested classes are not supported. */
+interface ReflectionBasedSimpleClassPropertyMapper<Data : Any, TableT : Table> :
+    SimpleClassPropertyMapper<Data, TableT> {
     val propertyAndColumnPairs: List<Pair<KProperty1<Data, *>, Column<*>>>
     val dataPrimaryConstructor: KFunction<Data>
 
@@ -43,8 +45,8 @@ interface ReflectionBasedClassPropertyMapper<Data : Any, TableT : Table> : Class
     }
 }
 
-inline fun <reified Data : Any, reified TableT : Table> reflectionBasedClassPropertyMapper(table: TableT): ReflectionBasedClassPropertyMapper<Data, TableT> =
-    object : ReflectionBasedClassPropertyMapper<Data, TableT> {
+inline fun <reified Data : Any, reified TableT : Table> reflectionBasedSimpleClassPropertyMapper(table: TableT): ReflectionBasedSimpleClassPropertyMapper<Data, TableT> =
+    object : ReflectionBasedSimpleClassPropertyMapper<Data, TableT> {
         private val clazz = Data::class
         override val propertyAndColumnPairs = run {
             //require(dClass.isData)
@@ -71,10 +73,10 @@ inline fun <reified TableT : Table> getColumnByPropertyNameMapWithTypeParameter(
     getColumnPropertyByNameMap(TableT::class)
         .mapValues { it.value(table) }
 
-inline fun <reified D : Any, reified T : Table> reflectionBasedClassPropertyMapperForAlias(
-    tableClassPropertyMapper: ReflectionBasedClassPropertyMapper<D, T>, alias: Alias<T>
-): ReflectionBasedClassPropertyMapper<D, T> =
-    object : ReflectionBasedClassPropertyMapper<D, T> {
+inline fun <reified D : Any, reified T : Table> reflectionBasedSimpleClassPropertyMapperForAlias(
+    tableClassPropertyMapper: ReflectionBasedSimpleClassPropertyMapper<D, T>, alias: Alias<T>
+): ReflectionBasedSimpleClassPropertyMapper<D, T> =
+    object : ReflectionBasedSimpleClassPropertyMapper<D, T> {
         override val dataPrimaryConstructor = tableClassPropertyMapper.dataPrimaryConstructor
         override val propertyAndColumnPairs =
             tableClassPropertyMapper.propertyAndColumnPairs.map { it.first to alias[it.second] }
@@ -222,15 +224,15 @@ fun <Data : Any> getDefaultClassColumnMappings(
         clazz, getColumnByPropertyNameMap(tables, onDuplicateColumnPropertyNames), customMappings
     )
 
-interface GenericClassPropertyMapper<Data : Any> : ClassPropertyMapper<Data, Table> {
+interface ClassPropertyMapper<Data : Any> : SimpleClassPropertyMapper<Data, Table> {
     val neededColumns: List<Column<*>>
 }
 
 /** Supports classes with nested composite class properties and multiple tables */
-class ReflectionBasedGenericClassPropertyMapper<Data : Any>(
+class ReflectionBasedClassPropertyMapper<Data : Any>(
     val clazz: KClass<Data>,
     val classColumnMappings: ClassColumnMappings<Data>,
-) : GenericClassPropertyMapper<Data> {
+) : ClassPropertyMapper<Data> {
     override val neededColumns = classColumnMappings.getNeededColumns()
     override fun resultRowToData(resultRow: ResultRow): Data =
         constructDataWithResultRow(clazz, classColumnMappings, resultRow)
@@ -302,13 +304,13 @@ fun <Data : Any> setUpdateBuilderToNulls(
 fun ClassColumnMappings<*>.getNeededColumns(): List<Column<*>> =
     buildList { forEachColumn { add(it) } }
 
-inline fun <reified Data : Any> reflectionBasedGenericClassPropertyMapper(
+inline fun <reified Data : Any> reflectionBasedClassPropertyMapper(
     tables: List<Table>,
     customMappings: PropertyColumnMappings<Data> = emptyList(),
     onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST
-): ReflectionBasedGenericClassPropertyMapper<Data> {
+): ReflectionBasedClassPropertyMapper<Data> {
     val clazz = Data::class
-    return ReflectionBasedGenericClassPropertyMapper(
+    return ReflectionBasedClassPropertyMapper(
         clazz, getDefaultClassColumnMappings(clazz, tables, customMappings, onDuplicateColumnPropertyNames)
     )
 }

From aa2dd26794c0160033e33f6945f6cade7834226b Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Mon, 17 Oct 2022 18:26:01 +0800
Subject: [PATCH 09/59] Move code related to `SimpleClassPropertyMapper` into a
 separate file

---
 .../ClassPropertyMapping.kt                   |  98 ----------------
 .../SimpleClassPropertyMapping.kt             | 108 ++++++++++++++++++
 2 files changed, 108 insertions(+), 98 deletions(-)
 create mode 100644 exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
index 0da9c9f..9885c2b 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
@@ -2,8 +2,6 @@ package com.huanshankeji.exposed.classpropertymapping
 
 import com.huanshankeji.exposed.classpropertymapping.OnDuplicateColumnPropertyNames.*
 import com.huanshankeji.exposed.classpropertymapping.PropertyColumnMapping.*
-import org.jetbrains.exposed.dao.id.EntityID
-import org.jetbrains.exposed.sql.Alias
 import org.jetbrains.exposed.sql.Column
 import org.jetbrains.exposed.sql.ResultRow
 import org.jetbrains.exposed.sql.Table
@@ -17,102 +15,6 @@ import kotlin.reflect.full.withNullability
 // Our own class mapping implementation using reflection which should be adapted using annotation processors and code generation in the future.
 
 
-interface SimpleClassPropertyMapper<Data : Any, TableT : Table> {
-    fun resultRowToData(resultRow: ResultRow): Data
-    fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<*>) -> Unit
-}
-
-fun ResultRow.getValue(column: Column<*>): Any? =
-    this[column].let {
-        if (it is EntityID<*>) it.value else it
-    }
-
-/** Nested classes are not supported. */
-interface ReflectionBasedSimpleClassPropertyMapper<Data : Any, TableT : Table> :
-    SimpleClassPropertyMapper<Data, TableT> {
-    val propertyAndColumnPairs: List<Pair<KProperty1<Data, *>, Column<*>>>
-    val dataPrimaryConstructor: KFunction<Data>
-
-    override fun resultRowToData(resultRow: ResultRow): Data {
-        val params = propertyAndColumnPairs.map { (_, column) -> resultRow.getValue(column) }
-        return dataPrimaryConstructor.call(*params.toTypedArray())
-    }
-
-    override fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<*>) -> Unit = {
-        for ((property, column) in propertyAndColumnPairs)
-            @Suppress("UNCHECKED_CAST")
-            it[column as Column<Any?>] = property(data)
-    }
-}
-
-inline fun <reified Data : Any, reified TableT : Table> reflectionBasedSimpleClassPropertyMapper(table: TableT): ReflectionBasedSimpleClassPropertyMapper<Data, TableT> =
-    object : ReflectionBasedSimpleClassPropertyMapper<Data, TableT> {
-        private val clazz = Data::class
-        override val propertyAndColumnPairs = run {
-            //require(dClass.isData)
-            val dataMemberPropertyMap = clazz.memberProperties.associateBy { it.name }
-            val columnMap = getColumnByPropertyNameMapWithTypeParameter(table)
-            dataPrimaryConstructor.parameters.map {
-                val name = it.name!!
-                dataMemberPropertyMap.getValue(name) to columnMap.getValue(name)
-            }
-        }
-        override val dataPrimaryConstructor = clazz.primaryConstructor!!
-    }
-
-@Suppress("UNCHECKED_CAST")
-fun <TableT : Table> getColumnProperties(clazz: KClass<TableT>): Sequence<KProperty1<TableT, Column<*>>> =
-    clazz.memberProperties.asSequence()
-        .filter { it.returnType.classifier == Column::class }
-            as Sequence<KProperty1<TableT, Column<*>>>
-
-fun <TableT : Table> getColumnPropertyByNameMap(clazz: KClass<TableT>): Map<String, KProperty1<TableT, Column<*>>> =
-    getColumnProperties(clazz).associateBy { it.name }
-
-inline fun <reified TableT : Table> getColumnByPropertyNameMapWithTypeParameter(table: TableT): Map<String, Column<*>> =
-    getColumnPropertyByNameMap(TableT::class)
-        .mapValues { it.value(table) }
-
-inline fun <reified D : Any, reified T : Table> reflectionBasedSimpleClassPropertyMapperForAlias(
-    tableClassPropertyMapper: ReflectionBasedSimpleClassPropertyMapper<D, T>, alias: Alias<T>
-): ReflectionBasedSimpleClassPropertyMapper<D, T> =
-    object : ReflectionBasedSimpleClassPropertyMapper<D, T> {
-        override val dataPrimaryConstructor = tableClassPropertyMapper.dataPrimaryConstructor
-        override val propertyAndColumnPairs =
-            tableClassPropertyMapper.propertyAndColumnPairs.map { it.first to alias[it.second] }
-    }
-
-
-inline fun <D1 : Any, D2 : Any> innerJoinResultRowToData(
-    crossinline resultRowToData1: (ResultRow) -> D1, crossinline resultRowToData2: (ResultRow) -> D2
-): (ResultRow) -> Pair<D1, D2> = {
-    resultRowToData1(it) to resultRowToData2(it)
-}
-
-inline fun <D1 : Any, D2 : Any> leftJoinResultRowToData(
-    crossinline resultRowToData1: (ResultRow) -> D1, crossinline resultRowToData2: (ResultRow) -> D2,
-    onColumn: Column<*>
-): (ResultRow) -> Pair<D1, D2?> = {
-    // `it.hasValue` returns true here but the value is `null`
-    resultRowToData1(it) to if (it[onColumn] !== null) resultRowToData2(it) else null
-}
-
-inline fun <D1 : Any, D2 : Any, D3 : Any> leftJoinResultRowToData(
-    crossinline resultRowToData1: (ResultRow) -> D1,
-    crossinline resultRowToData2: (ResultRow) -> D2,
-    crossinline resultRowToData3: (ResultRow) -> D3,
-    onColumn2: Column<*>,
-    onColumn3: Column<*>
-): (ResultRow) -> Triple<D1, D2?, D3?> = {
-    // `it.hasValue` returns `true` here but the value is `null`
-    Triple(
-        resultRowToData1(it),
-        if (it[onColumn2] !== null) resultRowToData2(it) else null,
-        if (it[onColumn3] !== null) resultRowToData3(it) else null
-    )
-}
-
-
 typealias PropertyColumnMappings<Data> = List<PropertyColumnMapping<Data, *>>
 //typealias LessStrictlyTypedPropertyColumnMappings<Data> = List<PropertyColumnMapping<Data, Any?>>
 /** In the order of the constructor arguments. */
diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
new file mode 100644
index 0000000..2560f16
--- /dev/null
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
@@ -0,0 +1,108 @@
+package com.huanshankeji.exposed.classpropertymapping
+
+import org.jetbrains.exposed.dao.id.EntityID
+import org.jetbrains.exposed.sql.Alias
+import org.jetbrains.exposed.sql.Column
+import org.jetbrains.exposed.sql.ResultRow
+import org.jetbrains.exposed.sql.Table
+import org.jetbrains.exposed.sql.statements.UpdateBuilder
+import kotlin.reflect.KClass
+import kotlin.reflect.KFunction
+import kotlin.reflect.KProperty1
+import kotlin.reflect.full.memberProperties
+import kotlin.reflect.full.primaryConstructor
+
+interface SimpleClassPropertyMapper<Data : Any, TableT : Table> {
+    fun resultRowToData(resultRow: ResultRow): Data
+    fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<*>) -> Unit
+}
+
+fun ResultRow.getValue(column: Column<*>): Any? =
+    this[column].let {
+        if (it is EntityID<*>) it.value else it
+    }
+
+/** Nested classes are not supported. */
+interface ReflectionBasedSimpleClassPropertyMapper<Data : Any, TableT : Table> :
+    SimpleClassPropertyMapper<Data, TableT> {
+    val propertyAndColumnPairs: List<Pair<KProperty1<Data, *>, Column<*>>>
+    val dataPrimaryConstructor: KFunction<Data>
+
+    override fun resultRowToData(resultRow: ResultRow): Data {
+        val params = propertyAndColumnPairs.map { (_, column) -> resultRow.getValue(column) }
+        return dataPrimaryConstructor.call(*params.toTypedArray())
+    }
+
+    override fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<*>) -> Unit = {
+        for ((property, column) in propertyAndColumnPairs)
+            @Suppress("UNCHECKED_CAST")
+            it[column as Column<Any?>] = property(data)
+    }
+}
+
+inline fun <reified Data : Any, reified TableT : Table> reflectionBasedSimpleClassPropertyMapper(table: TableT): ReflectionBasedSimpleClassPropertyMapper<Data, TableT> =
+    object : ReflectionBasedSimpleClassPropertyMapper<Data, TableT> {
+        private val clazz = Data::class
+        override val propertyAndColumnPairs = run {
+            //require(dClass.isData)
+            val dataMemberPropertyMap = clazz.memberProperties.associateBy { it.name }
+            val columnMap = getColumnByPropertyNameMapWithTypeParameter(table)
+            dataPrimaryConstructor.parameters.map {
+                val name = it.name!!
+                dataMemberPropertyMap.getValue(name) to columnMap.getValue(name)
+            }
+        }
+        override val dataPrimaryConstructor = clazz.primaryConstructor!!
+    }
+
+@Suppress("UNCHECKED_CAST")
+fun <TableT : Table> getColumnProperties(clazz: KClass<TableT>): Sequence<KProperty1<TableT, Column<*>>> =
+    clazz.memberProperties.asSequence()
+        .filter { it.returnType.classifier == Column::class }
+            as Sequence<KProperty1<TableT, Column<*>>>
+
+fun <TableT : Table> getColumnPropertyByNameMap(clazz: KClass<TableT>): Map<String, KProperty1<TableT, Column<*>>> =
+    getColumnProperties(clazz).associateBy { it.name }
+
+inline fun <reified TableT : Table> getColumnByPropertyNameMapWithTypeParameter(table: TableT): Map<String, Column<*>> =
+    getColumnPropertyByNameMap(TableT::class)
+        .mapValues { it.value(table) }
+
+inline fun <reified D : Any, reified T : Table> reflectionBasedSimpleClassPropertyMapperForAlias(
+    tableClassPropertyMapper: ReflectionBasedSimpleClassPropertyMapper<D, T>, alias: Alias<T>
+): ReflectionBasedSimpleClassPropertyMapper<D, T> =
+    object : ReflectionBasedSimpleClassPropertyMapper<D, T> {
+        override val dataPrimaryConstructor = tableClassPropertyMapper.dataPrimaryConstructor
+        override val propertyAndColumnPairs =
+            tableClassPropertyMapper.propertyAndColumnPairs.map { it.first to alias[it.second] }
+    }
+
+
+inline fun <D1 : Any, D2 : Any> innerJoinResultRowToData(
+    crossinline resultRowToData1: (ResultRow) -> D1, crossinline resultRowToData2: (ResultRow) -> D2
+): (ResultRow) -> Pair<D1, D2> = {
+    resultRowToData1(it) to resultRowToData2(it)
+}
+
+inline fun <D1 : Any, D2 : Any> leftJoinResultRowToData(
+    crossinline resultRowToData1: (ResultRow) -> D1, crossinline resultRowToData2: (ResultRow) -> D2,
+    onColumn: Column<*>
+): (ResultRow) -> Pair<D1, D2?> = {
+    // `it.hasValue` returns true here but the value is `null`
+    resultRowToData1(it) to if (it[onColumn] !== null) resultRowToData2(it) else null
+}
+
+inline fun <D1 : Any, D2 : Any, D3 : Any> leftJoinResultRowToData(
+    crossinline resultRowToData1: (ResultRow) -> D1,
+    crossinline resultRowToData2: (ResultRow) -> D2,
+    crossinline resultRowToData3: (ResultRow) -> D3,
+    onColumn2: Column<*>,
+    onColumn3: Column<*>
+): (ResultRow) -> Triple<D1, D2?, D3?> = {
+    // `it.hasValue` returns `true` here but the value is `null`
+    Triple(
+        resultRowToData1(it),
+        if (it[onColumn2] !== null) resultRowToData2(it) else null,
+        if (it[onColumn3] !== null) resultRowToData3(it) else null
+    )
+}

From ffb69e3f27faca54dee247076f6989534f0abd1c Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Mon, 17 Oct 2022 18:59:00 +0800
Subject: [PATCH 10/59] Rename `ClassColumnMappings` to
 `ClassPropertyColumnMappings`

---
 .../ClassPropertyMapping.kt                   | 36 +++++++++----------
 1 file changed, 18 insertions(+), 18 deletions(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
index 9885c2b..f36bc4d 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
@@ -18,7 +18,7 @@ import kotlin.reflect.full.withNullability
 typealias PropertyColumnMappings<Data> = List<PropertyColumnMapping<Data, *>>
 //typealias LessStrictlyTypedPropertyColumnMappings<Data> = List<PropertyColumnMapping<Data, Any?>>
 /** In the order of the constructor arguments. */
-typealias ClassColumnMappings<Data> = PropertyColumnMappings<Data>
+typealias ClassPropertyColumnMappings<Data> = PropertyColumnMappings<Data>
 
 sealed class PropertyColumnMapping<Data : Any, PropertyValue>(val property: KProperty1<Data, PropertyValue>) {
     class ExposedSqlPrimitive<Data : Any, PrimitiveValue>(
@@ -29,7 +29,7 @@ sealed class PropertyColumnMapping<Data : Any, PropertyValue>(val property: KPro
     class NestedClass<Data : Any, NestedData>(
         property: KProperty1<Data, NestedData>,
         //val nullabilityDependentColumn: Column<*>,
-        val nestedMappings: ClassColumnMappings<NestedData & Any>
+        val nestedMappings: ClassPropertyColumnMappings<NestedData & Any>
     ) : PropertyColumnMapping<Data, NestedData>(property)
 
     class Skip<Data : Any, PropertyValue>(property: KProperty1<Data, PropertyValue>) :
@@ -91,7 +91,7 @@ fun <Data : Any> getDefaultClassColumnMappings(
     clazz: KClass<Data>,
     columnByPropertyNameMap: Map<String, Column<*>>,
     customMappings: PropertyColumnMappings<Data> = emptyList()
-): ClassColumnMappings<Data> {
+): ClassPropertyColumnMappings<Data> {
     val customMappingProperties = customMappings.asSequence().map { it.property }.toSet()
     val dataMemberPropertyMap =
         (clazz.memberProperties.toSet() - customMappingProperties).associateBy { it.name }
@@ -111,7 +111,7 @@ fun <Data : Any> getDefaultClassColumnMappings(
                 property as KProperty1<Data, Any?>,
                 getDefaultClassColumnMappings(
                     notNullType.classifier as KClass<*>, columnByPropertyNameMap
-                ) as ClassColumnMappings<Any>
+                ) as ClassPropertyColumnMappings<Any>
             )
     }
 }
@@ -121,7 +121,7 @@ fun <Data : Any> getDefaultClassColumnMappings(
     tables: List<Table>,
     customMappings: PropertyColumnMappings<Data> = emptyList(),
     onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST
-): ClassColumnMappings<Data> =
+): ClassPropertyColumnMappings<Data> =
     getDefaultClassColumnMappings(
         clazz, getColumnByPropertyNameMap(tables, onDuplicateColumnPropertyNames), customMappings
     )
@@ -133,21 +133,21 @@ interface ClassPropertyMapper<Data : Any> : SimpleClassPropertyMapper<Data, Tabl
 /** Supports classes with nested composite class properties and multiple tables */
 class ReflectionBasedClassPropertyMapper<Data : Any>(
     val clazz: KClass<Data>,
-    val classColumnMappings: ClassColumnMappings<Data>,
+    val classPropertyColumnMappings: ClassPropertyColumnMappings<Data>,
 ) : ClassPropertyMapper<Data> {
-    override val neededColumns = classColumnMappings.getNeededColumns()
+    override val neededColumns = classPropertyColumnMappings.getNeededColumns()
     override fun resultRowToData(resultRow: ResultRow): Data =
-        constructDataWithResultRow(clazz, classColumnMappings, resultRow)
+        constructDataWithResultRow(clazz, classPropertyColumnMappings, resultRow)
 
     override fun updateBuilderSetter(data: Data): Table.(UpdateBuilder<*>) -> Unit = {
-        setUpdateBuilder(classColumnMappings, data, it)
+        setUpdateBuilder(classPropertyColumnMappings, data, it)
     }
 }
 
 fun <Data : Any> constructDataWithResultRow(
-    clazz: KClass<Data>, classColumnMappings: ClassColumnMappings<Data>, resultRow: ResultRow
+    clazz: KClass<Data>, classPropertyColumnMappings: ClassPropertyColumnMappings<Data>, resultRow: ResultRow
 ): Data =
-    clazz.primaryConstructor!!.call(*classColumnMappings.map {
+    clazz.primaryConstructor!!.call(*classPropertyColumnMappings.map {
         when (it) {
             is ExposedSqlPrimitive -> resultRow.getValue(it.column)
             is NestedClass ->
@@ -155,7 +155,7 @@ fun <Data : Any> constructDataWithResultRow(
                 @Suppress("UNCHECKED_CAST")
                 constructDataWithResultRow(
                     it.property.returnType.classifier as KClass<Any>,
-                    it.nestedMappings as ClassColumnMappings<Any>,
+                    it.nestedMappings as ClassPropertyColumnMappings<Any>,
                     resultRow
                 )
 
@@ -164,9 +164,9 @@ fun <Data : Any> constructDataWithResultRow(
     }.toTypedArray())
 
 fun <Data : Any> setUpdateBuilder(
-    classColumnMappings: ClassColumnMappings<Data>, data: Data, updateBuilder: UpdateBuilder<*>
+    classPropertyColumnMappings: ClassPropertyColumnMappings<Data>, data: Data, updateBuilder: UpdateBuilder<*>
 ) {
-    for (propertyColumnMapping in classColumnMappings)
+    for (propertyColumnMapping in classPropertyColumnMappings)
         when (propertyColumnMapping) {
             is ExposedSqlPrimitive ->
                 @Suppress("UNCHECKED_CAST")
@@ -186,7 +186,7 @@ fun <Data : Any> setUpdateBuilder(
         }
 }
 
-fun ClassColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
+fun ClassPropertyColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
     for (propertyColumnMapping in this)
         when (propertyColumnMapping) {
             is ExposedSqlPrimitive -> block(propertyColumnMapping.column)
@@ -196,14 +196,14 @@ fun ClassColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
 }
 
 fun <Data : Any> setUpdateBuilderToNulls(
-    classColumnMappings: ClassColumnMappings<Data>, updateBuilder: UpdateBuilder<*>
+    classPropertyColumnMappings: ClassPropertyColumnMappings<Data>, updateBuilder: UpdateBuilder<*>
 ) =
-    classColumnMappings.forEachColumn {
+    classPropertyColumnMappings.forEachColumn {
         @Suppress("UNCHECKED_CAST")
         updateBuilder[it as Column<Any?>] = null
     }
 
-fun ClassColumnMappings<*>.getNeededColumns(): List<Column<*>> =
+fun ClassPropertyColumnMappings<*>.getNeededColumns(): List<Column<*>> =
     buildList { forEachColumn { add(it) } }
 
 inline fun <reified Data : Any> reflectionBasedClassPropertyMapper(

From d25931de68fa0aa09b4188e55199fda33d0f0e2e Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Tue, 18 Oct 2022 18:57:36 +0800
Subject: [PATCH 11/59] Add `insertSelectStatement`

---
 .../kotlin/com/huanshankeji/exposed/Statements.kt     | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/Statements.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/Statements.kt
index 5a9a1cb..651c3bb 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/Statements.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/Statements.kt
@@ -17,6 +17,7 @@ fun Table.deleteWhereStatement(
 ): DeleteStatement =
     DeleteStatement(this, SqlExpressionBuilder.op(), false, limit, offset)
 
+// TODO: is this needed anymore?
 class HelperInsertStatement<Key : Any>(table: Table, isIgnore: Boolean = false) :
     InsertStatement<Key>(table, isIgnore) {
     public override var arguments: List<List<Pair<Column<*>, Any?>>>?
@@ -42,6 +43,16 @@ fun <T : Table> T.insertIgnoreStatement(body: T.(InsertStatement<Number>) -> Uni
         body(this)
     }
 
+/**
+ * Adapted from [org.jetbrains.exposed.sql.insert].
+ */
+fun <T : Table> T.insertSelectStatement(
+    selectQuery: AbstractQuery<*>,
+    columns: List<Column<*>> = this.columns.filter { !it.columnType.isAutoInc || it.autoIncColumnType?.nextValExpression != null },
+    isIgnore: Boolean = false
+): InsertSelectStatement =
+    InsertSelectStatement(columns, selectQuery, isIgnore)
+
 /**
  * Adapted from [org.jetbrains.exposed.sql.update].
  */

From 1e2cc2fb83ace2f9030d48e8d29b0ccc68adb7c1 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Wed, 19 Oct 2022 17:39:59 +0800
Subject: [PATCH 12/59] Fix the newly introduced bug that
 `dataPrimaryConstructor` is initialized after `propertyAndColumnPairs` in
 `reflectionBasedSimpleClassPropertyMapper`

---
 .../classpropertymapping/SimpleClassPropertyMapping.kt        | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
index 2560f16..cc39b1b 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
@@ -43,6 +43,9 @@ interface ReflectionBasedSimpleClassPropertyMapper<Data : Any, TableT : Table> :
 inline fun <reified Data : Any, reified TableT : Table> reflectionBasedSimpleClassPropertyMapper(table: TableT): ReflectionBasedSimpleClassPropertyMapper<Data, TableT> =
     object : ReflectionBasedSimpleClassPropertyMapper<Data, TableT> {
         private val clazz = Data::class
+
+        // This property needs to initialize first.
+        override val dataPrimaryConstructor = clazz.primaryConstructor!!
         override val propertyAndColumnPairs = run {
             //require(dClass.isData)
             val dataMemberPropertyMap = clazz.memberProperties.associateBy { it.name }
@@ -52,7 +55,6 @@ inline fun <reified Data : Any, reified TableT : Table> reflectionBasedSimpleCla
                 dataMemberPropertyMap.getValue(name) to columnMap.getValue(name)
             }
         }
-        override val dataPrimaryConstructor = clazz.primaryConstructor!!
     }
 
 @Suppress("UNCHECKED_CAST")

From 5eb75d0dd171fd4ab3a10e76b6379d91b90726ce Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Thu, 20 Oct 2022 23:09:57 +0800
Subject: [PATCH 13/59] Add a new overloaded
 `reflectionBasedClassPropertyMapper` for a single `Table`

---
 .../exposed/classpropertymapping/ClassPropertyMapping.kt    | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
index f36bc4d..00186c4 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
@@ -216,3 +216,9 @@ inline fun <reified Data : Any> reflectionBasedClassPropertyMapper(
         clazz, getDefaultClassColumnMappings(clazz, tables, customMappings, onDuplicateColumnPropertyNames)
     )
 }
+
+inline fun <reified Data : Any/*, TableT : Table*/> reflectionBasedClassPropertyMapper(
+    table: Table,
+    customMappings: PropertyColumnMappings<Data> = emptyList()
+) =
+    reflectionBasedClassPropertyMapper(listOf(table), customMappings, THROW)

From d5973571eebe416a78b079425b3ec9c65e6e803c Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Thu, 20 Oct 2022 23:30:02 +0800
Subject: [PATCH 14/59] Fix a bug that nullable columns are included when
 filtering `Column` properties in `getColumnProperties`, for example
 `Table.autoIncColumn`

---
 .../exposed/classpropertymapping/SimpleClassPropertyMapping.kt  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
index cc39b1b..ba5f206 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
@@ -60,7 +60,7 @@ inline fun <reified Data : Any, reified TableT : Table> reflectionBasedSimpleCla
 @Suppress("UNCHECKED_CAST")
 fun <TableT : Table> getColumnProperties(clazz: KClass<TableT>): Sequence<KProperty1<TableT, Column<*>>> =
     clazz.memberProperties.asSequence()
-        .filter { it.returnType.classifier == Column::class }
+        .filter { it.returnType.run { classifier == Column::class && !isMarkedNullable } }
             as Sequence<KProperty1<TableT, Column<*>>>
 
 fun <TableT : Table> getColumnPropertyByNameMap(clazz: KClass<TableT>): Map<String, KProperty1<TableT, Column<*>>> =

From 572b4c3992ce335c87f07395461d7b484485e4c3 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Sat, 22 Oct 2022 05:42:06 +0800
Subject: [PATCH 15/59] Resolve a TODO comment

---
 exposed/src/main/kotlin/com/huanshankeji/exposed/Statements.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/Statements.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/Statements.kt
index 651c3bb..eb9ef7e 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/Statements.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/Statements.kt
@@ -17,7 +17,7 @@ fun Table.deleteWhereStatement(
 ): DeleteStatement =
     DeleteStatement(this, SqlExpressionBuilder.op(), false, limit, offset)
 
-// TODO: is this needed anymore?
+// to access the protected `arguments` in the super class
 class HelperInsertStatement<Key : Any>(table: Table, isIgnore: Boolean = false) :
     InsertStatement<Key>(table, isIgnore) {
     public override var arguments: List<List<Pair<Column<*>, Any?>>>?

From 2f84363eae1a1900f88d0696e8e9cde0f55b752f Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 28 Oct 2022 02:55:58 +0800
Subject: [PATCH 16/59] Support nullability and algebraic types (mainly sum
 types, aka sealed and abstract classes) in properties in
 `ClassPropertyMapping.kt`

The changes have not been tested yet.

Some other related changes:
1. Fix a not revealed potential bug that the `customMappings` argument is not used
1. Split the `ClassPropertyMapper` interface and related interfaces into 2 kinds respectively related to query and update.
1. Use `KClass` to judge whether a type is a SQL primitive type instead of `KType` for better performance.
---
 .../main/kotlin/VersionsAndDependencies.kt    |   7 +
 exposed/build.gradle.kts                      |   2 +
 .../ClassPropertyMapping.kt                   | 472 +++++++++++++++---
 .../SimpleClassPropertyMapping.kt             |  24 +-
 4 files changed, 415 insertions(+), 90 deletions(-)

diff --git a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
index 49b2c3a..e752ac5 100644
--- a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
+++ b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
@@ -7,3 +7,10 @@ val projectVersion = "0.3.0-SNAPSHOT"
 val commonVersions = CommonVersions()
 val commonDependencies = CommonDependencies(commonVersions)
 val commonGradleClasspathDependencies = CommonGradleClasspathDependencies(commonVersions)
+
+// TODO: remove
+/*
+object DependencyVersions {
+    const val guava = "31.1-jre"
+}
+*/
diff --git a/exposed/build.gradle.kts b/exposed/build.gradle.kts
index f471d4b..7e72836 100644
--- a/exposed/build.gradle.kts
+++ b/exposed/build.gradle.kts
@@ -4,4 +4,6 @@ plugins {
 
 dependencies {
     implementation(commonDependencies.exposed.core())
+    // TODO: remove
+    //implementation("com.google.guava:guava:${DependencyVersions.guava}")
 }
diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
index 00186c4..5491b92 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
@@ -2,15 +2,12 @@ package com.huanshankeji.exposed.classpropertymapping
 
 import com.huanshankeji.exposed.classpropertymapping.OnDuplicateColumnPropertyNames.*
 import com.huanshankeji.exposed.classpropertymapping.PropertyColumnMapping.*
-import org.jetbrains.exposed.sql.Column
-import org.jetbrains.exposed.sql.ResultRow
-import org.jetbrains.exposed.sql.Table
+import org.jetbrains.exposed.sql.*
 import org.jetbrains.exposed.sql.statements.UpdateBuilder
+import org.slf4j.LoggerFactory
 import kotlin.reflect.*
-import kotlin.reflect.full.isSubtypeOf
-import kotlin.reflect.full.memberProperties
-import kotlin.reflect.full.primaryConstructor
-import kotlin.reflect.full.withNullability
+import kotlin.reflect.full.*
+import kotlin.sequences.Sequence
 
 // Our own class mapping implementation using reflection which should be adapted using annotation processors and code generation in the future.
 
@@ -20,39 +17,74 @@ typealias PropertyColumnMappings<Data> = List<PropertyColumnMapping<Data, *>>
 /** In the order of the constructor arguments. */
 typealias ClassPropertyColumnMappings<Data> = PropertyColumnMappings<Data>
 
-sealed class PropertyColumnMapping<Data : Any, PropertyValue>(val property: KProperty1<Data, PropertyValue>) {
+// TODO: decouple/remove `property` and `Data` from this class.
+sealed class PropertyColumnMapping<Data : Any, PropertyData>(val property: KProperty1<Data, PropertyData>) {
+    // TODO: rename all occurrences of "PrimitiveValue" to "PropertyData".
     class ExposedSqlPrimitive<Data : Any, PrimitiveValue>(
         property: KProperty1<Data, PrimitiveValue>,
         val column: Column<PrimitiveValue>
     ) : PropertyColumnMapping<Data, PrimitiveValue>(property)
 
+    // TODO: rename all occurrences of "NestedData" to "PropertyData".
     class NestedClass<Data : Any, NestedData>(
         property: KProperty1<Data, NestedData>,
-        //val nullabilityDependentColumn: Column<*>,
-        val nestedMappings: ClassPropertyColumnMappings<NestedData & Any>
-    ) : PropertyColumnMapping<Data, NestedData>(property)
+        val nullability: Nullability<NestedData>,
+        val adt: Adt<NestedData & Any>
+    ) : PropertyColumnMapping<Data, NestedData>(property) {
+        sealed class Nullability<NestedData> {
+            class NonNullable<NotNullNestedData : Any> : Nullability<NotNullNestedData>()
+            class Nullable<NotNullNestedData : Any>(val nullDependentColumn: Column<*>) :
+                Nullability<NotNullNestedData?>()
+        }
+
+        // ADT: algebraic data type
+        sealed class Adt<NotNullNestedData : Any> {
+            class Product<NotNullNestedData : Any>(val nestedMappings: ClassPropertyColumnMappings<NotNullNestedData>) :
+                Adt<NotNullNestedData>()
+
+            class Sum<NotNullNestedData : Any, CaseValue>(
+                // I first used the Guava BiMap but then realized it's not necessary. TODO: remove this comment
+                val subclassMap: Map<KClass<out NotNullNestedData>, Product<out NotNullNestedData>>,
+                val sumTypeCaseConfig: SumTypeCaseConfig<NotNullNestedData, CaseValue>
+            ) : Adt<NotNullNestedData>()
+        }
+
+    }
 
-    class Skip<Data : Any, PropertyValue>(property: KProperty1<Data, PropertyValue>) :
-        PropertyColumnMapping<Data, PropertyValue>(property)
+    // TODO: remove the temporary workaround `& Any` if and when the `Any` upper bound is removed.
+    class Custom<Data : Any, PropertyData>(
+        property: KProperty1<Data, PropertyData>, val classPropertyMapper: ClassPropertyMapper<PropertyData & Any>
+    ) : PropertyColumnMapping<Data, PropertyData>(property)
+
+    class Skip<Data : Any, PropertyData>(property: KProperty1<Data, PropertyData>) :
+        PropertyColumnMapping<Data, PropertyData>(property)
 }
 
+class SumTypeCaseConfig<Superclass : Any, Case>(
+    val caseValueColumn: Column<Case>,
+    val caseValueToClass: (Case) -> KClass<out Superclass>,
+    val classToCaseValue: (KClass<out Superclass>?) -> Case
+)
+
 
 // see: https://kotlinlang.org/docs/basic-types.html, https://www.postgresql.org/docs/current/datatype.html
 // Types that are commented out are not ensured to work yet.
-val defaultNotNullExposedSqlPrimitiveTypes = listOf(
-    typeOf<Byte>(), typeOf<Short>(), typeOf<Int>(), typeOf<Long>(), /*typeOf<BigInteger>(),*/
-    typeOf<UByte>(), typeOf<UShort>(), typeOf<UInt>(), typeOf<ULong>(),
-    typeOf<Float>(), typeOf<Double>(), /*typeOf<BigDecimal>(),*/
-    typeOf<Boolean>(),
-    typeOf<ByteArray>(),
-    //typeOf<Char>(),
-    typeOf<String>(),
+val defaultNotNullExposedSqlPrimitiveClasses = listOf(
+    Byte::class, Short::class, Int::class, Long::class, /*BigInteger::class,*/
+    UByte::class, UShort::class, UInt::class, ULong::class,
+    Float::class, Double::class, /*BigDecimal::class,*/
+    Boolean::class,
+    ByteArray::class,
+    //Char::class,
+    String::class,
     // types related to time and date
 )
 
-val enumType = typeOf<Enum<*>>()
-fun KType.notNullTypeIsExposedSqlPrimitiveType(): Boolean =
-    this in defaultNotNullExposedSqlPrimitiveTypes || isSubtypeOf(enumType)
+fun KClass<*>.isExposedSqlPrimitiveType(): Boolean =
+    this in defaultNotNullExposedSqlPrimitiveClasses || isSubclassOf(Enum::class)
+
+fun KType.isExposedSqlPrimitiveType() =
+    (classifier as KClass<*>).isExposedSqlPrimitiveType()
 
 class ColumnWithPropertyName(val propertyName: String, val column: Column<*>)
 
@@ -86,50 +118,244 @@ fun getColumnByPropertyNameMap(
     }
 }
 
+val logger = LoggerFactory.getLogger("class property mapping")
+
+/**
+ * @param skip both writing and reading. Note that the property type need not be nullable if it's only used for writing.
+ * @param nullDependentColumn required for nullable properties.
+ */
+class PropertyColumnMappingConfig<P>(
+    type: KType,
+    usedForQuery: Boolean = true,
+    val skip: Boolean = false,
+    val differentColumnPropertyName: String? = null,
+    val nullDependentColumn: Column<*>? = null, // for query
+    val adt: Adt<P & Any>? = null, // for query and update
+) {
+    init {
+        // perform the checks
+
+        if (type.isMarkedNullable) {
+            if (skip && nullDependentColumn !== null || adt !== null)
+                logger.warn("${::nullDependentColumn.name} and ${::adt.name} are unnecessary when ${::skip.name} is configured to true.")
+        } else {
+            // Non-nullable properties can be skipped when updating but not when querying.
+            if (usedForQuery)
+                require(!skip)
+            require(nullDependentColumn === null)
+        }
 
-fun <Data : Any> getDefaultClassColumnMappings(
+
+        if (type.isExposedSqlPrimitiveType() && nullDependentColumn === null && adt === null)
+            logger.warn("${::nullDependentColumn} or ${::adt} is set for a primitive type $type and will be ignored.")
+
+        @Suppress("UNCHECKED_CAST")
+        val clazz = type.classifier as KClass<P & Any>
+        when (adt) {
+            is Adt.Product -> require(!clazz.isAbstract)
+            is Adt.Sum<*, *> -> require(clazz.isOpen)
+            null -> {}
+        }
+    }
+
+    companion object {
+        inline fun <reified PropertyData> create(
+            skip: Boolean = false,
+            usedForQuery: Boolean = true,
+            columnPropertyName: String? = null,
+            nullDependentColumn: Column<*>? = null,
+            adt: Adt<PropertyData & Any>? = null
+        ) =
+            PropertyColumnMappingConfig(
+                typeOf<PropertyData>(), skip, usedForQuery, columnPropertyName, nullDependentColumn, adt
+            )
+    }
+
+    // ADT: algebraic data type
+    sealed class Adt<Data : Any> {
+        class Product<Data : Any>(val nestedConfigMap: PropertyColumnMappingConfigMap<Data>) :
+            Adt<Data>()
+
+        class Sum<Data : Any, CaseValue>(
+            clazz: KClass<Data>,
+            val subclassProductConfigMapOrOverride: Map<KClass<out Data>, Product<out Data>>,
+            val sumTypeCaseConfig: SumTypeCaseConfig<Data, CaseValue>
+        ) : Adt<Data>() {
+            init {
+                require(subclassProductConfigMapOrOverride.keys.all { !it.isAbstract && it.isSubclassOf(clazz) })
+            }
+
+            companion object {
+                inline fun <reified Data : Any, CaseValue> createForSealed(
+                    subclassProductConfigMapOverride: Map<KClass<out Data>, Product<out Data>> = emptyMap(),
+                    sumTypeCaseConfig: SumTypeCaseConfig<Data, CaseValue>
+                ): Sum<Data, CaseValue> {
+                    val clazz = Data::class
+                    require(clazz.isSealed)
+                    return Sum(clazz, subclassProductConfigMapOverride, sumTypeCaseConfig)
+                }
+
+                inline fun <reified Data : Any, CaseValue> createForAbstractNotSealed(
+                    subclassProductConfigMap: Map<KClass<out Data>, Product<out Data>>,
+                    sumTypeCaseConfig: SumTypeCaseConfig<Data, CaseValue>
+                ): Sum<Data, CaseValue> {
+                    val clazz = Data::class
+                    require(clazz.isAbstract && !clazz.isSealed)
+                    return Sum(clazz, subclassProductConfigMap, sumTypeCaseConfig)
+                }
+            }
+        }
+    }
+}
+
+typealias PropertyColumnMappingConfigMap<Data /*: Any*/> = Map<KProperty1<Data, *>, PropertyColumnMappingConfig<*>>
+
+fun <Data : Any> getDefaultClassPropertyColumnMappings(
     clazz: KClass<Data>,
     columnByPropertyNameMap: Map<String, Column<*>>,
+    propertyColumnMappingConfigMapOverride: PropertyColumnMappingConfigMap<Data> = emptyMap(),
     customMappings: PropertyColumnMappings<Data> = emptyList()
 ): ClassPropertyColumnMappings<Data> {
     val customMappingProperties = customMappings.asSequence().map { it.property }.toSet()
     val dataMemberPropertyMap =
         (clazz.memberProperties.toSet() - customMappingProperties).associateBy { it.name }
+    val customMappingMap = customMappings.associateBy { it.property.name }
 
     return clazz.primaryConstructor!!.parameters.map {
         val name = it.name!!
-        val property = dataMemberPropertyMap[name]
-        val notNullType = it.type.withNullability(false)
-        @Suppress("UNCHECKED_CAST")
-        if (notNullType.notNullTypeIsExposedSqlPrimitiveType())
-            ExposedSqlPrimitive(
-                property as KProperty1<Data, Any?>,
-                columnByPropertyNameMap.getValue(name) as Column<Any?>
-            )
-        else
-            NestedClass(
-                property as KProperty1<Data, Any?>,
-                getDefaultClassColumnMappings(
-                    notNullType.classifier as KClass<*>, columnByPropertyNameMap
-                ) as ClassPropertyColumnMappings<Any>
-            )
+
+        val customMapping = customMappingMap[name]
+        if (customMapping !== null)
+            return@map customMapping
+
+        val property = dataMemberPropertyMap.getValue(name)
+        require(it.type == property.returnType)
+
+        // This function is added to introduce a new type parameter `PropertyData` to constrain the types better.
+        fun <PropertyData> typeParameterHelper(property: KProperty1<Data, PropertyData>): PropertyColumnMapping<Data, PropertyData> {
+            val config = propertyColumnMappingConfigMapOverride[property]
+            if (config?.skip == true)
+                return Skip(property)
+
+            val columnPropertyName = config?.differentColumnPropertyName ?: name
+            val type = property.returnType
+
+            @Suppress("UNCHECKED_CAST")
+            val propertyClazz = type.classifier as KClass<*> as KClass<PropertyData & Any>
+            return if (propertyClazz.isExposedSqlPrimitiveType())
+                @Suppress("UNCHECKED_CAST")
+                ExposedSqlPrimitive(
+                    property, columnByPropertyNameMap.getValue(columnPropertyName) as Column<PropertyData>
+                )
+            else {
+                val isNullable = type.isMarkedNullable
+
+                @Suppress("UNCHECKED_CAST")
+                val nullability =
+                    (
+                            if (isNullable)
+                            /*
+                            I first had the idea of finding a default `nullDependentColumn` but it seems difficult to cover all kinds of cases.
+
+                            There are 3 ways I can think of to find the default `nullDependentColumn` in the corresponding columns mapped by the properties:
+                            1. find the first non-nullable column;
+                            1. find the first column that's a primary key;
+                            1. find the first non-nullable column with the suffix "id".
+
+                            They all have their drawbacks.
+                            The first approach is too unpredictable, adding or removing properties can affect which column to choose.
+                            Both the second and the third approach can't deal with the case where the column is not within the mapped columns,
+                            which happens when selecting a small portion of the fields as data.
+                             */
+                                NestedClass.Nullability.Nullable<PropertyData & Any>(config?.nullDependentColumn!!)
+                            else
+                                NestedClass.Nullability.NonNullable<PropertyData & Any>()
+                            )
+                            as NestedClass.Nullability<PropertyData>
+
+
+                @Suppress("UNCHECKED_CAST")
+                val adtConfig = config?.adt as PropertyColumnMappingConfig.Adt<PropertyData & Any>?
+                val adt = if (propertyClazz.isAbstract) {
+                    //requireNotNull(adtConfig)
+                    require(adtConfig is PropertyColumnMappingConfig.Adt.Sum<*, *>)
+                    adtConfig as PropertyColumnMappingConfig.Adt.Sum<PropertyData & Any, *>
+                    val subclassProductConfigMapOrOverride = adtConfig.subclassProductConfigMapOrOverride
+
+
+                    val subclassProductNestedConfigMapMapOrOverride =
+                        subclassProductConfigMapOrOverride.mapValues { it.value.nestedConfigMap }
+                    val subclassProductNestedConfigMapMap =
+                        if (propertyClazz.isSealed)
+                            propertyClazz.sealedLeafSubclasses().associateWith {
+                                emptyMap<KProperty1<out PropertyData & Any, *>, PropertyColumnMappingConfig<*>>()
+                            } + subclassProductNestedConfigMapMapOrOverride
+                        else {
+                            require(subclassProductConfigMapOrOverride.isNotEmpty()) { "A custom config needs to be specified for a non-sealed abstract class" }
+                            subclassProductNestedConfigMapMapOrOverride
+                        }
+
+                    NestedClass.Adt.Sum(
+                        subclassProductNestedConfigMapMap.mapValues {
+                            fun <SubclassData : PropertyData & Any> typeParameterHelper(
+                                clazz: KClass<SubclassData>, configMap: PropertyColumnMappingConfigMap<SubclassData>
+                            ): NestedClass.Adt.Product<SubclassData> =
+                                NestedClass.Adt.Product(
+                                    getDefaultClassPropertyColumnMappings(clazz, columnByPropertyNameMap, configMap)
+                                )
+                            @Suppress("UNCHECKED_CAST")
+                            typeParameterHelper(
+                                it.key as KClass<PropertyData & Any>,
+                                it.value as PropertyColumnMappingConfigMap<PropertyData & Any>
+                            )
+                        },
+                        adtConfig.sumTypeCaseConfig
+                    )
+                } else {
+                    require(adtConfig is PropertyColumnMappingConfig.Adt.Product?)
+                    NestedClass.Adt.Product(
+                        getDefaultClassPropertyColumnMappings(
+                            propertyClazz,
+                            columnByPropertyNameMap,
+                            (adtConfig?.nestedConfigMap ?: emptyMap())
+                        )
+                    )
+                }
+
+                NestedClass(property, nullability, adt)
+            }
+        }
+        typeParameterHelper(property)
     }
 }
 
-fun <Data : Any> getDefaultClassColumnMappings(
+// This implementation currently has poor performance (O(depth * size) time complexity).
+fun <T : Any> KClass<T>.sealedLeafSubclasses(): List<KClass<out T>> =
+    if (isSealed) sealedSubclasses.flatMap { it.sealedLeafSubclasses() }
+    else listOf(this)
+
+fun <Data : Any> getDefaultClassPropertyColumnMappings(
     clazz: KClass<Data>,
-    tables: List<Table>,
+    tables: List<Table>, onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST,
     customMappings: PropertyColumnMappings<Data> = emptyList(),
-    onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST
+    propertyColumnMappingConfigMapOverride: PropertyColumnMappingConfigMap<Data> = emptyMap()
 ): ClassPropertyColumnMappings<Data> =
-    getDefaultClassColumnMappings(
-        clazz, getColumnByPropertyNameMap(tables, onDuplicateColumnPropertyNames), customMappings
+    getDefaultClassPropertyColumnMappings(
+        clazz,
+        getColumnByPropertyNameMap(tables, onDuplicateColumnPropertyNames),
+        propertyColumnMappingConfigMapOverride,
+        customMappings
     )
 
-interface ClassPropertyMapper<Data : Any> : SimpleClassPropertyMapper<Data, Table> {
+interface ClassPropertyQueryMapper<Data : Any> : SimpleClassPropertyQueryMapper<Data> {
     val neededColumns: List<Column<*>>
 }
 
+typealias ClassPropertyUpdateMapper<Data> = ClassPropertyQueryMapper<Data>
+
+interface ClassPropertyMapper<Data : Any> : ClassPropertyQueryMapper<Data>, SimpleClassPropertyMapper<Data, ColumnSet>
+
+// TODO: decouple query mapper and update mapper.
 /** Supports classes with nested composite class properties and multiple tables */
 class ReflectionBasedClassPropertyMapper<Data : Any>(
     val clazz: KClass<Data>,
@@ -139,8 +365,8 @@ class ReflectionBasedClassPropertyMapper<Data : Any>(
     override fun resultRowToData(resultRow: ResultRow): Data =
         constructDataWithResultRow(clazz, classPropertyColumnMappings, resultRow)
 
-    override fun updateBuilderSetter(data: Data): Table.(UpdateBuilder<*>) -> Unit = {
-        setUpdateBuilder(classPropertyColumnMappings, data, it)
+    override fun setUpdateBuilder(data: Data, updateBuilder: UpdateBuilder<*>) {
+        setUpdateBuilder(classPropertyColumnMappings, data, updateBuilder)
     }
 }
 
@@ -148,55 +374,137 @@ fun <Data : Any> constructDataWithResultRow(
     clazz: KClass<Data>, classPropertyColumnMappings: ClassPropertyColumnMappings<Data>, resultRow: ResultRow
 ): Data =
     clazz.primaryConstructor!!.call(*classPropertyColumnMappings.map {
-        when (it) {
-            is ExposedSqlPrimitive -> resultRow.getValue(it.column)
-            is NestedClass ->
-                // TODO: the nullable case is not implemented yet
-                @Suppress("UNCHECKED_CAST")
-                constructDataWithResultRow(
-                    it.property.returnType.classifier as KClass<Any>,
-                    it.nestedMappings as ClassPropertyColumnMappings<Any>,
-                    resultRow
-                )
+        fun <PropertyData> typeParameterHelper(
+            propertyColumnMapping: PropertyColumnMapping<Data, PropertyData>,
+            nestedClass: KClass<PropertyData & Any>
+        ) =
+            when (propertyColumnMapping) {
+                is ExposedSqlPrimitive -> resultRow.getValue(propertyColumnMapping.column)
+                is NestedClass -> {
+                    fun constructNotNullData() =
+                        when (val adt = propertyColumnMapping.adt) {
+                            is NestedClass.Adt.Product ->
+                                constructDataWithResultRow(nestedClass, adt.nestedMappings, resultRow)
 
-            is Skip -> null
-        }
+                            is NestedClass.Adt.Sum<PropertyData & Any, *> -> {
+                                fun <CaseValue, SubclassData : PropertyData & Any> typeParameterHelper(sum: NestedClass.Adt.Sum<PropertyData & Any, CaseValue>): SubclassData {
+                                    val subclass = with(sum.sumTypeCaseConfig) {
+                                        caseValueToClass(resultRow[caseValueColumn])
+                                    }
+                                    @Suppress("UNCHECKED_CAST")
+                                    return constructDataWithResultRow(
+                                        subclass as KClass<SubclassData>,
+                                        sum.subclassMap.getValue(subclass).nestedMappings as ClassPropertyColumnMappings<SubclassData>,
+                                        resultRow
+                                    )
+                                }
+                                typeParameterHelper(adt)
+                            }
+                        }
+
+                    when (val nullability = propertyColumnMapping.nullability) {
+                        is NestedClass.Nullability.NonNullable -> constructNotNullData()
+                        is NestedClass.Nullability.Nullable<*> -> if (resultRow[nullability.nullDependentColumn] !== null) constructNotNullData() else null
+                    }
+                }
+
+                is Custom -> propertyColumnMapping.classPropertyMapper.resultRowToData(resultRow)
+                is Skip -> null
+            }
+        @Suppress("UNCHECKED_CAST")
+        typeParameterHelper(it as PropertyColumnMapping<Data, Any?>, it.property.returnType.classifier as KClass<Any>)
     }.toTypedArray())
 
 fun <Data : Any> setUpdateBuilder(
     classPropertyColumnMappings: ClassPropertyColumnMappings<Data>, data: Data, updateBuilder: UpdateBuilder<*>
 ) {
-    for (propertyColumnMapping in classPropertyColumnMappings)
-        when (propertyColumnMapping) {
-            is ExposedSqlPrimitive ->
-                @Suppress("UNCHECKED_CAST")
-                updateBuilder[propertyColumnMapping.column as Column<Any?>] = propertyColumnMapping.property(data)
-
-            is NestedClass -> {
-                @Suppress("NAME_SHADOWING", "UNCHECKED_CAST")
-                val propertyColumnMapping = propertyColumnMapping as NestedClass<Data, Any?>
-                val nestedMappings = propertyColumnMapping.nestedMappings
-                propertyColumnMapping.property(data)?.let {
-                    setUpdateBuilder(nestedMappings, it, updateBuilder)
+    for (propertyColumnMapping in classPropertyColumnMappings) {
+        fun <PropertyData> typeParameterHelper(propertyColumnMapping: PropertyColumnMapping<Data, PropertyData>) {
+            val propertyData = propertyColumnMapping.property(data)
+            when (propertyColumnMapping) {
+                is ExposedSqlPrimitive ->
+                    updateBuilder[propertyColumnMapping.column] = propertyData
+
+                is NestedClass -> {
+                    // `propertyColumnMapping.nullability` is not needed here
+                    when (val adt = propertyColumnMapping.adt) {
+                        is NestedClass.Adt.Product -> {
+                            val nestedMappings = adt.nestedMappings
+                            if (propertyData !== null)
+                                setUpdateBuilder(nestedMappings, propertyData, updateBuilder)
+                            else
+                                setUpdateBuilderToNulls(nestedMappings, updateBuilder)
+                        }
+
+                        is NestedClass.Adt.Sum<PropertyData & Any, *> -> {
+                            fun <CaseValue> typeParameterHelper() {
+                                @Suppress("UNCHECKED_CAST")
+                                adt as NestedClass.Adt.Sum<PropertyData & Any, CaseValue>
+                                val sumTypeCaseConfig = adt.sumTypeCaseConfig
+                                val subclassMap = adt.subclassMap
+                                if (propertyData !== null) {
+                                    // TODO: it seems to be a compiler bug that the non-null assertion is needed here.
+                                    val propertyDataClass = propertyData!!::class
+                                    with(sumTypeCaseConfig) {
+                                        updateBuilder[caseValueColumn] = classToCaseValue(propertyDataClass)
+                                    }
+                                    fun <SubclassData : PropertyData & Any> typeParameterHelper(
+                                        subclassMapping: NestedClass.Adt.Product<SubclassData>,
+                                        propertyData: SubclassData
+                                    ) =
+                                        setUpdateBuilder(subclassMapping.nestedMappings, propertyData, updateBuilder)
+                                    @Suppress("UNCHECKED_CAST")
+                                    typeParameterHelper(
+                                        subclassMap.getValue(propertyDataClass) as NestedClass.Adt.Product<PropertyData & Any>,
+                                        propertyData
+                                    )
+                                } else {
+                                    with(sumTypeCaseConfig) {
+                                        updateBuilder[caseValueColumn] = classToCaseValue(null)
+                                    }
+                                    // TODO: pre-process the combined columns and eliminate duplicates.
+                                    for (product in subclassMap.values)
+                                        setUpdateBuilderToNulls(product.nestedMappings, updateBuilder)
+                                }
+                            }
+                            typeParameterHelper<Any?>()
+                        }
+                    }
                 }
-                    ?: setUpdateBuilderToNulls(nestedMappings, updateBuilder)
-            }
 
-            is Skip -> {}
+                is Custom ->
+                    // TODO: remove this cast if and when not only non-nullable data are supported.
+                    propertyColumnMapping.classPropertyMapper.setUpdateBuilder(
+                        propertyData as (PropertyData & Any), updateBuilder
+                    )
+
+                is Skip -> {}
+            }
         }
+
+        typeParameterHelper(propertyColumnMapping)
+    }
 }
 
 fun ClassPropertyColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
     for (propertyColumnMapping in this)
         when (propertyColumnMapping) {
             is ExposedSqlPrimitive -> block(propertyColumnMapping.column)
-            is NestedClass -> propertyColumnMapping.nestedMappings.forEachColumn(block)
+            is NestedClass -> when (val adt = propertyColumnMapping.adt) {
+                is NestedClass.Adt.Product -> adt.nestedMappings.forEachColumn(block)
+                is NestedClass.Adt.Sum<*, *> -> {
+                    block(adt.sumTypeCaseConfig.caseValueColumn)
+                    adt.subclassMap.values.forEach { it.nestedMappings.forEachColumn(block) }
+                }
+            }
+
+            is Custom -> propertyColumnMapping.classPropertyMapper.neededColumns.forEach(block)
             is Skip -> {}
         }
 }
 
-fun <Data : Any> setUpdateBuilderToNulls(
-    classPropertyColumnMappings: ClassPropertyColumnMappings<Data>, updateBuilder: UpdateBuilder<*>
+fun setUpdateBuilderToNulls(
+    classPropertyColumnMappings: ClassPropertyColumnMappings<*>, updateBuilder: UpdateBuilder<*>
 ) =
     classPropertyColumnMappings.forEachColumn {
         @Suppress("UNCHECKED_CAST")
@@ -208,12 +516,12 @@ fun ClassPropertyColumnMappings<*>.getNeededColumns(): List<Column<*>> =
 
 inline fun <reified Data : Any> reflectionBasedClassPropertyMapper(
     tables: List<Table>,
-    customMappings: PropertyColumnMappings<Data> = emptyList(),
-    onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST
+    onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST,
+    customMappings: PropertyColumnMappings<Data> = emptyList()
 ): ReflectionBasedClassPropertyMapper<Data> {
     val clazz = Data::class
     return ReflectionBasedClassPropertyMapper(
-        clazz, getDefaultClassColumnMappings(clazz, tables, customMappings, onDuplicateColumnPropertyNames)
+        clazz, getDefaultClassPropertyColumnMappings(clazz, tables, onDuplicateColumnPropertyNames, customMappings)
     )
 }
 
@@ -221,4 +529,4 @@ inline fun <reified Data : Any/*, TableT : Table*/> reflectionBasedClassProperty
     table: Table,
     customMappings: PropertyColumnMappings<Data> = emptyList()
 ) =
-    reflectionBasedClassPropertyMapper(listOf(table), customMappings, THROW)
+    reflectionBasedClassPropertyMapper(listOf(table), THROW, customMappings)
diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
index ba5f206..85f7b01 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
@@ -1,22 +1,30 @@
 package com.huanshankeji.exposed.classpropertymapping
 
 import org.jetbrains.exposed.dao.id.EntityID
-import org.jetbrains.exposed.sql.Alias
-import org.jetbrains.exposed.sql.Column
-import org.jetbrains.exposed.sql.ResultRow
-import org.jetbrains.exposed.sql.Table
+import org.jetbrains.exposed.sql.*
 import org.jetbrains.exposed.sql.statements.UpdateBuilder
 import kotlin.reflect.KClass
 import kotlin.reflect.KFunction
 import kotlin.reflect.KProperty1
 import kotlin.reflect.full.memberProperties
 import kotlin.reflect.full.primaryConstructor
+import kotlin.sequences.Sequence
 
-interface SimpleClassPropertyMapper<Data : Any, TableT : Table> {
+fun interface SimpleClassPropertyQueryMapper<Data : Any> {
     fun resultRowToData(resultRow: ResultRow): Data
-    fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<*>) -> Unit
 }
 
+fun interface SimpleClassPropertyUpdateMapper<Data : Any, ColumnSetT : ColumnSet> {
+    fun updateBuilderSetter(data: Data): ColumnSetT.(UpdateBuilder<*>) -> Unit = {
+        setUpdateBuilder(data, it)
+    }
+
+    fun setUpdateBuilder(data: Data, updateBuilder: UpdateBuilder<*>)
+}
+
+interface SimpleClassPropertyMapper<Data : Any, ColumnSetT : ColumnSet> :
+    SimpleClassPropertyQueryMapper<Data>, SimpleClassPropertyUpdateMapper<Data, ColumnSetT>
+
 fun ResultRow.getValue(column: Column<*>): Any? =
     this[column].let {
         if (it is EntityID<*>) it.value else it
@@ -33,10 +41,10 @@ interface ReflectionBasedSimpleClassPropertyMapper<Data : Any, TableT : Table> :
         return dataPrimaryConstructor.call(*params.toTypedArray())
     }
 
-    override fun updateBuilderSetter(data: Data): TableT.(UpdateBuilder<*>) -> Unit = {
+    override fun setUpdateBuilder(data: Data, updateBuilder: UpdateBuilder<*>) {
         for ((property, column) in propertyAndColumnPairs)
             @Suppress("UNCHECKED_CAST")
-            it[column as Column<Any?>] = property(data)
+            updateBuilder[column as Column<Any?>] = property(data)
     }
 }
 

From deb59a06fd7b52b3797a1a32dda3fb9ba387d82e Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 28 Oct 2022 16:35:52 +0800
Subject: [PATCH 17/59] Remove some comments marked to be removed in the
 previous commit

---
 buildSrc/src/main/kotlin/VersionsAndDependencies.kt        | 7 -------
 exposed/build.gradle.kts                                   | 2 --
 .../exposed/classpropertymapping/ClassPropertyMapping.kt   | 1 -
 3 files changed, 10 deletions(-)

diff --git a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
index e752ac5..49b2c3a 100644
--- a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
+++ b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
@@ -7,10 +7,3 @@ val projectVersion = "0.3.0-SNAPSHOT"
 val commonVersions = CommonVersions()
 val commonDependencies = CommonDependencies(commonVersions)
 val commonGradleClasspathDependencies = CommonGradleClasspathDependencies(commonVersions)
-
-// TODO: remove
-/*
-object DependencyVersions {
-    const val guava = "31.1-jre"
-}
-*/
diff --git a/exposed/build.gradle.kts b/exposed/build.gradle.kts
index 7e72836..f471d4b 100644
--- a/exposed/build.gradle.kts
+++ b/exposed/build.gradle.kts
@@ -4,6 +4,4 @@ plugins {
 
 dependencies {
     implementation(commonDependencies.exposed.core())
-    // TODO: remove
-    //implementation("com.google.guava:guava:${DependencyVersions.guava}")
 }
diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
index 5491b92..464f5e9 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
@@ -43,7 +43,6 @@ sealed class PropertyColumnMapping<Data : Any, PropertyData>(val property: KProp
                 Adt<NotNullNestedData>()
 
             class Sum<NotNullNestedData : Any, CaseValue>(
-                // I first used the Guava BiMap but then realized it's not necessary. TODO: remove this comment
                 val subclassMap: Map<KClass<out NotNullNestedData>, Product<out NotNullNestedData>>,
                 val sumTypeCaseConfig: SumTypeCaseConfig<NotNullNestedData, CaseValue>
             ) : Adt<NotNullNestedData>()

From 60282aaac9f67e395e10ae9f370845265fbde1d5 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 28 Oct 2022 16:45:06 +0800
Subject: [PATCH 18/59] Rename some type parameters to make their names more
 consistent, resolving 2 TODOs

---
 .../ClassPropertyMapping.kt                   | 54 +++++++++----------
 1 file changed, 26 insertions(+), 28 deletions(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
index 464f5e9..d4f62a2 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
@@ -19,33 +19,31 @@ typealias ClassPropertyColumnMappings<Data> = PropertyColumnMappings<Data>
 
 // TODO: decouple/remove `property` and `Data` from this class.
 sealed class PropertyColumnMapping<Data : Any, PropertyData>(val property: KProperty1<Data, PropertyData>) {
-    // TODO: rename all occurrences of "PrimitiveValue" to "PropertyData".
-    class ExposedSqlPrimitive<Data : Any, PrimitiveValue>(
-        property: KProperty1<Data, PrimitiveValue>,
-        val column: Column<PrimitiveValue>
-    ) : PropertyColumnMapping<Data, PrimitiveValue>(property)
-
-    // TODO: rename all occurrences of "NestedData" to "PropertyData".
-    class NestedClass<Data : Any, NestedData>(
-        property: KProperty1<Data, NestedData>,
-        val nullability: Nullability<NestedData>,
-        val adt: Adt<NestedData & Any>
-    ) : PropertyColumnMapping<Data, NestedData>(property) {
-        sealed class Nullability<NestedData> {
-            class NonNullable<NotNullNestedData : Any> : Nullability<NotNullNestedData>()
-            class Nullable<NotNullNestedData : Any>(val nullDependentColumn: Column<*>) :
-                Nullability<NotNullNestedData?>()
+    class ExposedSqlPrimitive<Data : Any, PropertyData>(
+        property: KProperty1<Data, PropertyData>,
+        val column: Column<PropertyData>
+    ) : PropertyColumnMapping<Data, PropertyData>(property)
+
+    class NestedClass<Data : Any, PropertyData>(
+        property: KProperty1<Data, PropertyData>,
+        val nullability: Nullability<PropertyData>,
+        val adt: Adt<PropertyData & Any>
+    ) : PropertyColumnMapping<Data, PropertyData>(property) {
+        sealed class Nullability<PropertyData> {
+            class NonNullable<NotNullPropertyData : Any> : Nullability<NotNullPropertyData>()
+            class Nullable<NotNullPropertyData : Any>(val nullDependentColumn: Column<*>) :
+                Nullability<NotNullPropertyData?>()
         }
 
         // ADT: algebraic data type
-        sealed class Adt<NotNullNestedData : Any> {
-            class Product<NotNullNestedData : Any>(val nestedMappings: ClassPropertyColumnMappings<NotNullNestedData>) :
-                Adt<NotNullNestedData>()
-
-            class Sum<NotNullNestedData : Any, CaseValue>(
-                val subclassMap: Map<KClass<out NotNullNestedData>, Product<out NotNullNestedData>>,
-                val sumTypeCaseConfig: SumTypeCaseConfig<NotNullNestedData, CaseValue>
-            ) : Adt<NotNullNestedData>()
+        sealed class Adt<NotNullPropertyData : Any> {
+            class Product<NotNullPropertyData : Any>(val nestedMappings: ClassPropertyColumnMappings<NotNullPropertyData>) :
+                Adt<NotNullPropertyData>()
+
+            class Sum<NotNullPropertyData : Any, CaseValue>(
+                val subclassMap: Map<KClass<out NotNullPropertyData>, Product<out NotNullPropertyData>>,
+                val sumTypeCaseConfig: SumTypeCaseConfig<NotNullPropertyData, CaseValue>
+            ) : Adt<NotNullPropertyData>()
         }
 
     }
@@ -59,10 +57,10 @@ sealed class PropertyColumnMapping<Data : Any, PropertyData>(val property: KProp
         PropertyColumnMapping<Data, PropertyData>(property)
 }
 
-class SumTypeCaseConfig<Superclass : Any, Case>(
-    val caseValueColumn: Column<Case>,
-    val caseValueToClass: (Case) -> KClass<out Superclass>,
-    val classToCaseValue: (KClass<out Superclass>?) -> Case
+class SumTypeCaseConfig<SuperclassData : Any, CaseValue>(
+    val caseValueColumn: Column<CaseValue>,
+    val caseValueToClass: (CaseValue) -> KClass<out SuperclassData>,
+    val classToCaseValue: (KClass<out SuperclassData>?) -> CaseValue
 )
 
 

From 8168ba8420006cd4af09a207d99541aefd09c067 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 28 Oct 2022 17:05:05 +0800
Subject: [PATCH 19/59] Include `nullDependentColumn` in `forEachColumn` and
 eliminate duplicates in `getNeededColumns` which is renamed to
 `getNeededColumnSet`

---
 .../ClassPropertyMapping.kt                   | 22 ++++++++++++-------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
index d4f62a2..84cd797 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
@@ -358,7 +358,7 @@ class ReflectionBasedClassPropertyMapper<Data : Any>(
     val clazz: KClass<Data>,
     val classPropertyColumnMappings: ClassPropertyColumnMappings<Data>,
 ) : ClassPropertyMapper<Data> {
-    override val neededColumns = classPropertyColumnMappings.getNeededColumns()
+    override val neededColumns = classPropertyColumnMappings.getNeededColumnSet().toList()
     override fun resultRowToData(resultRow: ResultRow): Data =
         constructDataWithResultRow(clazz, classPropertyColumnMappings, resultRow)
 
@@ -487,11 +487,17 @@ fun ClassPropertyColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
     for (propertyColumnMapping in this)
         when (propertyColumnMapping) {
             is ExposedSqlPrimitive -> block(propertyColumnMapping.column)
-            is NestedClass -> when (val adt = propertyColumnMapping.adt) {
-                is NestedClass.Adt.Product -> adt.nestedMappings.forEachColumn(block)
-                is NestedClass.Adt.Sum<*, *> -> {
-                    block(adt.sumTypeCaseConfig.caseValueColumn)
-                    adt.subclassMap.values.forEach { it.nestedMappings.forEachColumn(block) }
+            is NestedClass -> {
+                when (val nullability = propertyColumnMapping.nullability) {
+                    is NestedClass.Nullability.NonNullable -> {}
+                    is NestedClass.Nullability.Nullable -> block(nullability.nullDependentColumn)
+                }
+                when (val adt = propertyColumnMapping.adt) {
+                    is NestedClass.Adt.Product -> adt.nestedMappings.forEachColumn(block)
+                    is NestedClass.Adt.Sum<*, *> -> {
+                        block(adt.sumTypeCaseConfig.caseValueColumn)
+                        adt.subclassMap.values.forEach { it.nestedMappings.forEachColumn(block) }
+                    }
                 }
             }
 
@@ -508,8 +514,8 @@ fun setUpdateBuilderToNulls(
         updateBuilder[it as Column<Any?>] = null
     }
 
-fun ClassPropertyColumnMappings<*>.getNeededColumns(): List<Column<*>> =
-    buildList { forEachColumn { add(it) } }
+fun ClassPropertyColumnMappings<*>.getNeededColumnSet(): Set<Column<*>> =
+    buildSet { forEachColumn { add(it) } }
 
 inline fun <reified Data : Any> reflectionBasedClassPropertyMapper(
     tables: List<Table>,

From eeae589658c899cc94637c21c1fda4a2e3e7843a Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 28 Oct 2022 17:50:02 +0800
Subject: [PATCH 20/59] Pre-process distinct `columnsForAllSubclasses` in
 `PropertyColumnMapping.NestedClass.Adt.Sum`, refactor related functions, and
 resolve a related TODO

---
 .../ClassPropertyMapping.kt                   | 105 ++++++++++--------
 1 file changed, 59 insertions(+), 46 deletions(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
index 84cd797..6660fe2 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
@@ -43,9 +43,13 @@ sealed class PropertyColumnMapping<Data : Any, PropertyData>(val property: KProp
             class Sum<NotNullPropertyData : Any, CaseValue>(
                 val subclassMap: Map<KClass<out NotNullPropertyData>, Product<out NotNullPropertyData>>,
                 val sumTypeCaseConfig: SumTypeCaseConfig<NotNullPropertyData, CaseValue>
-            ) : Adt<NotNullPropertyData>()
+            ) : Adt<NotNullPropertyData>() {
+                val columnsForAllSubclasses = subclassMap.values.asSequence()
+                    .flatMap { it.nestedMappings.getNeededColumnSet() }
+                    .toSet() // Using `toSet` seems to be faster than `distinct`.
+                    .toList()
+            }
         }
-
     }
 
     // TODO: remove the temporary workaround `& Any` if and when the `Any` upper bound is removed.
@@ -430,38 +434,38 @@ fun <Data : Any> setUpdateBuilder(
                             if (propertyData !== null)
                                 setUpdateBuilder(nestedMappings, propertyData, updateBuilder)
                             else
-                                setUpdateBuilderToNulls(nestedMappings, updateBuilder)
+                                setUpdateBuilderColumnsToNullsWithMappings(nestedMappings, updateBuilder)
                         }
 
                         is NestedClass.Adt.Sum<PropertyData & Any, *> -> {
                             fun <CaseValue> typeParameterHelper() {
                                 @Suppress("UNCHECKED_CAST")
                                 adt as NestedClass.Adt.Sum<PropertyData & Any, CaseValue>
-                                val sumTypeCaseConfig = adt.sumTypeCaseConfig
-                                val subclassMap = adt.subclassMap
-                                if (propertyData !== null) {
-                                    // TODO: it seems to be a compiler bug that the non-null assertion is needed here.
-                                    val propertyDataClass = propertyData!!::class
-                                    with(sumTypeCaseConfig) {
-                                        updateBuilder[caseValueColumn] = classToCaseValue(propertyDataClass)
-                                    }
-                                    fun <SubclassData : PropertyData & Any> typeParameterHelper(
-                                        subclassMapping: NestedClass.Adt.Product<SubclassData>,
-                                        propertyData: SubclassData
-                                    ) =
-                                        setUpdateBuilder(subclassMapping.nestedMappings, propertyData, updateBuilder)
-                                    @Suppress("UNCHECKED_CAST")
-                                    typeParameterHelper(
-                                        subclassMap.getValue(propertyDataClass) as NestedClass.Adt.Product<PropertyData & Any>,
-                                        propertyData
-                                    )
-                                } else {
-                                    with(sumTypeCaseConfig) {
-                                        updateBuilder[caseValueColumn] = classToCaseValue(null)
+                                with(adt) {
+                                    if (propertyData !== null) {
+                                        // TODO: it seems to be a compiler bug that the non-null assertion is needed here.
+                                        val propertyDataClass = propertyData!!::class
+                                        with(sumTypeCaseConfig) {
+                                            updateBuilder[caseValueColumn] = classToCaseValue(propertyDataClass)
+                                        }
+                                        fun <SubclassData : PropertyData & Any> typeParameterHelper(
+                                            subclassMapping: NestedClass.Adt.Product<SubclassData>,
+                                            propertyData: SubclassData
+                                        ) =
+                                            setUpdateBuilder(
+                                                subclassMapping.nestedMappings, propertyData, updateBuilder
+                                            )
+                                        @Suppress("UNCHECKED_CAST")
+                                        typeParameterHelper(
+                                            subclassMap.getValue(propertyDataClass) as NestedClass.Adt.Product<PropertyData & Any>,
+                                            propertyData
+                                        )
+                                    } else {
+                                        with(sumTypeCaseConfig) {
+                                            updateBuilder[caseValueColumn] = classToCaseValue(null)
+                                        }
+                                        setUpdateBuilderColumnsToNulls(columnsForAllSubclasses, updateBuilder)
                                     }
-                                    // TODO: pre-process the combined columns and eliminate duplicates.
-                                    for (product in subclassMap.values)
-                                        setUpdateBuilderToNulls(product.nestedMappings, updateBuilder)
                                 }
                             }
                             typeParameterHelper<Any?>()
@@ -483,30 +487,33 @@ fun <Data : Any> setUpdateBuilder(
     }
 }
 
-fun ClassPropertyColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
-    for (propertyColumnMapping in this)
-        when (propertyColumnMapping) {
-            is ExposedSqlPrimitive -> block(propertyColumnMapping.column)
-            is NestedClass -> {
-                when (val nullability = propertyColumnMapping.nullability) {
-                    is NestedClass.Nullability.NonNullable -> {}
-                    is NestedClass.Nullability.Nullable -> block(nullability.nullDependentColumn)
-                }
-                when (val adt = propertyColumnMapping.adt) {
-                    is NestedClass.Adt.Product -> adt.nestedMappings.forEachColumn(block)
-                    is NestedClass.Adt.Sum<*, *> -> {
-                        block(adt.sumTypeCaseConfig.caseValueColumn)
-                        adt.subclassMap.values.forEach { it.nestedMappings.forEachColumn(block) }
-                    }
+fun PropertyColumnMapping<*, *>.forEachColumn(block: (Column<*>) -> Unit) =
+    when (this) {
+        is ExposedSqlPrimitive -> block(column)
+        is NestedClass -> {
+            when (nullability) {
+                is NestedClass.Nullability.NonNullable -> {}
+                is NestedClass.Nullability.Nullable -> block(nullability.nullDependentColumn)
+            }
+            when (adt) {
+                is NestedClass.Adt.Product -> adt.nestedMappings.forEachColumn(block)
+                is NestedClass.Adt.Sum<*, *> -> {
+                    block(adt.sumTypeCaseConfig.caseValueColumn)
+                    adt.subclassMap.values.forEach { it.nestedMappings.forEachColumn(block) }
                 }
             }
-
-            is Custom -> propertyColumnMapping.classPropertyMapper.neededColumns.forEach(block)
-            is Skip -> {}
         }
+
+        is Custom -> classPropertyMapper.neededColumns.forEach(block)
+        is Skip -> {}
+    }
+
+fun ClassPropertyColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
+    for (propertyColumnMapping in this)
+        propertyColumnMapping.forEachColumn(block)
 }
 
-fun setUpdateBuilderToNulls(
+fun setUpdateBuilderColumnsToNullsWithMappings(
     classPropertyColumnMappings: ClassPropertyColumnMappings<*>, updateBuilder: UpdateBuilder<*>
 ) =
     classPropertyColumnMappings.forEachColumn {
@@ -514,6 +521,12 @@ fun setUpdateBuilderToNulls(
         updateBuilder[it as Column<Any?>] = null
     }
 
+fun setUpdateBuilderColumnsToNulls(columns: List<Column<*>>, updateBuilder: UpdateBuilder<*>) {
+    for (column in columns)
+        @Suppress("UNCHECKED_CAST")
+        updateBuilder[column as Column<Any?>] = null
+}
+
 fun ClassPropertyColumnMappings<*>.getNeededColumnSet(): Set<Column<*>> =
     buildSet { forEachColumn { add(it) } }
 

From 11b6ceccc418d768a7dec8505d1f381e301a26fc Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 28 Oct 2022 18:19:24 +0800
Subject: [PATCH 21/59] Consider whether to resolve a TODO comment and make it
 more specific

---
 .../exposed/classpropertymapping/ClassPropertyMapping.kt   | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
index 6660fe2..f1cafb0 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
@@ -17,7 +17,12 @@ typealias PropertyColumnMappings<Data> = List<PropertyColumnMapping<Data, *>>
 /** In the order of the constructor arguments. */
 typealias ClassPropertyColumnMappings<Data> = PropertyColumnMappings<Data>
 
-// TODO: decouple/remove `property` and `Data` from this class.
+/*
+TODO: consider decoupling/removing `property` and `Data` from this class and rename it to `ColumnMapping`
+ and add a `PropertyColumnMapping` containing the property and the `ColumnMapping`.
+ However, after the refactor, `ColumnMapping` will still be coupled with `ClassPropertyColumnMappings` which is coupled with `PropertyColumnMapping`,
+ so I am not sure whether this is necessary.
+*/
 sealed class PropertyColumnMapping<Data : Any, PropertyData>(val property: KProperty1<Data, PropertyData>) {
     class ExposedSqlPrimitive<Data : Any, PropertyData>(
         property: KProperty1<Data, PropertyData>,

From 766018989e32f9e053f3fd3e247b98502c223825 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Mon, 7 Nov 2022 20:38:15 +0800
Subject: [PATCH 22/59] Reorganize and rename the packages and interfaces,
 improve `columnsForAllSubclasses`, and remove the `ColumnSetT` type parameter
 in `SimpleDataUpdateMapper`

---
 .../datamapping/DataMapperInterfaces.kt       | 31 ++++++++++++
 .../classproperty}/ClassPropertyMapping.kt    | 49 ++++++++-----------
 .../SimpleClassPropertyMapping.kt             | 37 +++++---------
 3 files changed, 63 insertions(+), 54 deletions(-)
 create mode 100644 exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/DataMapperInterfaces.kt
 rename exposed/src/main/kotlin/com/huanshankeji/exposed/{classpropertymapping => datamapping/classproperty}/ClassPropertyMapping.kt (93%)
 rename exposed/src/main/kotlin/com/huanshankeji/exposed/{classpropertymapping => datamapping/classproperty}/SimpleClassPropertyMapping.kt (72%)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/DataMapperInterfaces.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/DataMapperInterfaces.kt
new file mode 100644
index 0000000..c381e5c
--- /dev/null
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/DataMapperInterfaces.kt
@@ -0,0 +1,31 @@
+package com.huanshankeji.exposed.datamapping
+
+import org.jetbrains.exposed.sql.Column
+import org.jetbrains.exposed.sql.ColumnSet
+import org.jetbrains.exposed.sql.ResultRow
+import org.jetbrains.exposed.sql.statements.UpdateBuilder
+
+fun interface SimpleDataQueryMapper<Data : Any> {
+    fun resultRowToData(resultRow: ResultRow): Data
+}
+
+fun interface SimpleDataUpdateMapper<Data : Any> {
+    fun setUpdateBuilder(data: Data, updateBuilder: UpdateBuilder<*>)
+}
+
+fun <Data : Any, ColumnSetT : ColumnSet> SimpleDataUpdateMapper<Data>.updateBuilderSetter(data: Data):
+        ColumnSetT.(UpdateBuilder<*>) -> Unit = {
+    setUpdateBuilder(data, it)
+}
+
+interface SimpleDataMapper<Data : Any> :
+    SimpleDataQueryMapper<Data>, SimpleDataUpdateMapper<Data>
+
+
+interface DataQueryMapper<Data : Any> : SimpleDataQueryMapper<Data> {
+    val neededColumns: List<Column<*>>
+}
+
+typealias DataUpdateMapper<Data> = SimpleDataUpdateMapper<Data>
+
+interface DataMapper<Data : Any> : DataQueryMapper<Data>, SimpleDataMapper<Data>
diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
similarity index 93%
rename from exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
rename to exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
index f1cafb0..764251e 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
@@ -1,7 +1,8 @@
-package com.huanshankeji.exposed.classpropertymapping
+package com.huanshankeji.exposed.datamapping.classproperty
 
-import com.huanshankeji.exposed.classpropertymapping.OnDuplicateColumnPropertyNames.*
-import com.huanshankeji.exposed.classpropertymapping.PropertyColumnMapping.*
+import com.huanshankeji.exposed.datamapping.DataMapper
+import com.huanshankeji.exposed.datamapping.classproperty.OnDuplicateColumnPropertyNames.*
+import com.huanshankeji.exposed.datamapping.classproperty.PropertyColumnMapping.*
 import org.jetbrains.exposed.sql.*
 import org.jetbrains.exposed.sql.statements.UpdateBuilder
 import org.slf4j.LoggerFactory
@@ -49,17 +50,17 @@ sealed class PropertyColumnMapping<Data : Any, PropertyData>(val property: KProp
                 val subclassMap: Map<KClass<out NotNullPropertyData>, Product<out NotNullPropertyData>>,
                 val sumTypeCaseConfig: SumTypeCaseConfig<NotNullPropertyData, CaseValue>
             ) : Adt<NotNullPropertyData>() {
-                val columnsForAllSubclasses = subclassMap.values.asSequence()
-                    .flatMap { it.nestedMappings.getNeededColumnSet() }
-                    .toSet() // Using `toSet` seems to be faster than `distinct`.
-                    .toList()
+                val columnsForAllSubclasses = buildSet {
+                    for (subclassProductMapping in subclassMap.values)
+                        addAll(subclassProductMapping.nestedMappings.getColumnSet())
+                }.toList()
             }
         }
     }
 
     // TODO: remove the temporary workaround `& Any` if and when the `Any` upper bound is removed.
     class Custom<Data : Any, PropertyData>(
-        property: KProperty1<Data, PropertyData>, val classPropertyMapper: ClassPropertyMapper<PropertyData & Any>
+        property: KProperty1<Data, PropertyData>, val dataMapper: DataMapper<PropertyData & Any>
     ) : PropertyColumnMapping<Data, PropertyData>(property)
 
     class Skip<Data : Any, PropertyData>(property: KProperty1<Data, PropertyData>) :
@@ -353,21 +354,13 @@ fun <Data : Any> getDefaultClassPropertyColumnMappings(
         customMappings
     )
 
-interface ClassPropertyQueryMapper<Data : Any> : SimpleClassPropertyQueryMapper<Data> {
-    val neededColumns: List<Column<*>>
-}
-
-typealias ClassPropertyUpdateMapper<Data> = ClassPropertyQueryMapper<Data>
-
-interface ClassPropertyMapper<Data : Any> : ClassPropertyQueryMapper<Data>, SimpleClassPropertyMapper<Data, ColumnSet>
-
 // TODO: decouple query mapper and update mapper.
 /** Supports classes with nested composite class properties and multiple tables */
-class ReflectionBasedClassPropertyMapper<Data : Any>(
+class ReflectionBasedClassPropertyDataMapper<Data : Any>(
     val clazz: KClass<Data>,
     val classPropertyColumnMappings: ClassPropertyColumnMappings<Data>,
-) : ClassPropertyMapper<Data> {
-    override val neededColumns = classPropertyColumnMappings.getNeededColumnSet().toList()
+) : DataMapper<Data> {
+    override val neededColumns = classPropertyColumnMappings.getColumnSet().toList()
     override fun resultRowToData(resultRow: ResultRow): Data =
         constructDataWithResultRow(clazz, classPropertyColumnMappings, resultRow)
 
@@ -414,7 +407,7 @@ fun <Data : Any> constructDataWithResultRow(
                     }
                 }
 
-                is Custom -> propertyColumnMapping.classPropertyMapper.resultRowToData(resultRow)
+                is Custom -> propertyColumnMapping.dataMapper.resultRowToData(resultRow)
                 is Skip -> null
             }
         @Suppress("UNCHECKED_CAST")
@@ -480,7 +473,7 @@ fun <Data : Any> setUpdateBuilder(
 
                 is Custom ->
                     // TODO: remove this cast if and when not only non-nullable data are supported.
-                    propertyColumnMapping.classPropertyMapper.setUpdateBuilder(
+                    propertyColumnMapping.dataMapper.setUpdateBuilder(
                         propertyData as (PropertyData & Any), updateBuilder
                     )
 
@@ -509,7 +502,7 @@ fun PropertyColumnMapping<*, *>.forEachColumn(block: (Column<*>) -> Unit) =
             }
         }
 
-        is Custom -> classPropertyMapper.neededColumns.forEach(block)
+        is Custom -> dataMapper.neededColumns.forEach(block)
         is Skip -> {}
     }
 
@@ -532,22 +525,22 @@ fun setUpdateBuilderColumnsToNulls(columns: List<Column<*>>, updateBuilder: Upda
         updateBuilder[column as Column<Any?>] = null
 }
 
-fun ClassPropertyColumnMappings<*>.getNeededColumnSet(): Set<Column<*>> =
+fun ClassPropertyColumnMappings<*>.getColumnSet(): Set<Column<*>> =
     buildSet { forEachColumn { add(it) } }
 
-inline fun <reified Data : Any> reflectionBasedClassPropertyMapper(
+inline fun <reified Data : Any> reflectionBasedClassPropertyDataMapper(
     tables: List<Table>,
     onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST,
     customMappings: PropertyColumnMappings<Data> = emptyList()
-): ReflectionBasedClassPropertyMapper<Data> {
+): ReflectionBasedClassPropertyDataMapper<Data> {
     val clazz = Data::class
-    return ReflectionBasedClassPropertyMapper(
+    return ReflectionBasedClassPropertyDataMapper(
         clazz, getDefaultClassPropertyColumnMappings(clazz, tables, onDuplicateColumnPropertyNames, customMappings)
     )
 }
 
-inline fun <reified Data : Any/*, TableT : Table*/> reflectionBasedClassPropertyMapper(
+inline fun <reified Data : Any/*, TableT : Table*/> reflectionBasedClassPropertyDataMapper(
     table: Table,
     customMappings: PropertyColumnMappings<Data> = emptyList()
 ) =
-    reflectionBasedClassPropertyMapper(listOf(table), THROW, customMappings)
+    reflectionBasedClassPropertyDataMapper(listOf(table), THROW, customMappings)
diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/SimpleClassPropertyMapping.kt
similarity index 72%
rename from exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
rename to exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/SimpleClassPropertyMapping.kt
index 85f7b01..dd62948 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/classpropertymapping/SimpleClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/SimpleClassPropertyMapping.kt
@@ -1,5 +1,6 @@
-package com.huanshankeji.exposed.classpropertymapping
+package com.huanshankeji.exposed.datamapping.classproperty
 
+import com.huanshankeji.exposed.datamapping.SimpleDataMapper
 import org.jetbrains.exposed.dao.id.EntityID
 import org.jetbrains.exposed.sql.*
 import org.jetbrains.exposed.sql.statements.UpdateBuilder
@@ -10,29 +11,13 @@ import kotlin.reflect.full.memberProperties
 import kotlin.reflect.full.primaryConstructor
 import kotlin.sequences.Sequence
 
-fun interface SimpleClassPropertyQueryMapper<Data : Any> {
-    fun resultRowToData(resultRow: ResultRow): Data
-}
-
-fun interface SimpleClassPropertyUpdateMapper<Data : Any, ColumnSetT : ColumnSet> {
-    fun updateBuilderSetter(data: Data): ColumnSetT.(UpdateBuilder<*>) -> Unit = {
-        setUpdateBuilder(data, it)
-    }
-
-    fun setUpdateBuilder(data: Data, updateBuilder: UpdateBuilder<*>)
-}
-
-interface SimpleClassPropertyMapper<Data : Any, ColumnSetT : ColumnSet> :
-    SimpleClassPropertyQueryMapper<Data>, SimpleClassPropertyUpdateMapper<Data, ColumnSetT>
-
 fun ResultRow.getValue(column: Column<*>): Any? =
     this[column].let {
         if (it is EntityID<*>) it.value else it
     }
 
 /** Nested classes are not supported. */
-interface ReflectionBasedSimpleClassPropertyMapper<Data : Any, TableT : Table> :
-    SimpleClassPropertyMapper<Data, TableT> {
+interface ReflectionBasedSimpleClassPropertyDataMapper<Data : Any> : SimpleDataMapper<Data> {
     val propertyAndColumnPairs: List<Pair<KProperty1<Data, *>, Column<*>>>
     val dataPrimaryConstructor: KFunction<Data>
 
@@ -48,8 +33,8 @@ interface ReflectionBasedSimpleClassPropertyMapper<Data : Any, TableT : Table> :
     }
 }
 
-inline fun <reified Data : Any, reified TableT : Table> reflectionBasedSimpleClassPropertyMapper(table: TableT): ReflectionBasedSimpleClassPropertyMapper<Data, TableT> =
-    object : ReflectionBasedSimpleClassPropertyMapper<Data, TableT> {
+inline fun <reified Data : Any> reflectionBasedSimpleClassPropertyDataMapper(table: Table): ReflectionBasedSimpleClassPropertyDataMapper<Data> =
+    object : ReflectionBasedSimpleClassPropertyDataMapper<Data> {
         private val clazz = Data::class
 
         // This property needs to initialize first.
@@ -78,13 +63,13 @@ inline fun <reified TableT : Table> getColumnByPropertyNameMapWithTypeParameter(
     getColumnPropertyByNameMap(TableT::class)
         .mapValues { it.value(table) }
 
-inline fun <reified D : Any, reified T : Table> reflectionBasedSimpleClassPropertyMapperForAlias(
-    tableClassPropertyMapper: ReflectionBasedSimpleClassPropertyMapper<D, T>, alias: Alias<T>
-): ReflectionBasedSimpleClassPropertyMapper<D, T> =
-    object : ReflectionBasedSimpleClassPropertyMapper<D, T> {
-        override val dataPrimaryConstructor = tableClassPropertyMapper.dataPrimaryConstructor
+inline fun <reified Data : Any, reified TableT : Table> reflectionBasedSimpleClassPropertyDataMapperForAlias(
+    tableDataMapper: ReflectionBasedSimpleClassPropertyDataMapper<Data>, alias: Alias<TableT>
+): ReflectionBasedSimpleClassPropertyDataMapper<Data> =
+    object : ReflectionBasedSimpleClassPropertyDataMapper<Data> {
+        override val dataPrimaryConstructor = tableDataMapper.dataPrimaryConstructor
         override val propertyAndColumnPairs =
-            tableClassPropertyMapper.propertyAndColumnPairs.map { it.first to alias[it.second] }
+            tableDataMapper.propertyAndColumnPairs.map { it.first to alias[it.second] }
     }
 
 

From f6ef7e6bc3ae5da5a839894e22b0c384bc990b3b Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Wed, 9 Nov 2022 12:02:03 +0800
Subject: [PATCH 23/59] Add and use nullable data mapper interfaces

---
 .../datamapping/DataMapperInterfaces.kt       | 20 +++++++++++--------
 .../classproperty/ClassPropertyMapping.kt     | 13 +++++-------
 2 files changed, 17 insertions(+), 16 deletions(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/DataMapperInterfaces.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/DataMapperInterfaces.kt
index c381e5c..297a0cc 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/DataMapperInterfaces.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/DataMapperInterfaces.kt
@@ -5,27 +5,31 @@ import org.jetbrains.exposed.sql.ColumnSet
 import org.jetbrains.exposed.sql.ResultRow
 import org.jetbrains.exposed.sql.statements.UpdateBuilder
 
-fun interface SimpleDataQueryMapper<Data : Any> {
+fun interface SimpleNullableDataQueryMapper<Data> {
     fun resultRowToData(resultRow: ResultRow): Data
 }
 
-fun interface SimpleDataUpdateMapper<Data : Any> {
+fun interface SimpleDataQueryMapper<Data : Any> : SimpleNullableDataQueryMapper<Data>
+
+fun interface NullableDataUpdateMapper<Data> {
     fun setUpdateBuilder(data: Data, updateBuilder: UpdateBuilder<*>)
 }
 
-fun <Data : Any, ColumnSetT : ColumnSet> SimpleDataUpdateMapper<Data>.updateBuilderSetter(data: Data):
+fun interface DataUpdateMapper<Data : Any> : NullableDataUpdateMapper<Data>
+
+fun <Data : Any, ColumnSetT : ColumnSet> DataUpdateMapper<Data>.updateBuilderSetter(data: Data):
         ColumnSetT.(UpdateBuilder<*>) -> Unit = {
     setUpdateBuilder(data, it)
 }
 
-interface SimpleDataMapper<Data : Any> :
-    SimpleDataQueryMapper<Data>, SimpleDataUpdateMapper<Data>
+interface SimpleDataMapper<Data : Any> : SimpleDataQueryMapper<Data>, DataUpdateMapper<Data>
 
 
-interface DataQueryMapper<Data : Any> : SimpleDataQueryMapper<Data> {
+interface NullableDataQueryMapper<Data> : SimpleNullableDataQueryMapper<Data> {
     val neededColumns: List<Column<*>>
 }
 
-typealias DataUpdateMapper<Data> = SimpleDataUpdateMapper<Data>
+interface DataQueryMapper<Data : Any> : NullableDataQueryMapper<Data>
 
-interface DataMapper<Data : Any> : DataQueryMapper<Data>, SimpleDataMapper<Data>
+interface NullableDataMapper<Data> : NullableDataQueryMapper<Data>, NullableDataUpdateMapper<Data>
+interface DataMapper<Data : Any> : NullableDataMapper<Data>, DataQueryMapper<Data>, SimpleDataMapper<Data>
diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
index 764251e..89cb132 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
@@ -1,6 +1,7 @@
 package com.huanshankeji.exposed.datamapping.classproperty
 
 import com.huanshankeji.exposed.datamapping.DataMapper
+import com.huanshankeji.exposed.datamapping.NullableDataMapper
 import com.huanshankeji.exposed.datamapping.classproperty.OnDuplicateColumnPropertyNames.*
 import com.huanshankeji.exposed.datamapping.classproperty.PropertyColumnMapping.*
 import org.jetbrains.exposed.sql.*
@@ -58,9 +59,8 @@ sealed class PropertyColumnMapping<Data : Any, PropertyData>(val property: KProp
         }
     }
 
-    // TODO: remove the temporary workaround `& Any` if and when the `Any` upper bound is removed.
     class Custom<Data : Any, PropertyData>(
-        property: KProperty1<Data, PropertyData>, val dataMapper: DataMapper<PropertyData & Any>
+        property: KProperty1<Data, PropertyData>, val nullableDataMapper: NullableDataMapper<PropertyData>
     ) : PropertyColumnMapping<Data, PropertyData>(property)
 
     class Skip<Data : Any, PropertyData>(property: KProperty1<Data, PropertyData>) :
@@ -407,7 +407,7 @@ fun <Data : Any> constructDataWithResultRow(
                     }
                 }
 
-                is Custom -> propertyColumnMapping.dataMapper.resultRowToData(resultRow)
+                is Custom -> propertyColumnMapping.nullableDataMapper.resultRowToData(resultRow)
                 is Skip -> null
             }
         @Suppress("UNCHECKED_CAST")
@@ -472,10 +472,7 @@ fun <Data : Any> setUpdateBuilder(
                 }
 
                 is Custom ->
-                    // TODO: remove this cast if and when not only non-nullable data are supported.
-                    propertyColumnMapping.dataMapper.setUpdateBuilder(
-                        propertyData as (PropertyData & Any), updateBuilder
-                    )
+                    propertyColumnMapping.nullableDataMapper.setUpdateBuilder(propertyData, updateBuilder)
 
                 is Skip -> {}
             }
@@ -502,7 +499,7 @@ fun PropertyColumnMapping<*, *>.forEachColumn(block: (Column<*>) -> Unit) =
             }
         }
 
-        is Custom -> dataMapper.neededColumns.forEach(block)
+        is Custom -> nullableDataMapper.neededColumns.forEach(block)
         is Skip -> {}
     }
 

From 912cb4b7b3542bc73f1a423dd2b33fccf4a011d5 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Thu, 10 Nov 2022 11:27:02 +0800
Subject: [PATCH 24/59] Fix a bug introduced in commit
 766018989e32f9e053f3fd3e247b98502c223825 that the `TableT` reified type
 parameter is removed in `reflectionBasedSimpleClassPropertyDataMapper`

---
 .../datamapping/classproperty/SimpleClassPropertyMapping.kt    | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/SimpleClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/SimpleClassPropertyMapping.kt
index dd62948..8dcf713 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/SimpleClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/SimpleClassPropertyMapping.kt
@@ -33,7 +33,8 @@ interface ReflectionBasedSimpleClassPropertyDataMapper<Data : Any> : SimpleDataM
     }
 }
 
-inline fun <reified Data : Any> reflectionBasedSimpleClassPropertyDataMapper(table: Table): ReflectionBasedSimpleClassPropertyDataMapper<Data> =
+// The `TableT` reified type parameter is passed to the functions called and should not be removed.
+inline fun <reified Data : Any, reified TableT : Table> reflectionBasedSimpleClassPropertyDataMapper(table: TableT): ReflectionBasedSimpleClassPropertyDataMapper<Data> =
     object : ReflectionBasedSimpleClassPropertyDataMapper<Data> {
         private val clazz = Data::class
 

From bd444b77f5169537df840aea34d5b0435e4a9372 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Thu, 10 Nov 2022 17:35:33 +0800
Subject: [PATCH 25/59] Add the `propertyColumnMappingConfigMapOverride`
 argument in the overloaded functions `reflectionBasedClassPropertyDataMapper`

---
 .../classproperty/ClassPropertyMapping.kt            | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
index 89cb132..79cd8bf 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
@@ -344,8 +344,8 @@ fun <T : Any> KClass<T>.sealedLeafSubclasses(): List<KClass<out T>> =
 fun <Data : Any> getDefaultClassPropertyColumnMappings(
     clazz: KClass<Data>,
     tables: List<Table>, onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST,
-    customMappings: PropertyColumnMappings<Data> = emptyList(),
-    propertyColumnMappingConfigMapOverride: PropertyColumnMappingConfigMap<Data> = emptyMap()
+    propertyColumnMappingConfigMapOverride: PropertyColumnMappingConfigMap<Data> = emptyMap(),
+    customMappings: PropertyColumnMappings<Data> = emptyList()
 ): ClassPropertyColumnMappings<Data> =
     getDefaultClassPropertyColumnMappings(
         clazz,
@@ -528,16 +528,20 @@ fun ClassPropertyColumnMappings<*>.getColumnSet(): Set<Column<*>> =
 inline fun <reified Data : Any> reflectionBasedClassPropertyDataMapper(
     tables: List<Table>,
     onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST,
+    propertyColumnMappingConfigMapOverride: PropertyColumnMappingConfigMap<Data> = emptyMap(),
     customMappings: PropertyColumnMappings<Data> = emptyList()
 ): ReflectionBasedClassPropertyDataMapper<Data> {
     val clazz = Data::class
     return ReflectionBasedClassPropertyDataMapper(
-        clazz, getDefaultClassPropertyColumnMappings(clazz, tables, onDuplicateColumnPropertyNames, customMappings)
+        clazz, getDefaultClassPropertyColumnMappings(
+            clazz, tables, onDuplicateColumnPropertyNames, propertyColumnMappingConfigMapOverride, customMappings
+        )
     )
 }
 
 inline fun <reified Data : Any/*, TableT : Table*/> reflectionBasedClassPropertyDataMapper(
     table: Table,
+    propertyColumnMappingConfigMapOverride: PropertyColumnMappingConfigMap<Data> = emptyMap(),
     customMappings: PropertyColumnMappings<Data> = emptyList()
 ) =
-    reflectionBasedClassPropertyDataMapper(listOf(table), THROW, customMappings)
+    reflectionBasedClassPropertyDataMapper(listOf(table), THROW, propertyColumnMappingConfigMapOverride, customMappings)

From 89064be91e0f83bceec6b95a19b206c1dcaf746c Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 11 Nov 2022 17:24:41 +0800
Subject: [PATCH 26/59] Move `areElementsDistinct` into the `commonMain` source
 set

---
 .../kotlin/com/huanshankeji/collections/Collections.kt            | 0
 1 file changed, 0 insertions(+), 0 deletions(-)
 rename core/src/{jvmMain => commonMain}/kotlin/com/huanshankeji/collections/Collections.kt (100%)

diff --git a/core/src/jvmMain/kotlin/com/huanshankeji/collections/Collections.kt b/core/src/commonMain/kotlin/com/huanshankeji/collections/Collections.kt
similarity index 100%
rename from core/src/jvmMain/kotlin/com/huanshankeji/collections/Collections.kt
rename to core/src/commonMain/kotlin/com/huanshankeji/collections/Collections.kt

From c05a4d6e9c877a4bc77f15fe72d7f8bbca88c33a Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 11 Nov 2022 18:03:58 +0800
Subject: [PATCH 27/59] Add `List<T>.eachCount`

---
 .../kotlin/com/huanshankeji/collections/Collections.kt       | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/core/src/commonMain/kotlin/com/huanshankeji/collections/Collections.kt b/core/src/commonMain/kotlin/com/huanshankeji/collections/Collections.kt
index e4ec1aa..f46d8bd 100644
--- a/core/src/commonMain/kotlin/com/huanshankeji/collections/Collections.kt
+++ b/core/src/commonMain/kotlin/com/huanshankeji/collections/Collections.kt
@@ -3,3 +3,8 @@ package com.huanshankeji.collections
 fun List<*>.areElementsDistinct() =
     // There is a more efficient implementation.
     distinct().size == size
+
+fun <T> List<T>.eachCount() =
+    groupBy { it }.mapValues { it.value.size }
+// This is tested to be faster than the implementation below in some scenarios.
+//groupingBy { it }.eachCount()

From 4dc202ef6471f07cef482d9b239ce149951ea3d9 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 30 Dec 2022 00:04:45 +0800
Subject: [PATCH 28/59] Bump the Gradle Wrapper to 7.6

---
 gradle/wrapper/gradle-wrapper.jar        | Bin 60756 -> 61574 bytes
 gradle/wrapper/gradle-wrapper.properties |   3 ++-
 gradlew                                  |  12 ++++++++----
 gradlew.bat                              |   1 +
 4 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar
index 249e5832f090a2944b7473328c07c9755baa3196..943f0cbfa754578e88a3dae77fce6e3dea56edbf 100644
GIT binary patch
delta 36524
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

delta 35766
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%0DG<S^qW!A-@`soL|Nd&|btslc<LhQ&mX>K?7GHTj
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
VwlMN}`%er%aGR6olj~j${vQ;P=LY})

diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 8fad3f5..2b22d05 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,5 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.5.1-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.6-all.zip
+networkTimeout=10000
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
diff --git a/gradlew b/gradlew
index a69d9cb..65dcd68 100755
--- a/gradlew
+++ b/gradlew
@@ -55,7 +55,7 @@
 #       Darwin, MinGW, and NonStop.
 #
 #   (3) This script is generated from the Groovy template
-#       https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       https://github.com/gradle/gradle/blob/HEAD/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
 #       within the Gradle project.
 #
 #       You can find Gradle at https://github.com/gradle/gradle/.
@@ -80,10 +80,10 @@ do
     esac
 done
 
-APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
-
-APP_NAME="Gradle"
+# This is normally unused
+# shellcheck disable=SC2034
 APP_BASE_NAME=${0##*/}
+APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
 
 # Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
 DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
@@ -143,12 +143,16 @@ fi
 if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
     case $MAX_FD in #(
       max*)
+        # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC3045 
         MAX_FD=$( ulimit -H -n ) ||
             warn "Could not query maximum file descriptor limit"
     esac
     case $MAX_FD in  #(
       '' | soft) :;; #(
       *)
+        # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+        # shellcheck disable=SC3045 
         ulimit -n "$MAX_FD" ||
             warn "Could not set maximum file descriptor limit to $MAX_FD"
     esac
diff --git a/gradlew.bat b/gradlew.bat
index f127cfd..93e3f59 100644
--- a/gradlew.bat
+++ b/gradlew.bat
@@ -26,6 +26,7 @@ if "%OS%"=="Windows_NT" setlocal
 
 set DIRNAME=%~dp0
 if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
 set APP_BASE_NAME=%~n0
 set APP_HOME=%DIRNAME%
 

From 56c771effe5097c0fffc2c56d8ad6a2c02b993b1 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 30 Dec 2022 00:12:41 +0800
Subject: [PATCH 29/59] Bump Kotlin to 1.8.0 and run `:kotlinUpgradeYarnLock`
 as requested

---
 buildSrc/build.gradle.kts |  2 +-
 kotlin-js-store/yarn.lock | 31 ++++++++++++++++++-------------
 2 files changed, 19 insertions(+), 14 deletions(-)

diff --git a/buildSrc/build.gradle.kts b/buildSrc/build.gradle.kts
index 0201cf4..e577198 100644
--- a/buildSrc/build.gradle.kts
+++ b/buildSrc/build.gradle.kts
@@ -15,7 +15,7 @@ repositories {
 }
 
 dependencies {
-    implementation(kotlin("gradle-plugin", "1.7.10"))
+    implementation(kotlin("gradle-plugin", "1.8.0"))
     implementation("com.huanshankeji:common-gradle-dependencies:0.3.2-20220728")
     implementation("com.huanshankeji.team:gradle-plugins:0.3.2")
 }
diff --git a/kotlin-js-store/yarn.lock b/kotlin-js-store/yarn.lock
index 635b33e..e741ac5 100644
--- a/kotlin-js-store/yarn.lock
+++ b/kotlin-js-store/yarn.lock
@@ -229,11 +229,16 @@ acorn-import-assertions@^1.7.6:
   resolved "https://registry.yarnpkg.com/acorn-import-assertions/-/acorn-import-assertions-1.8.0.tgz#ba2b5939ce62c238db6d93d81c9b111b29b855e9"
   integrity sha512-m7VZ3jwz4eK6A4Vtt8Ew1/mNbP24u0FhdyfA7fSvnJR6LMdfOYnmuIrrJAgrYfYJ10F/otaHTtrtrtmHdMNzEw==
 
-acorn@^8.4.1, acorn@^8.5.0:
+acorn@^8.5.0:
   version "8.7.1"
   resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.7.1.tgz#0197122c843d1bf6d0a5e83220a788f278f63c30"
   integrity sha512-Xx54uLJQZ19lKygFXOWsscKUbsBZW0CPykPhVQdhIeIwrbPmJzqeASDInc8nKBnp/JT6igTs82qPXz069H8I/A==
 
+acorn@^8.7.1:
+  version "8.8.1"
+  resolved "https://registry.yarnpkg.com/acorn/-/acorn-8.8.1.tgz#0a3f9cbecc4ec3bea6f0a80b66ae8dd2da250b73"
+  integrity sha512-7zFpHzhnqYKrkYdUjF1HI1bzd0VygEGX8lFk4k5zVMqHEoES+P+7TKI+EvLO9WVMJ8eekdO0aDEK044xTXwPPA==
+
 ajv-keywords@^3.5.2:
   version "3.5.2"
   resolved "https://registry.yarnpkg.com/ajv-keywords/-/ajv-keywords-3.5.2.tgz#31f29da5ab6e00d1c2d329acf7b5929614d5014d"
@@ -598,10 +603,10 @@ engine.io@~6.2.0:
     engine.io-parser "~5.0.3"
     ws "~8.2.3"
 
-enhanced-resolve@^5.9.3:
-  version "5.10.0"
-  resolved "https://registry.yarnpkg.com/enhanced-resolve/-/enhanced-resolve-5.10.0.tgz#0dc579c3bb2a1032e357ac45b8f3a6f3ad4fb1e6"
-  integrity sha512-T0yTFjdpldGY8PmuXXR0PyQ1ufZpEGiHVrp7zHKB7jdR4qlmZHhONVM5AQOAWXuF/w3dnHbEQVrNptJgt7F+cQ==
+enhanced-resolve@^5.10.0:
+  version "5.12.0"
+  resolved "https://registry.yarnpkg.com/enhanced-resolve/-/enhanced-resolve-5.12.0.tgz#300e1c90228f5b570c4d35babf263f6da7155634"
+  integrity sha512-QHTXI/sZQmko1cbDoNAa3mJ5qhWUUNAq3vR0/YiD379fWQrcfuoX1+HW2S0MTt7XmoPLapdaDKUtelUSPic7hQ==
   dependencies:
     graceful-fs "^4.2.4"
     tapable "^2.2.0"
@@ -1720,7 +1725,7 @@ void-elements@^2.0.0:
   resolved "https://registry.yarnpkg.com/void-elements/-/void-elements-2.0.1.tgz#c066afb582bb1cb4128d60ea92392e94d5e9dbec"
   integrity sha1-wGavtYK7HLQSjWDqkjkulNXp2+w=
 
-watchpack@^2.3.1:
+watchpack@^2.4.0:
   version "2.4.0"
   resolved "https://registry.yarnpkg.com/watchpack/-/watchpack-2.4.0.tgz#fa33032374962c78113f93c7f2fb4c54c9862a5d"
   integrity sha512-Lcvm7MGST/4fup+ifyKi2hjyIAwcdI4HRgtvTpIUxBRhB+RFtUh8XtDOxUfctVCnhVi+QQj49i91OyvzkJl6cg==
@@ -1771,21 +1776,21 @@ webpack-sources@^3.2.3:
   resolved "https://registry.yarnpkg.com/webpack-sources/-/webpack-sources-3.2.3.tgz#2d4daab8451fd4b240cc27055ff6a0c2ccea0cde"
   integrity sha512-/DyMEOrDgLKKIG0fmvtz+4dUX/3Ghozwgm6iPp8KRhvn+eQf9+Q7GWxVNMk3+uCPWfdXYC4ExGBckIXdFEfH1w==
 
-webpack@5.73.0:
-  version "5.73.0"
-  resolved "https://registry.yarnpkg.com/webpack/-/webpack-5.73.0.tgz#bbd17738f8a53ee5760ea2f59dce7f3431d35d38"
-  integrity sha512-svjudQRPPa0YiOYa2lM/Gacw0r6PvxptHj4FuEKQ2kX05ZLkjbVc5MnPs6its5j7IZljnIqSVo/OsY2X0IpHGA==
+webpack@5.74.0:
+  version "5.74.0"
+  resolved "https://registry.yarnpkg.com/webpack/-/webpack-5.74.0.tgz#02a5dac19a17e0bb47093f2be67c695102a55980"
+  integrity sha512-A2InDwnhhGN4LYctJj6M1JEaGL7Luj6LOmyBHjcI8529cm5p6VXiTIW2sn6ffvEAKmveLzvu4jrihwXtPojlAA==
   dependencies:
     "@types/eslint-scope" "^3.7.3"
     "@types/estree" "^0.0.51"
     "@webassemblyjs/ast" "1.11.1"
     "@webassemblyjs/wasm-edit" "1.11.1"
     "@webassemblyjs/wasm-parser" "1.11.1"
-    acorn "^8.4.1"
+    acorn "^8.7.1"
     acorn-import-assertions "^1.7.6"
     browserslist "^4.14.5"
     chrome-trace-event "^1.0.2"
-    enhanced-resolve "^5.9.3"
+    enhanced-resolve "^5.10.0"
     es-module-lexer "^0.9.0"
     eslint-scope "5.1.1"
     events "^3.2.0"
@@ -1798,7 +1803,7 @@ webpack@5.73.0:
     schema-utils "^3.1.0"
     tapable "^2.1.1"
     terser-webpack-plugin "^5.1.3"
-    watchpack "^2.3.1"
+    watchpack "^2.4.0"
     webpack-sources "^3.2.3"
 
 whatwg-url@^7.0.0:

From affa11d007194d2be01c0a6f5cdd17d428ac345c Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 30 Dec 2022 23:01:27 +0800
Subject: [PATCH 30/59] Use
 `com.huanshankeji.team:gradle-plugins:0.4.0-SNAPSHOT` and bump to
 `com.huanshankeji:common-gradle-dependencies:0.3.3-20221230-SNAPSHOT`

---
 buildSrc/build.gradle.kts                                     | 4 ++--
 buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts | 3 ++-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/buildSrc/build.gradle.kts b/buildSrc/build.gradle.kts
index e577198..5417c8f 100644
--- a/buildSrc/build.gradle.kts
+++ b/buildSrc/build.gradle.kts
@@ -16,6 +16,6 @@ repositories {
 
 dependencies {
     implementation(kotlin("gradle-plugin", "1.8.0"))
-    implementation("com.huanshankeji:common-gradle-dependencies:0.3.2-20220728")
-    implementation("com.huanshankeji.team:gradle-plugins:0.3.2")
+    implementation("com.huanshankeji:common-gradle-dependencies:0.3.3-20221230-SNAPSHOT") // TODO: don't use a snapshot version in a main branch
+    implementation("com.huanshankeji.team:gradle-plugins:0.4.0-SNAPSHOT") // TODO: don't use a snapshot version in a main branch
 }
diff --git a/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts b/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts
index 4cd74ed..e94bc49 100644
--- a/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts
+++ b/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts
@@ -1,5 +1,6 @@
 plugins {
     id("common-conventions-before")
-    id("com.huanshankeji.kotlin-multiplatform-jvm-and-js-browser-sonatype-ossrh-publish-conventions")
+    id("com.huanshankeji.kotlin-multiplatform-sonatype-ossrh-publish-conventions")
+    id("com.huanshankeji.kotlin-multiplatform-jvm-and-js-browser-conventions")
     id("common-conventions-after")
 }

From 3137f09544d744e49a05ce952e5edad0a5b85568 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Mon, 16 Jan 2023 21:08:57 +0800
Subject: [PATCH 31/59] Adapt to the latest snapshot version of
 "com.huanshankeji.team:gradle-plugins:0.4.0-SNAPSHOT" and set
 `java.toolchain.languageVersion`

---
 buildSrc/src/main/kotlin/jvm-conventions.gradle.kts | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/buildSrc/src/main/kotlin/jvm-conventions.gradle.kts b/buildSrc/src/main/kotlin/jvm-conventions.gradle.kts
index 1562049..afde798 100644
--- a/buildSrc/src/main/kotlin/jvm-conventions.gradle.kts
+++ b/buildSrc/src/main/kotlin/jvm-conventions.gradle.kts
@@ -3,3 +3,5 @@ plugins {
     id("com.huanshankeji.kotlin-jvm-library-sonatype-ossrh-publish-conventions")
     id("common-conventions-after")
 }
+
+java.toolchain.languageVersion.set(JavaLanguageVersion.of(8))

From 15a52f2ac26a5dc2183272550bc99354263721aa Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Sat, 21 Jan 2023 00:12:23 +0800
Subject: [PATCH 32/59] Add the Kotlin version badge

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index d47c896..ebbb984 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,7 @@
 # Huanshankeji Kotlin Common
 
 [![Maven Central](https://img.shields.io/maven-central/v/com.huanshankeji/kotlin-common-core)](https://search.maven.org/search?q=g:com.huanshankeji%20a:kotlin-common-*)
+![Kotlin version](https://kotlin-version.aws.icerock.dev/kotlin-version?group=com.huanshankeji&name=kotlin-common-core)
 
 Huanshankeji's common code libraries in Kotlin
 

From 6e1bbcbfe13c170036057042775b6a89f1079cc9 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 10 Feb 2023 20:06:55 +0800
Subject: [PATCH 33/59] Add the `Dispatchers.Unconfined` argument to Coroutine
 `launch`s in `Route.handler`s to reduce the context switching overhead

For detailed benchmark results, check out <https://github.com/huanshankeji/FrameworkBenchmarks/commit/030ce1b14d1838784c1ccd2fd94f14446f693b3f> and run the Plaintext test with or without `Dispatchers.Unconfined`.
---
 .../huanshankeji/vertx/kotlin/coroutines/VertxCoroutine.kt   | 2 +-
 .../vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt     | 3 ++-
 .../coroutines/ext/web/ExtendedWebCoroutineVerticle.kt       | 5 +++--
 .../vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt     | 3 ++-
 4 files changed, 8 insertions(+), 5 deletions(-)

diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/VertxCoroutine.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/VertxCoroutine.kt
index de6aa31..a373e43 100644
--- a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/VertxCoroutine.kt
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/VertxCoroutine.kt
@@ -39,7 +39,7 @@ suspend fun <T> Vertx.awaitExecuteBlocking(blockingCode: () -> T): T =
 @Deprecated("This implementation is buggy. See https://github.com/vert-x3/vertx-lang-kotlin/pull/222/commits/fc3c5c5cc0c572eaddb3c2c37d07c696f75b4443#diff-162b76dc534138518a237d9a8ed527f1b3ecaca67385ea7d4357b6eff203f699R138-R217 for a fixed proposed version.")
 suspend fun <T> Vertx.awaitSuspendExecuteBlocking(blockingCode: suspend () -> T): T =
     coroutineScope {
-        executeBlocking<T> {
+        executeBlocking {
             launch { it.complete(blockingCode()) }
         }.await()
     }
diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt
index d9c5b07..93d1159 100644
--- a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt
@@ -4,6 +4,7 @@ import com.huanshankeji.vertx.ext.web.checkedRun
 import io.vertx.ext.web.Route
 import io.vertx.ext.web.RoutingContext
 import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 
 // workaround for context receivers
@@ -11,7 +12,7 @@ fun coroutineHandler(
     coroutineScope: CoroutineScope, route: Route,
     requestHandler: suspend (RoutingContext) -> Unit
 ): Route =
-    route.handler { coroutineScope.launch { requestHandler(it) } }
+    route.handler { coroutineScope.launch(Dispatchers.Unconfined) { requestHandler(it) } }
 
 // workaround for context receivers
 fun checkedCoroutineHandler(
diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticle.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticle.kt
index d890ad0..e1dd7a6 100644
--- a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticle.kt
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticle.kt
@@ -5,6 +5,7 @@ import com.huanshankeji.vertx.kotlin.coroutines.CoroutineVerticleI
 import io.vertx.ext.web.Route
 import io.vertx.ext.web.RoutingContext
 import io.vertx.kotlin.coroutines.CoroutineVerticle
+import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 
 interface ExtendedWebCoroutineVerticleI : CoroutineVerticleI {
@@ -12,7 +13,7 @@ interface ExtendedWebCoroutineVerticleI : CoroutineVerticleI {
      * Like [Route.handler] but with a suspend function as [requestHandler].
      */
     fun Route.coroutineHandler(requestHandler: suspend (RoutingContext) -> Unit): Route =
-        handler { launch { requestHandler(it) } }
+        handler { launch(Dispatchers.Unconfined) { requestHandler(it) } }
 
     /**
      * Like [coroutineHandler] and calls [RoutingContext.fail] if a [Throwable] is thrown in [requestHandler].
@@ -27,7 +28,7 @@ abstract class ExtendedWebCoroutineVerticle : CoroutineVerticle(), ExtendedWebCo
      * which might be slightly faster but can also make the stack trace difficult to debug.
      */
     inline fun Route.coroutineHandlerInline(crossinline requestHandler: suspend (RoutingContext) -> Unit): Route =
-        handler { launch { requestHandler(it) } }
+        handler { launch(Dispatchers.Unconfined) { requestHandler(it) } }
 
     /**
      * The inline version of [checkedCoroutineHandler],
diff --git a/vertx/with-context-receivers/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt b/vertx/with-context-receivers/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt
index 5ae1586..1ac8581 100644
--- a/vertx/with-context-receivers/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt
+++ b/vertx/with-context-receivers/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt
@@ -4,6 +4,7 @@ import com.huanshankeji.vertx.ext.web.checkedRun
 import io.vertx.ext.web.Route
 import io.vertx.ext.web.RoutingContext
 import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 
 /**
@@ -11,7 +12,7 @@ import kotlinx.coroutines.launch
  */
 context(CoroutineScope, Route)
 fun coroutineHandler(requestHandler: suspend (RoutingContext) -> Unit): Route =
-    handler { launch { requestHandler(it) } }
+    handler { launch(Dispatchers.Unconfined) { requestHandler(it) } }
 
 /**
  * Like [coroutineHandler] and calls [RoutingContext.fail] if a [Throwable] is thrown in [requestHandler].

From 25fa7b2299308b9013bcbd684eb25fc648ef3352 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Sat, 11 Feb 2023 16:25:44 +0800
Subject: [PATCH 34/59] Remove a redundant inferred type parameter

---
 .../com/huanshankeji/vertx/kotlin/coroutines/VertxCoroutine.kt  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/VertxCoroutine.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/VertxCoroutine.kt
index a373e43..a342c86 100644
--- a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/VertxCoroutine.kt
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/VertxCoroutine.kt
@@ -28,7 +28,7 @@ suspend inline fun <R> Vertx.use(block: (Vertx) -> R): R =
  * [blockingCode] returns the result when the operation completes instead of calling [Promise.complete].
  */
 suspend fun <T> Vertx.awaitExecuteBlocking(blockingCode: () -> T): T =
-    executeBlocking<T> {
+    executeBlocking {
         it.complete(blockingCode())
     }.await()
 

From b677b9dee457dded36b3b7f46c4e88e0c0b1e62e Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Mon, 13 Feb 2023 22:42:53 +0800
Subject: [PATCH 35/59] Add the `CoroutineHandlerLaunchMode` argument in
 coroutine handler functions and add tests for it

---
 .../coroutines/ext/web/CoroutineHandlers.kt   | 59 +++++++++++++++++--
 .../ext/web/ExtendedWebCoroutineVerticle.kt   | 20 +++++--
 .../ext/web/CoroutineHandlersTest.kt          | 54 +++++++++++++++++
 .../web/ExtendedWebCoroutineVerticleTest.kt   | 16 ++---
 4 files changed, 130 insertions(+), 19 deletions(-)
 create mode 100644 vertx/src/test/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlersTest.kt

diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt
index 93d1159..3cb2dac 100644
--- a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlers.kt
@@ -1,22 +1,71 @@
 package com.huanshankeji.vertx.kotlin.coroutines.ext.web
 
 import com.huanshankeji.vertx.ext.web.checkedRun
+import com.huanshankeji.vertx.kotlin.coroutines.ext.web.CoroutineHandlerLaunchMode.DefaultOnVertxEventLoop
+import com.huanshankeji.vertx.kotlin.coroutines.ext.web.CoroutineHandlerLaunchMode.Unconfined
 import io.vertx.ext.web.Route
 import io.vertx.ext.web.RoutingContext
-import kotlinx.coroutines.CoroutineScope
-import kotlinx.coroutines.Dispatchers
-import kotlinx.coroutines.launch
+import io.vertx.kotlin.coroutines.CoroutineVerticle
+import kotlinx.coroutines.*
+import kotlin.coroutines.CoroutineContext
+import kotlin.coroutines.EmptyCoroutineContext
+
+private fun coroutineHandler(
+    coroutineScope: CoroutineScope, route: Route,
+    context: CoroutineContext, start: CoroutineStart,
+    requestHandler: suspend (RoutingContext) -> Unit
+): Route =
+    route.handler { coroutineScope.launch(context, start) { requestHandler(it) } }
+
+/**
+ * @see CoroutineContext
+ * @see Dispatchers
+ * @see CoroutineStart
+ */
+enum class CoroutineHandlerLaunchMode {
+    /**
+     * In this mode, the coroutine is launched in a [CoroutineScope] probably with a [CoroutineDispatcher]
+     * (such as a [CoroutineVerticle])
+     * with the arguments [EmptyCoroutineContext] and [CoroutineStart.UNDISPATCHED].
+     * After calling a suspending function that doesn't resume on the Vert.x event loop by default
+     * (especially and mainly non-Vert.x functions, such as [delay]),
+     * the coroutine is redispatched to the Vert.x event loop.
+     */
+    DefaultOnVertxEventLoop,
+
+    /**
+     * In this mode, the coroutine is launched with the argument [Dispatchers.Unconfined].
+     * After calling a suspending function that doesn't resume on the Vert.x event loop by default,
+     * the coroutine is not redispatched to the Vert.x event loop.
+     *
+     * It reduces the context (thread) switching overhead and provides slightly better performance in cases when handler code is light.
+     * It's recommend when all the suspending functions called in the handler are Vert.x functions.
+     *
+     * As tested with the vertx-web-kotlinx portion of TechEmpower Framework Benchmarks, [Dispatchers.Unconfined] greatly improves the performance of the Plaintext test.
+     * See <https://github.com/huanshankeji/FrameworkBenchmarks/commit/030ce1b14d1838784c1ccd2fd94f14446f693b3f> for more details.
+     */
+    Unconfined
+}
 
 // workaround for context receivers
 fun coroutineHandler(
     coroutineScope: CoroutineScope, route: Route,
+    launchMode: CoroutineHandlerLaunchMode = DefaultOnVertxEventLoop,
     requestHandler: suspend (RoutingContext) -> Unit
 ): Route =
-    route.handler { coroutineScope.launch(Dispatchers.Unconfined) { requestHandler(it) } }
+    coroutineHandler(
+        coroutineScope, route,
+        when (launchMode) {
+            DefaultOnVertxEventLoop -> EmptyCoroutineContext
+            Unconfined -> Dispatchers.Unconfined
+        },
+        CoroutineStart.UNDISPATCHED, requestHandler
+    )
 
 // workaround for context receivers
 fun checkedCoroutineHandler(
     coroutineScope: CoroutineScope, route: Route,
+    launchMode: CoroutineHandlerLaunchMode = DefaultOnVertxEventLoop,
     requestHandler: suspend (RoutingContext) -> Unit
 ): Route =
-    coroutineHandler(coroutineScope, route) { ctx -> ctx.checkedRun { requestHandler(ctx) } }
+    coroutineHandler(coroutineScope, route, launchMode) { ctx -> ctx.checkedRun { requestHandler(ctx) } }
diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticle.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticle.kt
index e1dd7a6..ecfa171 100644
--- a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticle.kt
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticle.kt
@@ -2,33 +2,41 @@ package com.huanshankeji.vertx.kotlin.coroutines.ext.web
 
 import com.huanshankeji.vertx.ext.web.checkedRun
 import com.huanshankeji.vertx.kotlin.coroutines.CoroutineVerticleI
+import com.huanshankeji.vertx.kotlin.coroutines.ext.web.CoroutineHandlerLaunchMode.DefaultOnVertxEventLoop
 import io.vertx.ext.web.Route
 import io.vertx.ext.web.RoutingContext
 import io.vertx.kotlin.coroutines.CoroutineVerticle
-import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.launch
 
 interface ExtendedWebCoroutineVerticleI : CoroutineVerticleI {
     /**
      * Like [Route.handler] but with a suspend function as [requestHandler].
      */
-    fun Route.coroutineHandler(requestHandler: suspend (RoutingContext) -> Unit): Route =
-        handler { launch(Dispatchers.Unconfined) { requestHandler(it) } }
+    fun Route.coroutineHandler(
+        launchMode: CoroutineHandlerLaunchMode = DefaultOnVertxEventLoop,
+        requestHandler: suspend (RoutingContext) -> Unit
+    ): Route =
+        coroutineHandler(this@ExtendedWebCoroutineVerticleI, this, launchMode, requestHandler)
 
     /**
      * Like [coroutineHandler] and calls [RoutingContext.fail] if a [Throwable] is thrown in [requestHandler].
      */
-    fun Route.checkedCoroutineHandler(requestHandler: suspend (RoutingContext) -> Unit): Route =
-        coroutineHandler { ctx -> ctx.checkedRun { requestHandler(ctx) } }
+    fun Route.checkedCoroutineHandler(
+        launchMode: CoroutineHandlerLaunchMode = DefaultOnVertxEventLoop,
+        requestHandler: suspend (RoutingContext) -> Unit
+    ): Route =
+        checkedCoroutineHandler(this@ExtendedWebCoroutineVerticleI, this, launchMode, requestHandler)
 }
 
 abstract class ExtendedWebCoroutineVerticle : CoroutineVerticle(), ExtendedWebCoroutineVerticleI {
+    // TODO: `launchMode: CoroutineHandlerLaunchMode` is not supported in these inline versions yet
+
     /**
      * The inline version of [coroutineHandler],
      * which might be slightly faster but can also make the stack trace difficult to debug.
      */
     inline fun Route.coroutineHandlerInline(crossinline requestHandler: suspend (RoutingContext) -> Unit): Route =
-        handler { launch(Dispatchers.Unconfined) { requestHandler(it) } }
+        handler { launch { requestHandler(it) } }
 
     /**
      * The inline version of [checkedCoroutineHandler],
diff --git a/vertx/src/test/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlersTest.kt b/vertx/src/test/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlersTest.kt
new file mode 100644
index 0000000..258d0f5
--- /dev/null
+++ b/vertx/src/test/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/CoroutineHandlersTest.kt
@@ -0,0 +1,54 @@
+package com.huanshankeji.vertx.kotlin.coroutines.ext.web
+
+import com.huanshankeji.kotlin.use
+import com.huanshankeji.vertx.VertxBaseTest
+import com.huanshankeji.vertx.kotlin.coroutines.ext.web.CoroutineHandlerLaunchMode.DefaultOnVertxEventLoop
+import com.huanshankeji.vertx.kotlin.coroutines.ext.web.CoroutineHandlerLaunchMode.Unconfined
+import io.vertx.ext.web.Router
+import io.vertx.ext.web.client.WebClient
+import io.vertx.kotlin.coroutines.await
+import io.vertx.kotlin.coroutines.dispatcher
+import io.vertx.kotlin.ext.web.client.webClientOptionsOf
+import kotlinx.coroutines.delay
+import kotlinx.coroutines.test.runTest
+import kotlinx.coroutines.withContext
+import kotlin.test.Test
+
+class CoroutineHandlersTest : VertxBaseTest() {
+    companion object {
+        val DEFAULT_PATH = "/default"
+        val UNCONFINED_PATH = "/unconfined"
+    }
+
+    @Test
+    fun `test checkedCoroutineHandler`() = runTest {
+        val vertx = vertx
+        withContext(vertx.dispatcher()) {
+            val httpServer = vertx.createHttpServer().requestHandler(Router.router(vertx).apply {
+                fun isOnVertxEventLoop() =
+                    Thread.currentThread().name.contains("vert.x-eventloop-thread-")
+
+                fun isOnDefaultExecutor() =
+                    Thread.currentThread().name.contains("kotlinx.coroutines.DefaultExecutor")
+
+                coroutineHandler(this@withContext, get(DEFAULT_PATH), DefaultOnVertxEventLoop) {
+                    assert(isOnVertxEventLoop())
+                    delay(1)
+                    assert(isOnVertxEventLoop())
+                    it.response().end()
+                }
+                coroutineHandler(this@withContext, get(UNCONFINED_PATH), Unconfined) {
+                    assert(isOnVertxEventLoop())
+                    delay(1)
+                    assert(isOnDefaultExecutor())
+                    it.response().end()
+                }
+            }).listen(0).await()
+
+            WebClient.create(vertx, webClientOptionsOf(defaultPort = httpServer.actualPort())).use({ webClient ->
+                webClient.get(DEFAULT_PATH).send().await()
+                webClient.get(UNCONFINED_PATH).send().await()
+            }, { close().await() })
+        }
+    }
+}
\ No newline at end of file
diff --git a/vertx/src/test/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticleTest.kt b/vertx/src/test/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticleTest.kt
index c7912e7..8233fd4 100644
--- a/vertx/src/test/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticleTest.kt
+++ b/vertx/src/test/kotlin/com/huanshankeji/vertx/kotlin/coroutines/ext/web/ExtendedWebCoroutineVerticleTest.kt
@@ -14,7 +14,7 @@ import kotlin.test.assertEquals
 
 class ExtendedWebCoroutineVerticleTest : VertxBaseTest() {
     companion object {
-        object MethodNames {
+        object MemberFunctionNames {
             const val coroutineHandler = "coroutineHandler"
             const val coroutineHandlerInline = "coroutineHandlerInline"
             const val checkedCoroutineHandler = "checkedCoroutineHandler"
@@ -34,11 +34,11 @@ class ExtendedWebCoroutineVerticleTest : VertxBaseTest() {
                         it.end()
                     }
 
-                    with(MethodNames) {
-                        get("/$coroutineHandler").coroutineHandler(handler)
-                        get("/$coroutineHandlerInline").coroutineHandlerInline(handler)
-                        get("/$checkedCoroutineHandler").checkedCoroutineHandler(handler)
-                        get("/$checkedCoroutineHandlerInline").checkedCoroutineHandlerInline(handler)
+                    with(MemberFunctionNames) {
+                        get("/$coroutineHandler").coroutineHandler(requestHandler = handler)
+                        get("/$coroutineHandlerInline").coroutineHandlerInline(requestHandler = handler)
+                        get("/$checkedCoroutineHandler").checkedCoroutineHandler(requestHandler = handler)
+                        get("/$checkedCoroutineHandlerInline").checkedCoroutineHandlerInline(requestHandler = handler)
                     }
                 })
                 .listen(0).await()
@@ -64,12 +64,12 @@ class ExtendedWebCoroutineVerticleTest : VertxBaseTest() {
                 assertEquals(500, webClient.get("/$methodName?throws=true").send().await().statusCode())
             }
 
-            with(MethodNames) {
+            with(MemberFunctionNames) {
                 listOf(coroutineHandler, coroutineHandlerInline, checkedCoroutineHandler, checkedCoroutineHandlerInline)
                     .forEach { testOk(it) }
                 listOf(checkedCoroutineHandler, checkedCoroutineHandlerInline).forEach { testThrowable(it) }
             }
-        }, { close() })
+        }, { close().await() })
 
         vertx.undeploy(deploymentId).await()
     }

From 98a062faf251c0ba52715f695c29ce8fc94ffe76 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Tue, 21 Feb 2023 22:59:40 +0800
Subject: [PATCH 36/59] Add `sort*AndExecuteBatch` functions for
 `PreparedQuery`, an `Untested` opt-in requirement annotation, and a related
 `LexicographicOrderListComparable` class and its tests

---
 .../kotlin/com/huanshankeji/Untested.kt       | 20 ++++++++++
 .../LexicographicOrderListComparable.kt       | 27 +++++++++++++
 .../LexicographicOrderListComparableTest.kt   | 26 ++++++++++++
 .../sqlclient/PreparedQueryBatchExecution.kt  | 40 +++++++++++++++++++
 4 files changed, 113 insertions(+)
 create mode 100644 core/src/commonMain/kotlin/com/huanshankeji/Untested.kt
 create mode 100644 core/src/commonMain/kotlin/com/huanshankeji/collections/LexicographicOrderListComparable.kt
 create mode 100644 core/src/commonTest/kotlin/com/huanshankeji/collections/LexicographicOrderListComparableTest.kt
 create mode 100644 vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/PreparedQueryBatchExecution.kt

diff --git a/core/src/commonMain/kotlin/com/huanshankeji/Untested.kt b/core/src/commonMain/kotlin/com/huanshankeji/Untested.kt
new file mode 100644
index 0000000..4874f85
--- /dev/null
+++ b/core/src/commonMain/kotlin/com/huanshankeji/Untested.kt
@@ -0,0 +1,20 @@
+package com.huanshankeji
+
+import kotlin.annotation.AnnotationTarget.*
+
+@RequiresOptIn("This API is untested.", RequiresOptIn.Level.WARNING)
+@Retention(AnnotationRetention.BINARY)
+// The ones commented out are what I think may be used in very few use cases.
+@Target(
+    CLASS,
+    //ANNOTATION_CLASS,
+    PROPERTY,
+    //FIELD,
+    //VALUE_PARAMETER,
+    CONSTRUCTOR,
+    FUNCTION,
+    PROPERTY_GETTER,
+    PROPERTY_SETTER,
+    //TYPEALIAS
+)
+annotation class Untested
\ No newline at end of file
diff --git a/core/src/commonMain/kotlin/com/huanshankeji/collections/LexicographicOrderListComparable.kt b/core/src/commonMain/kotlin/com/huanshankeji/collections/LexicographicOrderListComparable.kt
new file mode 100644
index 0000000..8d0c73c
--- /dev/null
+++ b/core/src/commonMain/kotlin/com/huanshankeji/collections/LexicographicOrderListComparable.kt
@@ -0,0 +1,27 @@
+package com.huanshankeji.collections
+
+class LexicographicOrderListComparable<E : Comparable<E>> internal constructor(val list: List<E>) :
+    Comparable<LexicographicOrderListComparable<E>> {
+    override fun compareTo(other: LexicographicOrderListComparable<E>): Int {
+        val otherList = other.list
+        tailrec fun helper(index: Int): Int {
+            val a = list.getOrNull(index)
+            val b = otherList.getOrNull(index)
+            return if (a === null)
+                if (b === null) 0
+                else -1
+            else
+                if (b === null) 1
+                else {
+                    val elementCompareResult = a.compareTo(b)
+                    if (elementCompareResult != 0) elementCompareResult
+                    else helper(index + 1)
+                }
+        }
+
+        return helper(0)
+    }
+}
+
+fun <E : Comparable<E>> List<E>.lexicographicOrderComparable() =
+    LexicographicOrderListComparable(this)
diff --git a/core/src/commonTest/kotlin/com/huanshankeji/collections/LexicographicOrderListComparableTest.kt b/core/src/commonTest/kotlin/com/huanshankeji/collections/LexicographicOrderListComparableTest.kt
new file mode 100644
index 0000000..e0c59a1
--- /dev/null
+++ b/core/src/commonTest/kotlin/com/huanshankeji/collections/LexicographicOrderListComparableTest.kt
@@ -0,0 +1,26 @@
+package com.huanshankeji.collections
+
+import io.kotest.property.Arb
+import io.kotest.property.arbitrary.pair
+import io.kotest.property.arbitrary.string
+import io.kotest.property.checkAll
+import kotlinx.coroutines.ExperimentalCoroutinesApi
+import kotlinx.coroutines.test.runTest
+import kotlin.math.sign
+import kotlin.test.Test
+import kotlin.test.assertEquals
+
+class LexicographicOrderListComparableTest {
+    @Test
+    @OptIn(ExperimentalCoroutinesApi::class)
+    fun testLexicographicOrderListComparable() = runTest {
+        val stringArb = Arb.string()
+        checkAll(Arb.pair(stringArb, stringArb)) { (a, b) ->
+            assertEquals(
+                (a compareTo b).sign,
+                (a.toCharArray().asList().lexicographicOrderComparable() compareTo
+                        b.toCharArray().asList().lexicographicOrderComparable()).sign
+            )
+        }
+    }
+}
\ No newline at end of file
diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/PreparedQueryBatchExecution.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/PreparedQueryBatchExecution.kt
new file mode 100644
index 0000000..4dbdd18
--- /dev/null
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/PreparedQueryBatchExecution.kt
@@ -0,0 +1,40 @@
+package com.huanshankeji.vertx.sqlclient
+
+import com.huanshankeji.Untested
+import com.huanshankeji.collections.lexicographicOrderComparable
+import io.vertx.sqlclient.PreparedQuery
+import io.vertx.sqlclient.Tuple
+
+/**
+ * There can easily be deadlocks when batch-updating data concurrently in multiple event loops
+ * if they are overlapped and unsorted.
+ */
+@Untested
+fun <QueryResultT, DataT, SelectorResultT : Comparable<SelectorResultT>> PreparedQuery<QueryResultT>.sortDataAndExecuteBatch(
+    dataList: List<DataT>, selector: (DataT) -> SelectorResultT, toTuple: DataT.() -> Tuple
+) =
+    executeBatch(dataList.sortedBy(selector = selector).map(toTuple))
+
+
+@Untested
+inline fun <QueryResultT, SelectorResultT : Comparable<SelectorResultT>> PreparedQuery<QueryResultT>.sortTuplesAndExecuteBatch(
+    batch: List<Tuple>, crossinline selector: (Tuple) -> SelectorResultT
+) =
+    executeBatch(batch.sortedBy(selector))
+
+
+@Untested
+inline fun <QueryResultT, reified SelectorResultT : Comparable<SelectorResultT>> PreparedQuery<QueryResultT>.sortTuplesAndExecuteBatch(
+    batch: List<Tuple>, selectorPosition: Int
+) =
+    sortTuplesAndExecuteBatch(batch) { it.get(SelectorResultT::class.java, selectorPosition) }
+
+@Untested
+fun <QueryResultT> PreparedQuery<QueryResultT>.sortTuplesAndExecuteBatch(
+    batch: List<Tuple>, selectorPositions: List<Int>
+) =
+    sortTuplesAndExecuteBatch(batch) { tuple ->
+        val listSelector = selectorPositions.map { i -> tuple.getValue(i) }
+        @Suppress("UNCHECKED_CAST")
+        (listSelector as List<Comparable<Any>>).lexicographicOrderComparable()
+    }

From ad58a55f001ea281cc185b46c2979f4e17f4a5df Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Thu, 23 Feb 2023 12:16:22 +0800
Subject: [PATCH 37/59] Update the project version

---
 buildSrc/src/main/kotlin/VersionsAndDependencies.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
index cfd5e0b..49b2c3a 100644
--- a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
+++ b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
@@ -2,7 +2,7 @@ import com.huanshankeji.CommonDependencies
 import com.huanshankeji.CommonGradleClasspathDependencies
 import com.huanshankeji.CommonVersions
 
-val projectVersion = "0.2.4-SNAPSHOT"
+val projectVersion = "0.3.0-SNAPSHOT"
 
 val commonVersions = CommonVersions()
 val commonDependencies = CommonDependencies(commonVersions)

From 828ff70e986600ff4e235f360f189a1a7c451d01 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Thu, 23 Feb 2023 12:16:47 +0800
Subject: [PATCH 38/59] Update the project version

---
 buildSrc/src/main/kotlin/VersionsAndDependencies.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
index cfd5e0b..49b2c3a 100644
--- a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
+++ b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
@@ -2,7 +2,7 @@ import com.huanshankeji.CommonDependencies
 import com.huanshankeji.CommonGradleClasspathDependencies
 import com.huanshankeji.CommonVersions
 
-val projectVersion = "0.2.4-SNAPSHOT"
+val projectVersion = "0.3.0-SNAPSHOT"
 
 val commonVersions = CommonVersions()
 val commonDependencies = CommonDependencies(commonVersions)

From 40da07dece65e08900798b8579dd4356d1513182 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Thu, 23 Feb 2023 12:25:11 +0800
Subject: [PATCH 39/59] Update the project snapshot version to distinguish from
 other branches

---
 buildSrc/src/main/kotlin/VersionsAndDependencies.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
index 49b2c3a..10dc532 100644
--- a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
+++ b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
@@ -2,7 +2,7 @@ import com.huanshankeji.CommonDependencies
 import com.huanshankeji.CommonGradleClasspathDependencies
 import com.huanshankeji.CommonVersions
 
-val projectVersion = "0.3.0-SNAPSHOT"
+val projectVersion = "0.3.0-generic-exposed-class-property-mapping-SNAPSHOT"
 
 val commonVersions = CommonVersions()
 val commonDependencies = CommonDependencies(commonVersions)

From 2325a61ae0b0fc901151da653dc3736bb92268fb Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 24 Feb 2023 04:19:56 +0800
Subject: [PATCH 40/59] Add a link to a related issue in a comment

---
 .../exposed/datamapping/classproperty/ClassPropertyMapping.kt   | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
index 79cd8bf..c933bad 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
@@ -441,7 +441,7 @@ fun <Data : Any> setUpdateBuilder(
                                 adt as NestedClass.Adt.Sum<PropertyData & Any, CaseValue>
                                 with(adt) {
                                     if (propertyData !== null) {
-                                        // TODO: it seems to be a compiler bug that the non-null assertion is needed here.
+                                        // TODO: it seems to be a compiler bug that the non-null assertion is needed here. see: https://youtrack.jetbrains.com/issue/KT-37878/No-Smart-cast-for-class-literal-reference-of-nullable-generic-type.
                                         val propertyDataClass = propertyData!!::class
                                         with(sumTypeCaseConfig) {
                                             updateBuilder[caseValueColumn] = classToCaseValue(propertyDataClass)

From 31962a58320b566fabf5e842196608ac3b0c5cb0 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 24 Feb 2023 07:50:53 +0800
Subject: [PATCH 41/59] Update the Gradle Wrapper to 8.0.1

---
 .../main/kotlin/jvm-conventions.gradle.kts    |   2 +-
 .../multiplatform-conventions.gradle.kts      |   2 ++
 gradle/wrapper/gradle-wrapper.jar             | Bin 61574 -> 61608 bytes
 gradle/wrapper/gradle-wrapper.properties      |   2 +-
 gradlew                                       |   4 ++--
 5 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/buildSrc/src/main/kotlin/jvm-conventions.gradle.kts b/buildSrc/src/main/kotlin/jvm-conventions.gradle.kts
index afde798..accbc57 100644
--- a/buildSrc/src/main/kotlin/jvm-conventions.gradle.kts
+++ b/buildSrc/src/main/kotlin/jvm-conventions.gradle.kts
@@ -4,4 +4,4 @@ plugins {
     id("common-conventions-after")
 }
 
-java.toolchain.languageVersion.set(JavaLanguageVersion.of(8))
+kotlin.jvmToolchain(8)
diff --git a/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts b/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts
index e94bc49..d74ced8 100644
--- a/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts
+++ b/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts
@@ -4,3 +4,5 @@ plugins {
     id("com.huanshankeji.kotlin-multiplatform-jvm-and-js-browser-conventions")
     id("common-conventions-after")
 }
+
+kotlin.jvmToolchain(8)
diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar
index 943f0cbfa754578e88a3dae77fce6e3dea56edbf..ccebba7710deaf9f98673a68957ea02138b60d0a 100644
GIT binary patch
delta 5094
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

delta 5107
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
I6Xdi10eY*&F8}}l

diff --git a/gradle/wrapper/gradle-wrapper.properties b/gradle/wrapper/gradle-wrapper.properties
index 2b22d05..6ec1567 100644
--- a/gradle/wrapper/gradle-wrapper.properties
+++ b/gradle/wrapper/gradle-wrapper.properties
@@ -1,6 +1,6 @@
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.6-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.0.1-all.zip
 networkTimeout=10000
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
diff --git a/gradlew b/gradlew
index 65dcd68..79a61d4 100755
--- a/gradlew
+++ b/gradlew
@@ -144,7 +144,7 @@ if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
     case $MAX_FD in #(
       max*)
         # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
-        # shellcheck disable=SC3045 
+        # shellcheck disable=SC3045
         MAX_FD=$( ulimit -H -n ) ||
             warn "Could not query maximum file descriptor limit"
     esac
@@ -152,7 +152,7 @@ if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
       '' | soft) :;; #(
       *)
         # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
-        # shellcheck disable=SC3045 
+        # shellcheck disable=SC3045
         ulimit -n "$MAX_FD" ||
             warn "Could not set maximum file descriptor limit to $MAX_FD"
     esac

From 3d494eca7acae5a98fb8cd8358223fb97f79d2fe Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 3 Mar 2023 19:11:56 +0800
Subject: [PATCH 42/59] Initially add the `awaitAny` and `joinAny` Coroutine
 functions

---
 coroutines/build.gradle.kts                   |  4 +++-
 .../huanshankeji/kotlinx/coroutine/Await.kt   | 22 +++++++++++++++++++
 2 files changed, 25 insertions(+), 1 deletion(-)
 create mode 100644 coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt

diff --git a/coroutines/build.gradle.kts b/coroutines/build.gradle.kts
index ce375e0..acf52ff 100644
--- a/coroutines/build.gradle.kts
+++ b/coroutines/build.gradle.kts
@@ -1,12 +1,14 @@
+import com.huanshankeji.cpnProject
+
 plugins {
     id("multiplatform-conventions")
 }
-
 kotlin {
     sourceSets {
         val commonMain by getting {
             dependencies {
                 implementation(commonDependencies.kotlinx.coroutines.core())
+                implementation(cpnProject(project, ":core"))
             }
         }
     }
diff --git a/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt b/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt
new file mode 100644
index 0000000..a095485
--- /dev/null
+++ b/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt
@@ -0,0 +1,22 @@
+package com.huanshankeji.kotlinx.coroutine
+
+import com.huanshankeji.Untested
+import kotlinx.coroutines.Deferred
+import kotlinx.coroutines.Job
+import kotlinx.coroutines.selects.select
+
+@Untested
+suspend fun <T> awaitAny(vararg deferreds: Deferred<T>): T =
+    select { deferreds.forEach { it.onAwait { it } } }
+
+@Untested
+suspend fun <T> Collection<Deferred<T>>.awaitAny(): T =
+    select { forEach { it.onAwait { it } } }
+
+@Untested
+suspend fun joinAny(vararg jobs: Job): Unit =
+    select { jobs.forEach { it.onJoin { it } } }
+
+@Untested
+suspend fun Collection<Job>.joinAny(): Unit =
+    select { forEach { it.onJoin { it } } }

From e64be88b529c299fdce8f3fb50c0ecc74d0186fa Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Wed, 8 Mar 2023 00:29:35 +0800
Subject: [PATCH 43/59] Add some simple tests for `awaitAny` and `joinAny`

---
 coroutines/build.gradle.kts                   |  8 ++-
 .../kotlinx/coroutine/AwaitTest.kt            | 55 +++++++++++++++++++
 2 files changed, 62 insertions(+), 1 deletion(-)
 create mode 100644 coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt

diff --git a/coroutines/build.gradle.kts b/coroutines/build.gradle.kts
index acf52ff..74e7bc3 100644
--- a/coroutines/build.gradle.kts
+++ b/coroutines/build.gradle.kts
@@ -5,11 +5,17 @@ plugins {
 }
 kotlin {
     sourceSets {
-        val commonMain by getting {
+        commonMain {
             dependencies {
                 implementation(commonDependencies.kotlinx.coroutines.core())
                 implementation(cpnProject(project, ":core"))
             }
         }
+        commonTest {
+            dependencies {
+                implementation(kotlin("test"))
+                implementation(commonDependencies.kotlinx.coroutines.test())
+            }
+        }
     }
 }
diff --git a/coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt b/coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt
new file mode 100644
index 0000000..b04ca95
--- /dev/null
+++ b/coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt
@@ -0,0 +1,55 @@
+package com.huanshankeji.kotlinx.coroutine
+
+import kotlinx.coroutines.async
+import kotlinx.coroutines.launch
+import kotlinx.coroutines.sync.Mutex
+import kotlinx.coroutines.sync.withLock
+import kotlinx.coroutines.test.runTest
+import kotlin.test.Test
+import kotlin.test.assertEquals
+
+class AwaitTest {
+    @Test
+    fun simplyTestAwaitAnyAndJoinAny() = runTest {
+        val mutex = Mutex()
+        mutex.withLock {
+            fun asyncOf(value: Int) = async { value }
+            fun asyncSuspendUtilEnd() = async { mutex.withLock { } }
+
+            fun deferredArray0() = arrayOf(asyncOf(0), asyncSuspendUtilEnd())
+            fun deferredArray1() = arrayOf(asyncSuspendUtilEnd(), asyncOf(1))
+            assertEquals(0, awaitAny(*deferredArray0()))
+            assertEquals(1, awaitAny(*deferredArray1()))
+            assertEquals(0, deferredArray0().asList().awaitAny())
+            assertEquals(1, deferredArray1().asList().awaitAny())
+
+
+            var value: Int?
+
+            fun launchSetOf(newValue: Int) = launch { value = newValue }
+            fun launchSuspendUtilEndAndSetOf(newValue: Int) = launch {
+                mutex.withLock { }
+                value = newValue
+            }
+
+            fun jobArray0() = arrayOf(launchSetOf(0), launchSuspendUtilEndAndSetOf(1))
+            fun jobArray1() = arrayOf(launchSuspendUtilEndAndSetOf(0), launchSetOf(1))
+
+            value = null
+            joinAny(*jobArray0())
+            assertEquals(0, value)
+
+            value = null
+            joinAny(*jobArray1())
+            assertEquals(1, value)
+
+            value = null
+            jobArray0().asList().joinAny()
+            assertEquals(0, value)
+
+            value = null
+            jobArray1().asList().joinAny()
+            assertEquals(1, value)
+        }
+    }
+}
\ No newline at end of file

From 919033a8a03d4bfd8bc3045fac5a038e6d0226ea Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Wed, 8 Mar 2023 18:26:40 +0800
Subject: [PATCH 44/59] Remove the `@Untested` annotations as should be done in
 the previous commit and fix a bug

---
 .../kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt   | 9 ++-------
 1 file changed, 2 insertions(+), 7 deletions(-)

diff --git a/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt b/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt
index a095485..2b0bf8a 100644
--- a/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt
+++ b/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt
@@ -1,22 +1,17 @@
 package com.huanshankeji.kotlinx.coroutine
 
-import com.huanshankeji.Untested
 import kotlinx.coroutines.Deferred
 import kotlinx.coroutines.Job
 import kotlinx.coroutines.selects.select
 
-@Untested
 suspend fun <T> awaitAny(vararg deferreds: Deferred<T>): T =
     select { deferreds.forEach { it.onAwait { it } } }
 
-@Untested
 suspend fun <T> Collection<Deferred<T>>.awaitAny(): T =
     select { forEach { it.onAwait { it } } }
 
-@Untested
 suspend fun joinAny(vararg jobs: Job): Unit =
-    select { jobs.forEach { it.onJoin { it } } }
+    select { jobs.forEach { it.onJoin { } } }
 
-@Untested
 suspend fun Collection<Job>.joinAny(): Unit =
-    select { forEach { it.onJoin { it } } }
+    select { forEach { it.onJoin { } } }

From b400a6ee025bf03ea2c256c0ecfcc124b6d5305f Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Wed, 8 Mar 2023 18:49:58 +0800
Subject: [PATCH 45/59] Add `awaitAnyAndCancelOthers` and test it

---
 .../kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt |  7 +++++++
 .../com/huanshankeji/kotlinx/coroutine/AwaitTest.kt    | 10 ++++++++++
 2 files changed, 17 insertions(+)

diff --git a/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt b/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt
index 2b0bf8a..dae3f9e 100644
--- a/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt
+++ b/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt
@@ -10,6 +10,13 @@ suspend fun <T> awaitAny(vararg deferreds: Deferred<T>): T =
 suspend fun <T> Collection<Deferred<T>>.awaitAny(): T =
     select { forEach { it.onAwait { it } } }
 
+suspend fun <T> Collection<Deferred<T>>.awaitAnyAndCancelOthers(): T {
+    val firstAwaited = select { forEachIndexed { index, deferred -> deferred.onAwait { IndexedValue(index, it) } } }
+    val firstAwaitedIndex = firstAwaited.index
+    forEachIndexed { index, deferred -> if (index != firstAwaitedIndex) deferred.cancel() }
+    return firstAwaited.value
+}
+
 suspend fun joinAny(vararg jobs: Job): Unit =
     select { jobs.forEach { it.onJoin { } } }
 
diff --git a/coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt b/coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt
index b04ca95..b296551 100644
--- a/coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt
+++ b/coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt
@@ -1,5 +1,6 @@
 package com.huanshankeji.kotlinx.coroutine
 
+import kotlinx.coroutines.ExperimentalCoroutinesApi
 import kotlinx.coroutines.async
 import kotlinx.coroutines.launch
 import kotlinx.coroutines.sync.Mutex
@@ -7,8 +8,11 @@ import kotlinx.coroutines.sync.withLock
 import kotlinx.coroutines.test.runTest
 import kotlin.test.Test
 import kotlin.test.assertEquals
+import kotlin.test.assertFalse
+import kotlin.test.assertTrue
 
 class AwaitTest {
+    @OptIn(ExperimentalCoroutinesApi::class)
     @Test
     fun simplyTestAwaitAnyAndJoinAny() = runTest {
         val mutex = Mutex()
@@ -24,6 +28,12 @@ class AwaitTest {
             assertEquals(1, deferredArray1().asList().awaitAny())
 
 
+            val deffereds = deferredArray0()
+            assertFalse(deffereds[1].isCancelled)
+            assertEquals(0, deffereds.asList().awaitAnyAndCancelOthers())
+            assertTrue(deffereds[1].isCancelled)
+
+
             var value: Int?
 
             fun launchSetOf(newValue: Int) = launch { value = newValue }

From cae2df3f7f4eed7b2fe3000fb57fb1616175c0b6 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Thu, 9 Mar 2023 17:10:20 +0800
Subject: [PATCH 46/59] Add the non-empty argument requirements to the
 `awaitAny` and `joinAny` functions and add tests

---
 .../huanshankeji/kotlinx/coroutine/Await.kt   | 21 +++++++++++++------
 .../kotlinx/coroutine/AwaitTest.kt            | 20 +++++++++++++-----
 2 files changed, 30 insertions(+), 11 deletions(-)

diff --git a/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt b/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt
index dae3f9e..8c4e560 100644
--- a/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt
+++ b/coroutines/src/commonMain/kotlin/com/huanshankeji/kotlinx/coroutine/Await.kt
@@ -4,21 +4,30 @@ import kotlinx.coroutines.Deferred
 import kotlinx.coroutines.Job
 import kotlinx.coroutines.selects.select
 
-suspend fun <T> awaitAny(vararg deferreds: Deferred<T>): T =
-    select { deferreds.forEach { it.onAwait { it } } }
+suspend fun <T> awaitAny(vararg deferreds: Deferred<T>): T {
+    require(deferreds.isNotEmpty())
+    return select { deferreds.forEach { it.onAwait { it } } }
+}
 
-suspend fun <T> Collection<Deferred<T>>.awaitAny(): T =
-    select { forEach { it.onAwait { it } } }
+suspend fun <T> Collection<Deferred<T>>.awaitAny(): T {
+    require(isNotEmpty())
+    return select { forEach { it.onAwait { it } } }
+}
 
 suspend fun <T> Collection<Deferred<T>>.awaitAnyAndCancelOthers(): T {
+    require(isNotEmpty())
     val firstAwaited = select { forEachIndexed { index, deferred -> deferred.onAwait { IndexedValue(index, it) } } }
     val firstAwaitedIndex = firstAwaited.index
     forEachIndexed { index, deferred -> if (index != firstAwaitedIndex) deferred.cancel() }
     return firstAwaited.value
 }
 
-suspend fun joinAny(vararg jobs: Job): Unit =
+suspend fun joinAny(vararg jobs: Job) {
+    require(jobs.isNotEmpty())
     select { jobs.forEach { it.onJoin { } } }
+}
 
-suspend fun Collection<Job>.joinAny(): Unit =
+suspend fun Collection<Job>.joinAny() {
+    require(isNotEmpty())
     select { forEach { it.onJoin { } } }
+}
diff --git a/coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt b/coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt
index b296551..6537ec1 100644
--- a/coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt
+++ b/coroutines/src/commonTest/kotlin/com/huanshankeji/kotlinx/coroutine/AwaitTest.kt
@@ -6,13 +6,10 @@ import kotlinx.coroutines.launch
 import kotlinx.coroutines.sync.Mutex
 import kotlinx.coroutines.sync.withLock
 import kotlinx.coroutines.test.runTest
-import kotlin.test.Test
-import kotlin.test.assertEquals
-import kotlin.test.assertFalse
-import kotlin.test.assertTrue
+import kotlin.test.*
 
+@OptIn(ExperimentalCoroutinesApi::class)
 class AwaitTest {
-    @OptIn(ExperimentalCoroutinesApi::class)
     @Test
     fun simplyTestAwaitAnyAndJoinAny() = runTest {
         val mutex = Mutex()
@@ -62,4 +59,17 @@ class AwaitTest {
             assertEquals(1, value)
         }
     }
+
+    private inline fun assertFailsWithIae(block: () -> Unit) =
+        assertFailsWith<IllegalArgumentException>(block = block)
+
+    @Test
+    fun simplyTestAwaitAnyAndJoinAnyWithNoTarget() = runTest {
+        val emptyList = emptyList<Nothing>()
+        assertFailsWithIae { awaitAny() }
+        assertFailsWithIae { emptyList.awaitAny() }
+        assertFailsWithIae { emptyList.awaitAnyAndCancelOthers() }
+        assertFailsWithIae { joinAny() }
+        assertFailsWithIae { emptyList.joinAny() }
+    }
 }
\ No newline at end of file

From 86d040301965b71b391f3691f3b2bbf3815fafd0 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Sun, 12 Mar 2023 19:23:07 +0800
Subject: [PATCH 47/59] Upgrade the Huanshankeji Gradle build dependencies to
 the latest release versions

---
 buildSrc/build.gradle.kts                                   | 6 +++---
 .../src/main/kotlin/multiplatform-conventions.gradle.kts    | 2 +-
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/buildSrc/build.gradle.kts b/buildSrc/build.gradle.kts
index 5417c8f..859345b 100644
--- a/buildSrc/build.gradle.kts
+++ b/buildSrc/build.gradle.kts
@@ -15,7 +15,7 @@ repositories {
 }
 
 dependencies {
-    implementation(kotlin("gradle-plugin", "1.8.0"))
-    implementation("com.huanshankeji:common-gradle-dependencies:0.3.3-20221230-SNAPSHOT") // TODO: don't use a snapshot version in a main branch
-    implementation("com.huanshankeji.team:gradle-plugins:0.4.0-SNAPSHOT") // TODO: don't use a snapshot version in a main branch
+    implementation(kotlin("gradle-plugin", "1.8.10"))
+    implementation("com.huanshankeji:common-gradle-dependencies:0.5.0-20230310")
+    implementation("com.huanshankeji.team:gradle-plugins:0.4.0")
 }
diff --git a/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts b/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts
index d74ced8..b8a929c 100644
--- a/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts
+++ b/buildSrc/src/main/kotlin/multiplatform-conventions.gradle.kts
@@ -1,7 +1,7 @@
 plugins {
     id("common-conventions-before")
-    id("com.huanshankeji.kotlin-multiplatform-sonatype-ossrh-publish-conventions")
     id("com.huanshankeji.kotlin-multiplatform-jvm-and-js-browser-conventions")
+    id("com.huanshankeji.kotlin-multiplatform-sonatype-ossrh-publish-conventions")
     id("common-conventions-after")
 }
 

From 6e70fa37884447cfb992212df7d57e6098684216 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Mon, 13 Mar 2023 18:21:54 +0800
Subject: [PATCH 48/59] Move `ProtoBufSerializationTest` here from an internal
 project

---
 serialization/build.gradle.kts                |  8 ++++++-
 .../protobuf/ProtoBufSerializationTest.kt     | 23 +++++++++++++++++++
 2 files changed, 30 insertions(+), 1 deletion(-)
 create mode 100644 serialization/src/commonTest/kotlin/com/huanshankeji/kotlinx/serialization/protobuf/ProtoBufSerializationTest.kt

diff --git a/serialization/build.gradle.kts b/serialization/build.gradle.kts
index 60b6f20..c1f0871 100644
--- a/serialization/build.gradle.kts
+++ b/serialization/build.gradle.kts
@@ -5,7 +5,7 @@ plugins {
 
 kotlin {
     sourceSets {
-        val commonMain by getting {
+        commonMain {
             dependencies {
                 with(commonDependencies.kotlinx.serialization) {
                     implementation(core())
@@ -13,5 +13,11 @@ kotlin {
                 }
             }
         }
+
+        commonTest {
+            dependencies {
+                implementation(kotlin("test"))
+            }
+        }
     }
 }
diff --git a/serialization/src/commonTest/kotlin/com/huanshankeji/kotlinx/serialization/protobuf/ProtoBufSerializationTest.kt b/serialization/src/commonTest/kotlin/com/huanshankeji/kotlinx/serialization/protobuf/ProtoBufSerializationTest.kt
new file mode 100644
index 0000000..56d37cc
--- /dev/null
+++ b/serialization/src/commonTest/kotlin/com/huanshankeji/kotlinx/serialization/protobuf/ProtoBufSerializationTest.kt
@@ -0,0 +1,23 @@
+package com.huanshankeji.kotlinx.serialization.protobuf
+
+import kotlinx.serialization.ExperimentalSerializationApi
+import kotlinx.serialization.Serializable
+import kotlinx.serialization.protobuf.ProtoBuf
+import kotlinx.serialization.protobuf.ProtoNumber
+import kotlin.test.Test
+import kotlin.test.assertContentEquals
+import kotlin.test.assertEquals
+
+@OptIn(ExperimentalStdlibApi::class, ExperimentalSerializationApi::class)
+class ProtoBufSerializationTest {
+    @Serializable
+    data class TestData<T : Any>(@ProtoNumber(1) val field: T?)
+
+    @Test
+    fun testNothingField() {
+        val testData = TestData(null)
+        val encoded = ProtoBuf.encodeToByteArrayNothingWorkaround(testData)
+        assertContentEquals(ByteArray(0), encoded)
+        assertEquals(testData, ProtoBuf.decodeFromByteArrayNothingWorkaround(encoded))
+    }
+}
\ No newline at end of file

From 4b919c72e5dc761a77bb2f98a282827d7ba5b62b Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Thu, 16 Mar 2023 18:34:15 +0800
Subject: [PATCH 49/59] Remove a redundant usage of a named argument

---
 .../huanshankeji/vertx/sqlclient/PreparedQueryBatchExecution.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/PreparedQueryBatchExecution.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/PreparedQueryBatchExecution.kt
index 4dbdd18..7ac2d88 100644
--- a/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/PreparedQueryBatchExecution.kt
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/PreparedQueryBatchExecution.kt
@@ -13,7 +13,7 @@ import io.vertx.sqlclient.Tuple
 fun <QueryResultT, DataT, SelectorResultT : Comparable<SelectorResultT>> PreparedQuery<QueryResultT>.sortDataAndExecuteBatch(
     dataList: List<DataT>, selector: (DataT) -> SelectorResultT, toTuple: DataT.() -> Tuple
 ) =
-    executeBatch(dataList.sortedBy(selector = selector).map(toTuple))
+    executeBatch(dataList.sortedBy(selector).map(toTuple))
 
 
 @Untested

From d3cee5e8f33cb96f82dc61bc62e6eb8337cdf296 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Sat, 18 Mar 2023 02:52:34 +0800
Subject: [PATCH 50/59] Add `BatchSqlResult.kt` to read multiple
 `SqlResult`s/`RowSet`s of query batch execution results

---
 .../vertx/sqlclient/BatchSqlResult.kt         | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
 create mode 100644 vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/BatchSqlResult.kt

diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/BatchSqlResult.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/BatchSqlResult.kt
new file mode 100644
index 0000000..a4c0d58
--- /dev/null
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/BatchSqlResult.kt
@@ -0,0 +1,19 @@
+package com.huanshankeji.vertx.sqlclient
+
+import io.vertx.sqlclient.RowSet
+import io.vertx.sqlclient.SqlResult
+
+fun <SqlResultT : SqlResult<*>> SqlResultT.batchSqlResultSequence(): Sequence<SqlResultT> = sequence {
+    var currentSqlResult: SqlResultT? = this@batchSqlResultSequence
+
+    while (currentSqlResult !== null) {
+        yield(currentSqlResult)
+        currentSqlResult = currentSqlResult.next() as SqlResultT?
+    }
+}
+
+fun SqlResult<*>.batchSqlResultRowCountSequence() =
+    batchSqlResultSequence().map { it.rowCount() }
+
+fun <R> RowSet<R>.batchSqlResultRowSequence() =
+    batchSqlResultSequence().map { asSequence() }

From 0a05c2b44c63f449d19f81ddf94785c4ce80a4bd Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Sat, 18 Mar 2023 11:46:47 +0800
Subject: [PATCH 51/59] Simplify `batchSqlResultSequence` with
 `generateSequence`

---
 .../huanshankeji/vertx/sqlclient/BatchSqlResult.kt    | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/BatchSqlResult.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/BatchSqlResult.kt
index a4c0d58..dc95331 100644
--- a/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/BatchSqlResult.kt
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/BatchSqlResult.kt
@@ -3,14 +3,11 @@ package com.huanshankeji.vertx.sqlclient
 import io.vertx.sqlclient.RowSet
 import io.vertx.sqlclient.SqlResult
 
-fun <SqlResultT : SqlResult<*>> SqlResultT.batchSqlResultSequence(): Sequence<SqlResultT> = sequence {
-    var currentSqlResult: SqlResultT? = this@batchSqlResultSequence
-
-    while (currentSqlResult !== null) {
-        yield(currentSqlResult)
-        currentSqlResult = currentSqlResult.next() as SqlResultT?
+fun <SqlResultT : SqlResult<*>> SqlResultT.batchSqlResultSequence(): Sequence<SqlResultT> =
+    generateSequence(this) {
+        @Suppress("UNCHECKED_CAST")
+        it.next() as SqlResultT?
     }
-}
 
 fun SqlResult<*>.batchSqlResultRowCountSequence() =
     batchSqlResultSequence().map { it.rowCount() }

From fb194873881825d568ffcd0ebc4a1f88d2d9a59c Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Sat, 18 Mar 2023 21:36:27 +0800
Subject: [PATCH 52/59] Add `awaitExecuteBatchForRowSetSequence`, and move and
 rename the `SqlResult` `Sequence` functions

---
 .../sqlclient/BatchSqlResultSequences.kt}                | 7 +++----
 .../huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt | 9 +++++++++
 2 files changed, 12 insertions(+), 4 deletions(-)
 rename vertx/src/main/kotlin/com/huanshankeji/vertx/{sqlclient/BatchSqlResult.kt => kotlin/sqlclient/BatchSqlResultSequences.kt} (69%)
 create mode 100644 vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt

diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/BatchSqlResult.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/BatchSqlResultSequences.kt
similarity index 69%
rename from vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/BatchSqlResult.kt
rename to vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/BatchSqlResultSequences.kt
index dc95331..c38695b 100644
--- a/vertx/src/main/kotlin/com/huanshankeji/vertx/sqlclient/BatchSqlResult.kt
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/BatchSqlResultSequences.kt
@@ -1,7 +1,6 @@
-package com.huanshankeji.vertx.sqlclient
+package com.huanshankeji.vertx.kotlin.sqlclient
 
-import io.vertx.sqlclient.RowSet
-import io.vertx.sqlclient.SqlResult
+import io.vertx.sqlclient.*
 
 fun <SqlResultT : SqlResult<*>> SqlResultT.batchSqlResultSequence(): Sequence<SqlResultT> =
     generateSequence(this) {
@@ -12,5 +11,5 @@ fun <SqlResultT : SqlResult<*>> SqlResultT.batchSqlResultSequence(): Sequence<Sq
 fun SqlResult<*>.batchSqlResultRowCountSequence() =
     batchSqlResultSequence().map { it.rowCount() }
 
-fun <R> RowSet<R>.batchSqlResultRowSequence() =
+fun <R> RowSet<R>.batchSqlResultRowSequenceSequence() =
     batchSqlResultSequence().map { asSequence() }
diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt
new file mode 100644
index 0000000..9bb15fc
--- /dev/null
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt
@@ -0,0 +1,9 @@
+package com.huanshankeji.vertx.kotlin.sqlclient
+
+import io.vertx.kotlin.coroutines.await
+import io.vertx.sqlclient.PreparedQuery
+import io.vertx.sqlclient.RowSet
+import io.vertx.sqlclient.Tuple
+
+suspend fun <R> PreparedQuery<RowSet<R>>.awaitExecuteBatchForRowSetSequence(batch: List<Tuple>) =
+    executeBatch(batch).await().batchSqlResultSequence()

From 7b82af02366eb5cd2677e736bf3f9e06b6759533 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Sun, 19 Mar 2023 01:49:33 +0800
Subject: [PATCH 53/59] Rename `awaitExecuteBatchForRowSetSequence` to
 `executeBatchAwaitForRowSetSequence` to follow the Vert.x convention

---
 .../com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt
index 9bb15fc..5380c82 100644
--- a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt
@@ -5,5 +5,5 @@ import io.vertx.sqlclient.PreparedQuery
 import io.vertx.sqlclient.RowSet
 import io.vertx.sqlclient.Tuple
 
-suspend fun <R> PreparedQuery<RowSet<R>>.awaitExecuteBatchForRowSetSequence(batch: List<Tuple>) =
+suspend fun <R> PreparedQuery<RowSet<R>>.executeBatchAwaitForRowSetSequence(batch: List<Tuple>) =
     executeBatch(batch).await().batchSqlResultSequence()

From b2c3878da8439d82db2c0153cd05a11b212eae9b Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Sun, 19 Mar 2023 01:56:18 +0800
Subject: [PATCH 54/59] Refactor `executeBatchAwaitForRowSetSequence` into
 `executeBatchAwaitForSqlResultSequence`

---
 .../com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt  | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt
index 5380c82..8494f72 100644
--- a/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt
+++ b/vertx/src/main/kotlin/com/huanshankeji/vertx/kotlin/sqlclient/PreparedQuery.kt
@@ -2,8 +2,8 @@ package com.huanshankeji.vertx.kotlin.sqlclient
 
 import io.vertx.kotlin.coroutines.await
 import io.vertx.sqlclient.PreparedQuery
-import io.vertx.sqlclient.RowSet
+import io.vertx.sqlclient.SqlResult
 import io.vertx.sqlclient.Tuple
 
-suspend fun <R> PreparedQuery<RowSet<R>>.executeBatchAwaitForRowSetSequence(batch: List<Tuple>) =
+suspend fun <SqlResultT : SqlResult<*>> PreparedQuery<SqlResultT>.executeBatchAwaitForSqlResultSequence(batch: List<Tuple>) =
     executeBatch(batch).await().batchSqlResultSequence()

From d5c4a68c502f15d0cf537beb7e40b1f85629707f Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Fri, 28 Apr 2023 11:57:53 +0800
Subject: [PATCH 55/59] Update code related to `ProtoBufSumTypeSerializer`

---
 .../kotlinx/serialization/protobuf/SumType.kt    | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/serialization/src/commonMain/kotlin/com/huanshankeji/kotlinx/serialization/protobuf/SumType.kt b/serialization/src/commonMain/kotlin/com/huanshankeji/kotlinx/serialization/protobuf/SumType.kt
index 42a3ce3..c25e455 100644
--- a/serialization/src/commonMain/kotlin/com/huanshankeji/kotlinx/serialization/protobuf/SumType.kt
+++ b/serialization/src/commonMain/kotlin/com/huanshankeji/kotlinx/serialization/protobuf/SumType.kt
@@ -9,7 +9,7 @@ import kotlinx.serialization.protobuf.ProtoNumber
 
 @ExperimentalSerializationApi
 @Serializable
-class SumTypeSupertypeSurrogate(
+private class SumTypeSupertypeSurrogate(
     @ProtoNumber(1)
     val subtypeNumber: Int,
     @ProtoNumber(2)
@@ -19,17 +19,22 @@ class SumTypeSupertypeSurrogate(
         get() = backingSubtypeSerializedData!!
 }
 
+/**
+ * A ProtoBuf [KSerializer] for sum types, aka, open/abstract/sealed classes and interfaces.
+ *
+ * It's achieved by converting the object to a wrapper surrogate object [SumTypeSupertypeSurrogate],
+ * in which the type is stored as a classifying [Int] number [SumTypeSupertypeSurrogate.subtypeNumber].
+ */
 @ExperimentalSerializationApi
 interface ProtoBufSumTypeSerializer<Supertype> : KSerializer<Supertype> {
-    val surrogateSerializer get() = SumTypeSupertypeSurrogate.serializer()
+    private val surrogateSerializer get() = SumTypeSupertypeSurrogate.serializer()
     override val descriptor: SerialDescriptor
         get() = surrogateSerializer.descriptor
 
-    fun Supertype.toSurrogate(): SumTypeSupertypeSurrogate {
+    private fun Supertype.toSurrogate(): SumTypeSupertypeSurrogate {
         val (subtypeNumber, subtypeSerializer) = getSubtypeNumberAndSubtypeSerializationStrategy(this)
         @Suppress("UNCHECKED_CAST")
         return SumTypeSupertypeSurrogate(
-            // use `encodeToByteArrayNothingWorkaround` if something goes wrong
             subtypeNumber, ProtoBuf.encodeToByteArray(
                 subtypeSerializer as SerializationStrategy<Any?>, this
             )
@@ -38,8 +43,7 @@ interface ProtoBufSumTypeSerializer<Supertype> : KSerializer<Supertype> {
 
     fun getSubtypeNumberAndSubtypeSerializationStrategy(value: Supertype): Pair<Int, SerializationStrategy<*>>
 
-    fun SumTypeSupertypeSurrogate.toOriginal(): Supertype =
-        // use `decodeFromByteArrayNothingWorkaround` if something goes wrong
+    private fun SumTypeSupertypeSurrogate.toOriginal(): Supertype =
         @Suppress("UNCHECKED_CAST")
         ProtoBuf.decodeFromByteArray(
             getSubtypeDeserializationStrategy(subtypeNumber) as DeserializationStrategy<Supertype>,

From d66ec9e98f22978a2c42b208cdf056f79f2f9072 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Wed, 10 May 2023 21:19:21 +0800
Subject: [PATCH 56/59] Update the message of `Untested`

---
 core/src/commonMain/kotlin/com/huanshankeji/Untested.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/core/src/commonMain/kotlin/com/huanshankeji/Untested.kt b/core/src/commonMain/kotlin/com/huanshankeji/Untested.kt
index 4874f85..a4fe834 100644
--- a/core/src/commonMain/kotlin/com/huanshankeji/Untested.kt
+++ b/core/src/commonMain/kotlin/com/huanshankeji/Untested.kt
@@ -2,7 +2,7 @@ package com.huanshankeji
 
 import kotlin.annotation.AnnotationTarget.*
 
-@RequiresOptIn("This API is untested.", RequiresOptIn.Level.WARNING)
+@RequiresOptIn("This API hasn't been tested yet.", RequiresOptIn.Level.WARNING)
 @Retention(AnnotationRetention.BINARY)
 // The ones commented out are what I think may be used in very few use cases.
 @Target(

From 053eab230fc97e04784078e5a6dc0452e91a7c17 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Tue, 16 May 2023 02:45:14 +0800
Subject: [PATCH 57/59] Mark code in ClassPropertyMapping.kt as `@Untested`

---
 exposed/build.gradle.kts                      |  4 +++
 .../classproperty/ClassPropertyMapping.kt     | 26 ++++++++++++++++---
 2 files changed, 27 insertions(+), 3 deletions(-)

diff --git a/exposed/build.gradle.kts b/exposed/build.gradle.kts
index f471d4b..1d4fe2a 100644
--- a/exposed/build.gradle.kts
+++ b/exposed/build.gradle.kts
@@ -1,7 +1,11 @@
+import com.huanshankeji.cpnProject
+
 plugins {
     id("jvm-conventions")
 }
 
 dependencies {
     implementation(commonDependencies.exposed.core())
+
+    implementation(cpnProject(project, ":core"))
 }
diff --git a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
index c933bad..90dd8d8 100644
--- a/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
+++ b/exposed/src/main/kotlin/com/huanshankeji/exposed/datamapping/classproperty/ClassPropertyMapping.kt
@@ -1,14 +1,21 @@
 package com.huanshankeji.exposed.datamapping.classproperty
 
+import com.huanshankeji.Untested
 import com.huanshankeji.exposed.datamapping.DataMapper
 import com.huanshankeji.exposed.datamapping.NullableDataMapper
-import com.huanshankeji.exposed.datamapping.classproperty.OnDuplicateColumnPropertyNames.*
+import com.huanshankeji.exposed.datamapping.classproperty.OnDuplicateColumnPropertyNames.CHOOSE_FIRST
+import com.huanshankeji.exposed.datamapping.classproperty.OnDuplicateColumnPropertyNames.THROW
 import com.huanshankeji.exposed.datamapping.classproperty.PropertyColumnMapping.*
 import org.jetbrains.exposed.sql.*
 import org.jetbrains.exposed.sql.statements.UpdateBuilder
 import org.slf4j.LoggerFactory
-import kotlin.reflect.*
-import kotlin.reflect.full.*
+import kotlin.reflect.KClass
+import kotlin.reflect.KProperty1
+import kotlin.reflect.KType
+import kotlin.reflect.full.isSubclassOf
+import kotlin.reflect.full.memberProperties
+import kotlin.reflect.full.primaryConstructor
+import kotlin.reflect.typeOf
 import kotlin.sequences.Sequence
 
 // Our own class mapping implementation using reflection which should be adapted using annotation processors and code generation in the future.
@@ -25,6 +32,7 @@ TODO: consider decoupling/removing `property` and `Data` from this class and ren
  However, after the refactor, `ColumnMapping` will still be coupled with `ClassPropertyColumnMappings` which is coupled with `PropertyColumnMapping`,
  so I am not sure whether this is necessary.
 */
+@Untested
 sealed class PropertyColumnMapping<Data : Any, PropertyData>(val property: KProperty1<Data, PropertyData>) {
     class ExposedSqlPrimitive<Data : Any, PropertyData>(
         property: KProperty1<Data, PropertyData>,
@@ -217,6 +225,7 @@ class PropertyColumnMappingConfig<P>(
 
 typealias PropertyColumnMappingConfigMap<Data /*: Any*/> = Map<KProperty1<Data, *>, PropertyColumnMappingConfig<*>>
 
+@Untested
 fun <Data : Any> getDefaultClassPropertyColumnMappings(
     clazz: KClass<Data>,
     columnByPropertyNameMap: Map<String, Column<*>>,
@@ -341,6 +350,7 @@ fun <T : Any> KClass<T>.sealedLeafSubclasses(): List<KClass<out T>> =
     if (isSealed) sealedSubclasses.flatMap { it.sealedLeafSubclasses() }
     else listOf(this)
 
+@Untested
 fun <Data : Any> getDefaultClassPropertyColumnMappings(
     clazz: KClass<Data>,
     tables: List<Table>, onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST,
@@ -356,6 +366,7 @@ fun <Data : Any> getDefaultClassPropertyColumnMappings(
 
 // TODO: decouple query mapper and update mapper.
 /** Supports classes with nested composite class properties and multiple tables */
+@Untested
 class ReflectionBasedClassPropertyDataMapper<Data : Any>(
     val clazz: KClass<Data>,
     val classPropertyColumnMappings: ClassPropertyColumnMappings<Data>,
@@ -369,6 +380,8 @@ class ReflectionBasedClassPropertyDataMapper<Data : Any>(
     }
 }
 
+
+@Untested
 fun <Data : Any> constructDataWithResultRow(
     clazz: KClass<Data>, classPropertyColumnMappings: ClassPropertyColumnMappings<Data>, resultRow: ResultRow
 ): Data =
@@ -414,6 +427,7 @@ fun <Data : Any> constructDataWithResultRow(
         typeParameterHelper(it as PropertyColumnMapping<Data, Any?>, it.property.returnType.classifier as KClass<Any>)
     }.toTypedArray())
 
+@Untested
 fun <Data : Any> setUpdateBuilder(
     classPropertyColumnMappings: ClassPropertyColumnMappings<Data>, data: Data, updateBuilder: UpdateBuilder<*>
 ) {
@@ -482,6 +496,7 @@ fun <Data : Any> setUpdateBuilder(
     }
 }
 
+@Untested
 fun PropertyColumnMapping<*, *>.forEachColumn(block: (Column<*>) -> Unit) =
     when (this) {
         is ExposedSqlPrimitive -> block(column)
@@ -503,11 +518,13 @@ fun PropertyColumnMapping<*, *>.forEachColumn(block: (Column<*>) -> Unit) =
         is Skip -> {}
     }
 
+@Untested
 fun ClassPropertyColumnMappings<*>.forEachColumn(block: (Column<*>) -> Unit) {
     for (propertyColumnMapping in this)
         propertyColumnMapping.forEachColumn(block)
 }
 
+@Untested
 fun setUpdateBuilderColumnsToNullsWithMappings(
     classPropertyColumnMappings: ClassPropertyColumnMappings<*>, updateBuilder: UpdateBuilder<*>
 ) =
@@ -522,9 +539,11 @@ fun setUpdateBuilderColumnsToNulls(columns: List<Column<*>>, updateBuilder: Upda
         updateBuilder[column as Column<Any?>] = null
 }
 
+@Untested
 fun ClassPropertyColumnMappings<*>.getColumnSet(): Set<Column<*>> =
     buildSet { forEachColumn { add(it) } }
 
+@Untested
 inline fun <reified Data : Any> reflectionBasedClassPropertyDataMapper(
     tables: List<Table>,
     onDuplicateColumnPropertyNames: OnDuplicateColumnPropertyNames = CHOOSE_FIRST,
@@ -539,6 +558,7 @@ inline fun <reified Data : Any> reflectionBasedClassPropertyDataMapper(
     )
 }
 
+@Untested
 inline fun <reified Data : Any/*, TableT : Table*/> reflectionBasedClassPropertyDataMapper(
     table: Table,
     propertyColumnMappingConfigMapOverride: PropertyColumnMappingConfigMap<Data> = emptyMap(),

From e778ed51ddc434846dd91ef24604b348645b3ff0 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Tue, 16 May 2023 02:49:41 +0800
Subject: [PATCH 58/59] Change `projectVersion` back to the main branch one

---
 buildSrc/src/main/kotlin/VersionsAndDependencies.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
index 10dc532..49b2c3a 100644
--- a/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
+++ b/buildSrc/src/main/kotlin/VersionsAndDependencies.kt
@@ -2,7 +2,7 @@ import com.huanshankeji.CommonDependencies
 import com.huanshankeji.CommonGradleClasspathDependencies
 import com.huanshankeji.CommonVersions
 
-val projectVersion = "0.3.0-generic-exposed-class-property-mapping-SNAPSHOT"
+val projectVersion = "0.3.0-SNAPSHOT"
 
 val commonVersions = CommonVersions()
 val commonDependencies = CommonDependencies(commonVersions)

From ae8241d992613600725727a6119c49b30a7367e8 Mon Sep 17 00:00:00 2001
From: Shreck Ye <ShreckYe@gmail.com>
Date: Tue, 16 May 2023 02:51:32 +0800
Subject: [PATCH 59/59] Add a sentence in the message of `@Untested`

---
 core/src/commonMain/kotlin/com/huanshankeji/Untested.kt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/core/src/commonMain/kotlin/com/huanshankeji/Untested.kt b/core/src/commonMain/kotlin/com/huanshankeji/Untested.kt
index a4fe834..6c4a37c 100644
--- a/core/src/commonMain/kotlin/com/huanshankeji/Untested.kt
+++ b/core/src/commonMain/kotlin/com/huanshankeji/Untested.kt
@@ -2,7 +2,7 @@ package com.huanshankeji
 
 import kotlin.annotation.AnnotationTarget.*
 
-@RequiresOptIn("This API hasn't been tested yet.", RequiresOptIn.Level.WARNING)
+@RequiresOptIn("This API hasn't been tested yet. Use at your own risk.", RequiresOptIn.Level.WARNING)
 @Retention(AnnotationRetention.BINARY)
 // The ones commented out are what I think may be used in very few use cases.
 @Target(