From 43c7fc093a5b9a2d192e75e6b1b69328cdfb4c26 Mon Sep 17 00:00:00 2001 From: DBotThePony Date: Sat, 3 Feb 2024 15:30:56 +0700 Subject: [PATCH] Initial commit --- .gitignore | 42 + .idea/.gitignore | 3 + .idea/gradle.xml | 23 + .idea/kotlinc.xml | 6 + .idea/misc.xml | 7 + .idea/vcs.xml | 6 + build.gradle.kts | 46 + collect/build.gradle.kts | 40 + .../kommons/collect/CollectionUtils.kt | 149 ++ .../kommons/collect/ConditionalEnumSet.kt | 41 + .../kommons/collect/ConditionalSet.kt | 89 + .../kommons/collect/ConditionalSupplierSet.kt | 62 + .../dbotthepony/kommons/collect/ProxiedMap.kt | 315 +++ .../kommons/collect/StreamyIterators.kt | 421 ++++ .../kommons/collect/SupplierList.kt | 43 + .../kommons/collect/SupplierMap.kt | 55 + core/build.gradle.kts | 41 + .../dbotthepony/kommons/core/GetterSetter.kt | 149 ++ .../ru/dbotthepony/kommons/core/KOptional.kt | 152 ++ .../kommons/event/IBooleanSubscriptable.kt | 43 + .../kommons/event/IDoubleSubcripable.kt | 43 + .../kommons/event/IFloatSubcripable.kt | 43 + .../kommons/event/IIntSubcripable.kt | 43 + .../kommons/event/ILongSubcripable.kt | 43 + .../kommons/event/ISubscriptable.kt | 60 + .../kommons/event/IUnitSubscripable.kt | 41 + .../kommons/util/BooleanConsumer.kt | 7 + .../kommons/util/ComparatorUtils.kt | 38 + .../dbotthepony/kommons/util/FloatConsumer.kt | 7 + .../dbotthepony/kommons/util/FloatSupplier.kt | 12 + gradle.properties | 14 + gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 60756 bytes gradle/wrapper/gradle-wrapper.properties | 6 + gradlew | 234 ++ gradlew.bat | 89 + guava/build.gradle.kts | 43 + .../kommons/collect/GuavaCollections.kt | 54 + io-math/build.gradle.kts | 44 + .../ru/dbotthepony/kommons/io/DecimalIO.kt | 23 + io/build.gradle.kts | 42 + .../kommons/io/CollectionStreamCodec.kt | 34 + .../dbotthepony/kommons/io/EnumValueCodec.kt | 48 + .../ru/dbotthepony/kommons/io/IStreamCodec.kt | 28 + .../kommons/io/InputStreamUtils.kt | 151 ++ .../kommons/io/OutputStreamUtils.kt | 105 + .../ru/dbotthepony/kommons/io/StreamCodecs.kt | 77 + math/build.gradle.kts | 40 + .../ru/dbotthepony/kommons/math/Decimal.kt | 1553 ++++++++++++ .../ru/dbotthepony/kommons/math/HSVColor.kt | 53 + .../ru/dbotthepony/kommons/math/RGBAColor.kt | 299 +++ networking/build.gradle.kts | 47 + .../kommons/networking/ChangesetAction.kt | 5 + .../kommons/networking/FieldAccess.kt | 41 + .../kommons/networking/FieldGetter.kt | 50 + .../kommons/networking/FieldSetter.kt | 50 + .../kommons/networking/FieldSynchronizer.kt | 2159 +++++++++++++++++ .../dbotthepony/kommons/networking/Fields.kt | 173 ++ .../kommons/networking/MapChangeset.kt | 23 + .../kommons/networking/MutableFields.kt | 165 ++ .../kommons/networking/SetChangeset.kt | 22 + settings.gradle.kts | 14 + 61 files changed, 7756 insertions(+) create mode 100644 .gitignore create mode 100644 .idea/.gitignore create mode 100644 .idea/gradle.xml create mode 100644 .idea/kotlinc.xml create mode 100644 .idea/misc.xml create mode 100644 .idea/vcs.xml create mode 100644 build.gradle.kts create mode 100644 collect/build.gradle.kts create mode 100644 collect/src/main/kotlin/ru/dbotthepony/kommons/collect/CollectionUtils.kt create mode 100644 collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalEnumSet.kt create mode 100644 collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalSet.kt create mode 100644 collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalSupplierSet.kt create mode 100644 collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ProxiedMap.kt create mode 100644 collect/src/main/kotlin/ru/dbotthepony/kommons/collect/StreamyIterators.kt create mode 100644 collect/src/main/kotlin/ru/dbotthepony/kommons/collect/SupplierList.kt create mode 100644 collect/src/main/kotlin/ru/dbotthepony/kommons/collect/SupplierMap.kt create mode 100644 core/build.gradle.kts create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/core/GetterSetter.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/core/KOptional.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/event/IBooleanSubscriptable.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/event/IDoubleSubcripable.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/event/IFloatSubcripable.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/event/IIntSubcripable.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/event/ILongSubcripable.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/event/ISubscriptable.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/event/IUnitSubscripable.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/util/BooleanConsumer.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/util/ComparatorUtils.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/util/FloatConsumer.kt create mode 100644 core/src/main/kotlin/ru/dbotthepony/kommons/util/FloatSupplier.kt create mode 100644 gradle.properties create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100644 gradlew create mode 100644 gradlew.bat create mode 100644 guava/build.gradle.kts create mode 100644 guava/src/main/kotlin/ru/dbotthepony/kommons/collect/GuavaCollections.kt create mode 100644 io-math/build.gradle.kts create mode 100644 io-math/src/main/kotlin/ru/dbotthepony/kommons/io/DecimalIO.kt create mode 100644 io/build.gradle.kts create mode 100644 io/src/main/kotlin/ru/dbotthepony/kommons/io/CollectionStreamCodec.kt create mode 100644 io/src/main/kotlin/ru/dbotthepony/kommons/io/EnumValueCodec.kt create mode 100644 io/src/main/kotlin/ru/dbotthepony/kommons/io/IStreamCodec.kt create mode 100644 io/src/main/kotlin/ru/dbotthepony/kommons/io/InputStreamUtils.kt create mode 100644 io/src/main/kotlin/ru/dbotthepony/kommons/io/OutputStreamUtils.kt create mode 100644 io/src/main/kotlin/ru/dbotthepony/kommons/io/StreamCodecs.kt create mode 100644 math/build.gradle.kts create mode 100644 math/src/main/kotlin/ru/dbotthepony/kommons/math/Decimal.kt create mode 100644 math/src/main/kotlin/ru/dbotthepony/kommons/math/HSVColor.kt create mode 100644 math/src/main/kotlin/ru/dbotthepony/kommons/math/RGBAColor.kt create mode 100644 networking/build.gradle.kts create mode 100644 networking/src/main/kotlin/ru/dbotthepony/kommons/networking/ChangesetAction.kt create mode 100644 networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldAccess.kt create mode 100644 networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldGetter.kt create mode 100644 networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldSetter.kt create mode 100644 networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldSynchronizer.kt create mode 100644 networking/src/main/kotlin/ru/dbotthepony/kommons/networking/Fields.kt create mode 100644 networking/src/main/kotlin/ru/dbotthepony/kommons/networking/MapChangeset.kt create mode 100644 networking/src/main/kotlin/ru/dbotthepony/kommons/networking/MutableFields.kt create mode 100644 networking/src/main/kotlin/ru/dbotthepony/kommons/networking/SetChangeset.kt create mode 100644 settings.gradle.kts diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..b63da45 --- /dev/null +++ b/.gitignore @@ -0,0 +1,42 @@ +.gradle +build/ +!gradle/wrapper/gradle-wrapper.jar +!**/src/main/**/build/ +!**/src/test/**/build/ + +### IntelliJ IDEA ### +.idea/modules.xml +.idea/jarRepositories.xml +.idea/compiler.xml +.idea/libraries/ +*.iws +*.iml +*.ipr +out/ +!**/src/main/**/out/ +!**/src/test/**/out/ + +### Eclipse ### +.apt_generated +.classpath +.factorypath +.project +.settings +.springBeans +.sts4-cache +bin/ +!**/src/main/**/bin/ +!**/src/test/**/bin/ + +### NetBeans ### +/nbproject/private/ +/nbbuild/ +/dist/ +/nbdist/ +/.nb-gradle/ + +### VS Code ### +.vscode/ + +### Mac OS ### +.DS_Store \ No newline at end of file diff --git a/.idea/.gitignore b/.idea/.gitignore new file mode 100644 index 0000000..26d3352 --- /dev/null +++ b/.idea/.gitignore @@ -0,0 +1,3 @@ +# Default ignored files +/shelf/ +/workspace.xml diff --git a/.idea/gradle.xml b/.idea/gradle.xml new file mode 100644 index 0000000..a7f8d22 --- /dev/null +++ b/.idea/gradle.xml @@ -0,0 +1,23 @@ + + + + + + \ No newline at end of file diff --git a/.idea/kotlinc.xml b/.idea/kotlinc.xml new file mode 100644 index 0000000..2b8a50f --- /dev/null +++ b/.idea/kotlinc.xml @@ -0,0 +1,6 @@ + + + + + \ No newline at end of file diff --git a/.idea/misc.xml b/.idea/misc.xml new file mode 100644 index 0000000..43b1638 --- /dev/null +++ b/.idea/misc.xml @@ -0,0 +1,7 @@ + + + + + + + \ No newline at end of file diff --git a/.idea/vcs.xml b/.idea/vcs.xml new file mode 100644 index 0000000..94a25f7 --- /dev/null +++ b/.idea/vcs.xml @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/build.gradle.kts b/build.gradle.kts new file mode 100644 index 0000000..ce235ca --- /dev/null +++ b/build.gradle.kts @@ -0,0 +1,46 @@ + +plugins { + kotlin("jvm") version "1.8.0" + `maven-publish` +} + +repositories { + mavenCentral() +} + +tasks.compileKotlin { + kotlinOptions { + jvmTarget = "17" + freeCompilerArgs += "-opt-in=kotlin.RequiresOptIn" + freeCompilerArgs += "-Xjvm-default=all" + } +} + +tasks.jar { + from(project(":core").sourceSets.main.get().output) + from(project(":io").sourceSets.main.get().output) + from(project(":io-math").sourceSets.main.get().output) + from(project(":math").sourceSets.main.get().output) + from(project(":collect").sourceSets.main.get().output) + from(project(":guava").sourceSets.main.get().output) + from(project(":networking").sourceSets.main.get().output) +} + +subprojects { + apply(plugin = "maven-publish") + + publishing { + repositories { + maven { + url = uri("sftp://maven@dbotthepony.ru:22/maven") + + credentials { + val mavenUser: String by project + val mavenPassword: String by project + username = mavenUser + password = mavenPassword + } + } + } + } +} diff --git a/collect/build.gradle.kts b/collect/build.gradle.kts new file mode 100644 index 0000000..2aa93e5 --- /dev/null +++ b/collect/build.gradle.kts @@ -0,0 +1,40 @@ +plugins { + kotlin("jvm") + `maven-publish` +} + +val collectVersion: String by project +val projectGroup: String by project + +group = projectGroup +version = collectVersion + +repositories { + mavenCentral() +} + +dependencies { + testImplementation("org.jetbrains.kotlin:kotlin-test") +} + +tasks.test { + useJUnitPlatform() +} + +kotlin { + jvmToolchain(17) +} + +publishing { + publications { + create("mavenJava") { + from(components["java"]) + + pom { + dependencies { + implementation(kotlin("stdlib")) + } + } + } + } +} diff --git a/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/CollectionUtils.kt b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/CollectionUtils.kt new file mode 100644 index 0000000..649ce25 --- /dev/null +++ b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/CollectionUtils.kt @@ -0,0 +1,149 @@ +package ru.dbotthepony.kommons.collect + +import java.lang.ref.Reference +import java.util.* +import java.util.stream.Stream +import java.util.stream.StreamSupport + +fun Array.stream(): Stream = Arrays.stream(this) + +@Suppress("unchecked_cast") +fun Stream.filterNotNull(): Stream { + return filter { it != null } as Stream +} + +@Suppress("unchecked_cast") +inline fun Stream<*>.filterIsInstance(): Stream { + return filter { it is T } as Stream +} + +inline fun MutableList>.forValidRefs(fn: (T) -> Unit) { + val iterator = listIterator() + + for (value in iterator) { + val get = value.get() + + if (get == null) { + iterator.remove() + } else { + fn.invoke(get) + } + } +} + +inline fun MutableList>.forValidRefsBreak(fn: (T) -> Boolean) { + val iterator = listIterator() + + for (value in iterator) { + val get = value.get() + + if (get == null) { + iterator.remove() + } else { + if (fn.invoke(get)) { + break + } + } + } +} + +fun Stream.asIterable(): Iterable { + return object : Iterable { + override fun iterator(): Iterator { + return this@asIterable.iterator() + } + } +} + +/** + * Returns applicable index to put [element] into [List] determined by [comparator], optionally specifying ranges as [fromIndex] and [toIndex] + * + * If [List] is not sorted, result of this function is undefined + */ +fun List.searchInsertionIndex(element: E, comparator: Comparator, fromIndex: Int = 0, toIndex: Int = size): Int { + require(toIndex >= fromIndex) { "Invalid range: to $toIndex >= from $fromIndex" } + require(fromIndex >= 0) { "Invalid from index: $fromIndex" } + require(toIndex >= 0) { "Invalid to index: $toIndex" } + require(fromIndex <= size) { "Invalid from index: $fromIndex (list size $size)" } + require(toIndex <= size) { "Invalid to index: $toIndex (list size $size)" } + + if (fromIndex == size || fromIndex == toIndex || comparator.compare(element, this[fromIndex]) <= 0) { + return fromIndex + } + + // линейный поиск если границы маленькие + if (toIndex - fromIndex <= 10) { + for (i in fromIndex + 1 until toIndex) { + val compare = comparator.compare(element, this[i]) + + if (compare <= 0) { + return i + } + } + + return size + } else { + // двоичный поиск + var lower = fromIndex + var upper = toIndex - 1 + + while (upper - lower >= 10) { + val middle = (upper + lower) / 2 + val compare = comparator.compare(element, this[middle]) + + if (compare == 0) { + return middle + } else if (compare < 0) { + upper = middle + } else { + lower = middle + } + } + + return searchInsertionIndex(element, comparator, lower, upper + 1) + } +} + +/** + * Inserts [element] into [MutableList] at index determined by [comparator] + * + * If [MutableList] is not sorted, result of this function is undefined + */ +fun MutableList.addSorted(element: E, comparator: Comparator) { + add(searchInsertionIndex(element, comparator), element) +} + +private object NaturalComparator : Comparator> { + override fun compare(o1: Comparable, o2: Comparable): Int { + return o1.compareTo(o2) + } +} + +/** + * Inserts [element] into [MutableList] at index determined by comparing values themselves + * + * If [MutableList] is not sorted, result of this function is undefined + */ +fun > MutableList.addSorted(element: E) { + add(searchInsertionIndex(element, NaturalComparator as Comparator), element) +} + +fun MutableCollection.addAll(elements: Iterator) { + for (item in elements) { + add(item) + } +} + +fun MutableCollection.addAll(elements: Stream) { + for (item in elements) { + add(item) + } +} + +fun Iterable.stream(): Stream { + return StreamSupport.stream(this.spliterator(), false) +} + +fun Iterator.stream(): Stream { + return StreamSupport.stream(Spliterators.spliteratorUnknownSize(this, 0), false) +} diff --git a/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalEnumSet.kt b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalEnumSet.kt new file mode 100644 index 0000000..34a7394 --- /dev/null +++ b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalEnumSet.kt @@ -0,0 +1,41 @@ +package ru.dbotthepony.kommons.collect + +import java.util.EnumMap +import java.util.function.BooleanSupplier +import java.util.stream.Stream + +class ConditionalEnumSet>private constructor(private val backing: EnumMap, marker: Unit) : Set { + constructor(clazz: Class) : this(EnumMap(clazz), Unit) + constructor(map: Map) : this(EnumMap(map), Unit) + + override val size: Int + get() = backing.values.stream().filter { it.asBoolean }.count().toInt() + + override fun contains(element: T): Boolean { + return backing[element]?.asBoolean ?: false + } + + override fun containsAll(elements: Collection): Boolean { + return elements.all { contains(it) } + } + + override fun isEmpty(): Boolean { + return backing.isEmpty() || backing.values.none { it.asBoolean } + } + + override fun stream(): Stream { + return backing.entries.stream().filter { it.value.asBoolean }.map { it.key } + } + + override fun iterator(): Iterator { + return backing.entries.iterator().filter { it.value.asBoolean }.map { it.key } + } + + fun add(value: T, condition: BooleanSupplier) { + backing[value] = condition + } + + fun remove(value: T): Boolean { + return backing.remove(value) != null + } +} diff --git a/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalSet.kt b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalSet.kt new file mode 100644 index 0000000..208d074 --- /dev/null +++ b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalSet.kt @@ -0,0 +1,89 @@ +package ru.dbotthepony.kommons.collect + +import java.util.function.BooleanSupplier +import java.util.stream.Stream + +/** + * Set, with values appearing and disappearing by conditions + */ +class ConditionalSet : Set { + private class Entry(val value: E, var condition: BooleanSupplier) + private val backing = ArrayList>() + private val mapped = HashMap>() + + override val size: Int + get() = backing.stream().filter { it.condition.asBoolean }.count().toInt() + + override fun contains(element: E): Boolean { + return mapped[element]?.condition?.asBoolean ?: false + } + + override fun containsAll(elements: Collection): Boolean { + return elements.all { contains(it) } + } + + override fun isEmpty(): Boolean { + return mapped.isEmpty() || mapped.values.stream().noneMatch { it.condition.asBoolean } + } + + override fun stream(): Stream { + return backing.stream().filter { it.condition.asBoolean }.map { it.value } + } + + override fun iterator(): Iterator { + return backing.iterator().filter { it.condition.asBoolean }.map { it.value } + } + + fun actuallyContains(element: E): Boolean { + return element in mapped + } + + fun add(element: E, condition: BooleanSupplier): Boolean { + if (element in mapped) return false + val entry = Entry(element, condition) + mapped[element] = entry + backing.add(entry) + return true + } + + fun addFirst(element: E, condition: BooleanSupplier): Boolean { + if (element in mapped) return false + val entry = Entry(element, condition) + mapped[element] = entry + backing.add(0, entry) + return true + } + + fun replace(element: E, condition: BooleanSupplier) { + val entry = mapped[element] + + if (entry != null) { + entry.condition = condition + } else { + add(element, condition) + } + } + + fun replaceFirst(element: E, condition: BooleanSupplier) { + val entry = mapped[element] + + if (entry != null) { + entry.condition = condition + backing.remove(entry) + backing.add(0, entry) + } else { + addFirst(element, condition) + } + } + + fun remove(element: E): Boolean { + val entry = mapped.remove(element) + + if (entry != null) { + backing.remove(entry) + return true + } + + return false + } +} diff --git a/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalSupplierSet.kt b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalSupplierSet.kt new file mode 100644 index 0000000..eb06e4d --- /dev/null +++ b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ConditionalSupplierSet.kt @@ -0,0 +1,62 @@ +package ru.dbotthepony.kommons.collect + +class ConditionalSupplierSet : AbstractSet { + // method without boxing + fun interface Condition { + fun check(): Boolean + } + + private val getters: Array T>> + + constructor(vararg getters: Pair T>) : super() { + this.getters = Array(getters.size) { getters[it] } + } + + constructor(getters: List T>>) : super() { + this.getters = Array(getters.size) { getters[it] } + } + + override val size: Int get() { + var i = 0 + + for (pair in getters) { + if (pair.first.check()) { + i++ + } + } + + return i + } + + override fun iterator(): Iterator { + return object : Iterator { + val parent = getters.iterator() + private var pair: Pair T>? = null + + private fun search() { + for (pair in parent) { + if (pair.first.check()) { + this.pair = pair + return + } + } + + this.pair = null + } + + init { + search() + } + + override fun hasNext(): Boolean { + return pair != null + } + + override fun next(): T { + val pair = pair ?: throw NoSuchElementException() + search() + return pair.second.invoke() + } + } + } +} diff --git a/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ProxiedMap.kt b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ProxiedMap.kt new file mode 100644 index 0000000..e2f4fc2 --- /dev/null +++ b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/ProxiedMap.kt @@ -0,0 +1,315 @@ +package ru.dbotthepony.kommons.collect + +abstract class ProxiedMap(protected val backingMap: MutableMap = HashMap()) : MutableMap { + protected abstract fun onClear() + protected abstract fun onValueAdded(key: K, value: V) + protected abstract fun onValueRemoved(key: K, value: V) + + final override val size: Int + get() = backingMap.size + + final override fun containsKey(key: K): Boolean { + return backingMap.containsKey(key) + } + + final override fun containsValue(value: V): Boolean { + return backingMap.containsValue(value) + } + + final override fun get(key: K): V? { + return backingMap[key] + } + + final override fun isEmpty(): Boolean { + return backingMap.isEmpty() + } + + final override val entries: MutableSet> by lazy { + object : MutableSet> { + override fun add(element: MutableMap.MutableEntry): Boolean { + this@ProxiedMap[element.key] = element.value + return true + } + + override fun addAll(elements: Collection>): Boolean { + for (value in elements) { + add(value) + } + + return true + } + + override fun clear() { + this@ProxiedMap.clear() + } + + private val setParent = this@ProxiedMap.backingMap.entries + + override fun iterator(): MutableIterator> { + return object : MutableIterator> { + private val parent = setParent.iterator() + private var last: MutableMap.MutableEntry? = null + + override fun hasNext(): Boolean { + return parent.hasNext() + } + + override fun next(): MutableMap.MutableEntry { + return parent.next().also { last = it } + } + + override fun remove() { + val last = last ?: throw IllegalStateException("Never called next()") + parent.remove() + onValueRemoved(last.key, last.value) + } + } + } + + override fun remove(element: MutableMap.MutableEntry): Boolean { + if (setParent.remove(element)) { + onValueRemoved(element.key, element.value) + return true + } + + return false + } + + override fun removeAll(elements: Collection>): Boolean { + var any = false + + for (element in elements) { + any = remove(element) || any + } + + return any + } + + override fun retainAll(elements: Collection>): Boolean { + val iterator = this.iterator() + var any = false + + for (value in iterator) { + if (value !in elements) { + iterator.remove() + any = true + } + } + + return any + } + + override val size: Int + get() = setParent.size + + override fun contains(element: MutableMap.MutableEntry): Boolean { + return setParent.contains(element) + } + + override fun containsAll(elements: Collection>): Boolean { + return setParent.containsAll(elements) + } + + override fun isEmpty(): Boolean { + return setParent.isEmpty() + } + } + } + + final override val keys: MutableSet by lazy { + object : MutableSet { + val parent = this@ProxiedMap.backingMap.keys + + override fun add(element: K): Boolean { + throw UnsupportedOperationException() + } + + override fun addAll(elements: Collection): Boolean { + throw UnsupportedOperationException() + } + + override fun clear() { + this@ProxiedMap.clear() + } + + override fun iterator(): MutableIterator { + return object : MutableIterator { + private val parentIterator = parent.iterator() + private var last: K? = null + + override fun hasNext(): Boolean { + return parentIterator.hasNext() + } + + override fun next(): K { + return parentIterator.next().also { last = it } + } + + override fun remove() { + val last = last ?: throw IllegalStateException("Never called next()") + val value = this@ProxiedMap[last] ?: throw ConcurrentModificationException() + parentIterator.remove() + onValueRemoved(last, value) + } + } + } + + override fun remove(element: K): Boolean { + return this@ProxiedMap.remove(element) != null + } + + override fun removeAll(elements: Collection): Boolean { + var changes = false + + for (element in elements) { + changes = remove(element) || changes + } + + return changes + } + + override fun retainAll(elements: Collection): Boolean { + val iterator = this.iterator() + var any = false + + for (element in iterator) { + if (element !in elements) { + iterator.remove() + any = true + } + } + + return any + } + + override val size: Int + get() = parent.size + + override fun contains(element: K): Boolean { + return parent.contains(element) + } + + override fun containsAll(elements: Collection): Boolean { + return parent.containsAll(elements) + } + + override fun isEmpty(): Boolean { + return parent.isEmpty() + } + } + } + + final override val values: MutableCollection by lazy { + object : MutableCollection { + private val parent = this@ProxiedMap.backingMap.values + + override val size: Int + get() = parent.size + + override fun contains(element: V): Boolean { + return parent.contains(element) + } + + override fun containsAll(elements: Collection): Boolean { + return parent.containsAll(elements) + } + + override fun isEmpty(): Boolean { + return parent.isEmpty() + } + + override fun add(element: V): Boolean { + throw UnsupportedOperationException() + } + + override fun addAll(elements: Collection): Boolean { + throw UnsupportedOperationException() + } + + override fun clear() { + this@ProxiedMap.clear() + } + + override fun iterator(): MutableIterator { + return object : MutableIterator { + private val parentIterator = parent.iterator() + + override fun hasNext(): Boolean { + return parentIterator.hasNext() + } + + override fun next(): V { + return parentIterator.next() + } + + override fun remove() { + parentIterator.remove() + } + } + } + + override fun remove(element: V): Boolean { + val indexOf = this@ProxiedMap.backingMap.firstNotNullOfOrNull { if (it.value == element) it.key else null } ?: return false + this@ProxiedMap.remove(indexOf) + return true + } + + override fun removeAll(elements: Collection): Boolean { + var changes = false + + for (element in elements) { + changes = remove(element) || changes + } + + return changes + } + + override fun retainAll(elements: Collection): Boolean { + val iterator = this.iterator() + var changes = false + + for (element in iterator) { + if (element !in elements) { + iterator.remove() + changes = true + } + } + + return changes + } + } + } + + override fun clear() { + onClear() + return backingMap.clear() + } + + override fun put(key: K, value: V): V? { + val existing = backingMap.put(key, value) + + if (existing == value) { + return existing + } + + onValueAdded(key, value) + return existing + } + + final override fun putAll(from: Map) { + for ((k, v) in from) { + this[k] = v + } + } + + override fun remove(key: K): V? { + val removed = backingMap.remove(key) + + if (removed != null) { + onValueRemoved(key, removed) + } + + return removed + } +} + diff --git a/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/StreamyIterators.kt b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/StreamyIterators.kt new file mode 100644 index 0000000..52ce11f --- /dev/null +++ b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/StreamyIterators.kt @@ -0,0 +1,421 @@ +package ru.dbotthepony.kommons.collect + +import java.util.* +import java.util.function.Predicate +import java.util.stream.Collector +import java.util.stream.Stream +import java.util.stream.StreamSupport + +// Purpose of Stream API over Iterators is that it is simple enough for JIT to inline most of it, +// unlike actual Streams. + +// We lose only one (actual) element of Stream API here: ability to parallelize work, +// except it doesn't (properly) work in Minecraft (Forge) either, due to classloader bug: +// https://github.com/MinecraftForge/EventBus/issues/44 + +// Aside parallel work, unimplemented Stream API elements can be easily implemented when required + +private class FilteringIterator(private val parent: Iterator, private val predicate: Predicate, private var value: T) : MutableIterator { + private var hasValue = true + private var returned = false + + override fun hasNext(): Boolean { + return hasValue + } + + override fun next(): T { + if (!hasValue) throw NoSuchElementException() + hasValue = false + returned = true + + val value = this.value + + while (parent.hasNext()) { + val next = parent.next() + + if (predicate.test(next)) { + hasValue = true + this.value = next + break + } + } + + return value + } + + override fun remove() { + if (!returned) throw NoSuchElementException() + returned = false + (parent as MutableIterator).remove() + } +} + +private class MappingIterator(private val parent: Iterator, private val mapper: (T) -> R) : MutableIterator { + override fun hasNext(): Boolean { + return parent.hasNext() + } + + override fun next(): R { + return mapper.invoke(parent.next()) + } + + override fun remove() { + (parent as MutableIterator).remove() + } +} + +private class FlatMappingIterator(private val parent: Iterator, private val mapper: (T) -> Iterator) : MutableIterator { + private var current: Iterator = mapper.invoke(parent.next()) + private var last: Iterator? = null + + init { + while (!current.hasNext() && parent.hasNext()) { + current = mapper.invoke(parent.next()) + } + } + + override fun hasNext(): Boolean { + return current.hasNext() + } + + override fun next(): R { + if (!current.hasNext()) + throw NoSuchElementException() + + val v = current.next() + last = current + + while (!current.hasNext() && parent.hasNext()) { + current = mapper.invoke(parent.next()) + } + + return v + } + + override fun remove() { + (last as MutableIterator? ?: throw NoSuchElementException()).remove() + last = null + } +} + +private class LimitingIterator(private val parent: Iterator, private val limit: Long) : Iterator { + init { + require(limit > 0) { "Invalid limit $limit" } + } + + private var found = 0L + + override fun hasNext(): Boolean { + return found < limit && parent.hasNext() + } + + override fun next(): T { + if (found >= limit) + throw NoSuchElementException() + + return parent.next() + } +} + +private class SkippingIterator(private val parent: Iterator, skip: Long) : MutableIterator { + init { + require(skip >= 0) { "Invalid skip amount $skip" } + } + + private var found = skip + private var returned = false + + override fun hasNext(): Boolean { + while (parent.hasNext() && found > 0L) { + found-- + parent.next() + } + + return parent.hasNext() + } + + override fun next(): T { + if (!hasNext()) + throw NoSuchElementException() + + val v = parent.next() + returned = true + return v + } + + override fun remove() { + if (!returned) { + throw NoSuchElementException() + } + + returned = false + (parent as MutableIterator).remove() + } +} + +fun concatIterators(): MutableIterator { + return listOf().iterator() as MutableIterator +} + +fun concatIterators(a: Iterator): MutableIterator { + return a as MutableIterator +} + +fun concatIterators(iterators: Iterable>): MutableIterator { + return iterators.iterator().flatMap { it } +} + +fun concatIterators(vararg iterators: Iterator): MutableIterator { + return iterators.iterator().flatMap { it } +} + +/** + * Filters elements of [this] iterator + * + * Resulting [Iterator] is [MutableIterator] if [this] is + */ +fun Iterator.filter(condition: Predicate): MutableIterator { + while (hasNext()) { + val v = next() + + if (condition.test(v)) { + return FilteringIterator(this, condition, v) + } + } + + return emptyIterator() +} + +/** + * Maps elements of [this] iterator from values of [T] to [R] using function [mapper] + * + * Resulting [Iterator] is [MutableIterator] if [this] is + */ +fun Iterator.map(mapper: (T) -> R): MutableIterator { + if (!hasNext()) { + return emptyIterator() + } + + return MappingIterator(this, mapper) +} + +/** + * Maps elements of [this] iterator from type [T] to other iterators of type [R] using function [mapper] + * + * Resulting [Iterator] is [MutableIterator] if [this] is + */ +fun Iterator.flatMap(mapper: (T) -> Iterator): MutableIterator { + if (!hasNext()) { + return emptyIterator() + } + + return FlatMappingIterator(this, mapper) +} + +inline fun Iterator.reduce(identity: T, reducer: (T, T) -> T): T { + var result = identity + while (hasNext()) result = reducer.invoke(result, next()) + return result +} + +fun Iterator.filterNotNull(): MutableIterator = filter { it != null } as MutableIterator + +inline fun Iterator<*>.filterIsInstance(): MutableIterator = filter { it is T } as MutableIterator + +fun Iterator.any(predicate: Predicate): Boolean { + while (hasNext()) + if (predicate.test(next())) + return true + + return false +} + +inline fun Iterator.any(predicate: (T) -> Boolean): Boolean { + while (hasNext()) + if (predicate.invoke(next())) + return true + + return false +} + +fun Iterator.all(predicate: Predicate): Boolean { + while (hasNext()) + if (!predicate.test(next())) + return false + + return true +} + +inline fun Iterator.all(predicate: (T) -> Boolean): Boolean { + while (hasNext()) + if (!predicate.invoke(next())) + return false + + return true +} + +fun Iterator.none(predicate: Predicate): Boolean { + while (hasNext()) + if (predicate.test(next())) + return false + + return true +} + +inline fun Iterator.none(predicate: (T) -> Boolean): Boolean { + while (hasNext()) + if (predicate.invoke(next())) + return false + + return true +} + +fun Iterator.collect(collector: Collector): R { + val accumulator = collector.accumulator() + val instance = collector.supplier().get() + + for (value in this) { + accumulator.accept(instance, value) + } + + return collector.finisher().apply(instance) +} + +fun Iterator.toList(expectedSize: Int = 16): MutableList { + val result = ArrayList(expectedSize) + result.addAll(this) + return result +} + +fun Iterator.toImmutableList(expectedSize: Int = 16): List { + if (!hasNext()) + return emptyList() + + return toList(expectedSize) +} + +fun Iterator.find(): Optional { + if (hasNext()) { + return Optional.of(next()) + } + + return Optional.empty() +} + +fun Iterator.limit(limit: Long): Iterator = LimitingIterator(this, limit) +fun Iterator.skip(skip: Long): Iterator = if (skip == 0L) this else SkippingIterator(this, skip) + +inline fun Iterator.forEach(action: (T) -> Unit) { + for (value in this) { + action.invoke(value) + } +} + +fun Iterator.min(comparator: Comparator): Optional { + if (!hasNext()) { + return Optional.empty() + } + + var min = next() + + for (value in this) { + if (comparator.compare(min, value) > 0) { + min = value + } + } + + return Optional.of(min) +} + +fun Iterator.max(comparator: Comparator): Optional { + if (!hasNext()) { + return Optional.empty() + } + + var max = next() + + for (value in this) { + if (comparator.compare(max, value) < 0) { + max = value + } + } + + return Optional.of(max) +} + +fun Iterator.peek(peeker: (T) -> Unit): MutableIterator { + return object : MutableIterator { + override fun hasNext(): Boolean { + return this@peek.hasNext() + } + + override fun next(): T { + return this@peek.next().also(peeker) + } + + override fun remove() { + (this@peek as MutableIterator).remove() + } + } +} + +fun Iterator.maybe(): T? { + return if (hasNext()) + next() + else + null +} + +fun emptyIterator(): MutableIterator { + return emptyList().iterator() as MutableIterator +} + +fun iteratorOf(value: T): Iterator { + return object : Iterator { + private var next = true + private var v: T? = value + + override fun hasNext(): Boolean { + return next + } + + override fun next(): T { + if (!next) + throw NoSuchElementException() + + val v = v + this.v = null + return v as T + } + } +} + +fun iteratorOf(vararg value: T): Iterator { + return value.iterator() +} + +fun Iterator.toStream(): Stream { + return StreamSupport.stream(Spliterators.spliteratorUnknownSize(this, 0), false) +} + +fun Iterator.allEqual(): Boolean { + if (hasNext()) { + val v = next() + + while (hasNext()) { + if (v != next()) { + return false + } + } + + return true + } + + return false +} + +fun Iterator.count(): Long { + var count = 0L + while (hasNext()) count++ + return count +} diff --git a/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/SupplierList.kt b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/SupplierList.kt new file mode 100644 index 0000000..9f98b2e --- /dev/null +++ b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/SupplierList.kt @@ -0,0 +1,43 @@ +package ru.dbotthepony.kommons.collect + +import java.util.concurrent.Future +import java.util.function.Supplier +import java.util.stream.Stream + +class SupplierList : AbstractList { + private val getters: Array> + + constructor(getters: Collection>) : super() { + val iterator = getters.iterator() + this.getters = Array(getters.size) { iterator.next() } + } + + constructor(getters: Stream>) : super() { + this.getters = getters.toArray { arrayOfNulls>(it) } + } + + constructor(vararg getters: Supplier) : super() { + this.getters = Array(getters.size) { getters[it] } + } + + constructor(size: Int, provider: (Int) -> Supplier) { + this.getters = Array(size, provider) + } + + override val size: Int + get() = getters.size + + override fun get(index: Int): T { + return getters[index].get() + } + + companion object { + fun ofLazy(vararg values: Lazy): SupplierList { + return SupplierList(values.stream().map { Supplier { it.value } }) + } + + fun ofFuture(vararg values: Future): SupplierList { + return SupplierList(values.stream().map { Supplier { it.get() } }) + } + } +} diff --git a/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/SupplierMap.kt b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/SupplierMap.kt new file mode 100644 index 0000000..29944b8 --- /dev/null +++ b/collect/src/main/kotlin/ru/dbotthepony/kommons/collect/SupplierMap.kt @@ -0,0 +1,55 @@ +package ru.dbotthepony.kommons.collect + +import java.util.Collections +import java.util.function.Supplier +import java.util.stream.Stream + +class SupplierMap(values: Stream>>) : Map { + private val backing = HashMap>() + override val entries: Set> + + override val keys: Set + get() = backing.keys + + override val size: Int + get() = entries.size + + override val values: Collection + + init { + values.forEach { + backing[it.first] = it.second + } + + entries = Collections.unmodifiableSet(HashSet(backing.entries.map { Entry(it.key, it.value) })) + this.values = SupplierList(backing.values) + } + + override fun containsKey(key: K): Boolean { + return key in keys + } + + override fun containsValue(value: T): Boolean { + return value in values + } + + override fun get(key: K): T? { + return backing[key]?.get() + } + + override fun isEmpty(): Boolean { + return entries.isEmpty() + } + + constructor(vararg mValues: Pair>) : this((mValues as Array>>).stream()) + constructor(mValues: Collection>>) : this(mValues.stream()) + constructor(mValues: Map>) : this(mValues.entries.stream().map { it.key to it.value }) + + private inner class Entry( + override val key: K, + val getter: Supplier + ) : Map.Entry { + override val value: T + get() = getter.get() + } +} diff --git a/core/build.gradle.kts b/core/build.gradle.kts new file mode 100644 index 0000000..676208e --- /dev/null +++ b/core/build.gradle.kts @@ -0,0 +1,41 @@ + +plugins { + kotlin("jvm") + `maven-publish` +} + +val coreVersion: String by project +val projectGroup: String by project + +group = projectGroup +version = coreVersion + +repositories { + mavenCentral() +} + +dependencies { + testImplementation("org.jetbrains.kotlin:kotlin-test") +} + +tasks.test { + useJUnitPlatform() +} + +kotlin { + jvmToolchain(17) +} + +publishing { + publications { + create("mavenJava") { + from(components["java"]) + + pom { + dependencies { + implementation(kotlin("stdlib")) + } + } + } + } +} diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/core/GetterSetter.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/core/GetterSetter.kt new file mode 100644 index 0000000..ebf43ae --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/core/GetterSetter.kt @@ -0,0 +1,149 @@ +package ru.dbotthepony.kommons.core + +import ru.dbotthepony.kommons.event.ISubscriptable +import java.util.function.Consumer +import java.util.function.Supplier +import kotlin.properties.ReadWriteProperty +import kotlin.reflect.KMutableProperty0 +import kotlin.reflect.KProperty + +inline var GetterSetter.value: V + get() = get() + set(value) { accept(value) } + +interface GetterSetter : Supplier, Consumer, ReadWriteProperty { + override fun setValue(thisRef: Any?, property: KProperty<*>, value: V) { + accept(value) + } + + override fun getValue(thisRef: Any?, property: KProperty<*>): V { + return get() + } + + operator fun invoke(): V { + return get() + } + + operator fun invoke(value: V) { + accept(value) + } + + fun asGetterOnly(): GetterSetter { + val self = this + + return object : GetterSetter { + override fun get(): V { + return self.get() + } + + override fun accept(t: V) { + } + } + } + + fun watch(watch: (old: V, new: V) -> Unit): GetterSetter { + val self = this + + return object : GetterSetter by self { + override fun accept(t: V) { + val old = get() + self.accept(t) + watch.invoke(old, t) + } + } + } + + companion object { + fun of(getter: Supplier, setter: Consumer): GetterSetter { + return object : GetterSetter { + override fun get(): V { + return getter.get() + } + + override fun accept(t: V) { + setter.accept(t) + } + } + } + + fun of(getter: () -> V, setter: (V) -> Unit): GetterSetter { + return object : GetterSetter { + override fun get(): V { + return getter.invoke() + } + + override fun accept(t: V) { + setter.invoke(t) + } + } + } + + fun of(property: KMutableProperty0): GetterSetter { + return object : GetterSetter { + override fun get(): V { + return property.get() + } + + override fun accept(t: V) { + property.set(t) + } + } + } + + fun box(value: V): SentientGetterSetter { + return object : SentientGetterSetter { + private val subs = ISubscriptable.Impl() + + override fun addListener(listener: Consumer): ISubscriptable.L { + return subs.addListener(listener) + } + + private var value = value + + override fun get(): V { + return value + } + + override fun accept(t: V) { + this.value = t + subs.accept(t) + } + } + } + } +} + +interface SentientGetterSetter : GetterSetter, ISubscriptable { + override fun watch(watch: (old: V, new: V) -> Unit): SentientGetterSetter { + val self = this + + return object : SentientGetterSetter by self { + override fun accept(t: V) { + val old = get() + self.accept(t) + watch.invoke(old, t) + } + } + } + +} + +operator fun Supplier.getValue(thisRef: Any?, property: KProperty<*>): T { + return get() +} + +operator fun Consumer.setValue(thisRef: Any?, property: KProperty<*>, value: T) { + accept(value) +} + +fun KMutableProperty0.asGetterSetter(watch: ((old: V, new: V) -> Unit)? = null): GetterSetter { + return GetterSetter.of(this).let { + if (watch != null) { + it.watch(watch) + } else { + it + } + } +} + +fun KMutableProperty0.asGetterOnly() = GetterSetter.of(Supplier { this.get() }, Consumer { /* do nothing */ }) diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/core/KOptional.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/core/KOptional.kt new file mode 100644 index 0000000..953d441 --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/core/KOptional.kt @@ -0,0 +1,152 @@ +package ru.dbotthepony.kommons.core + +import java.util.function.Supplier + +fun KOptional(value: T) = KOptional.of(value) +fun KOptional(value: Boolean) = KOptional.of(value) +fun KOptional(value: Boolean?) = KOptional.of(value) + +/** + * [java.util.Optional] supporting nulls + * + * This is done for structures, where value can be absent, + * or can be present, including literal "null" as possible present value, + * in more elegant solution than handling nullable Optionals + */ +class KOptional private constructor(private val _value: T, val isPresent: Boolean) : Supplier { + /** + * @throws NoSuchElementException + */ + val value: T get() { + if (isPresent) { + return _value + } + + throw NoSuchElementException("No value is present") + } + + inline fun ifPresent(block: (T) -> Unit): KOptional { + if (isPresent) { + block.invoke(value) + } + + return this + } + + inline fun ifNotPresent(block: () -> Unit): KOptional { + if (!isPresent) { + block.invoke() + } + + return this + } + + inline fun map(block: (T) -> R): KOptional { + if (isPresent) { + return of(block.invoke(value)) + } else { + return empty() + } + } + + @Suppress("NOTHING_TO_INLINE") + inline fun orElse(value: T): T { + if (isPresent) { + return this.value + } else { + return value + } + } + + inline fun orElse(value: () -> T): T { + if (isPresent) { + return this.value + } else { + return value.invoke() + } + } + + infix fun or(value: KOptional): KOptional { + if (isPresent) { + return this + } else { + return value + } + } + + override fun equals(other: Any?): Boolean { + return this === other || other is KOptional<*> && isPresent == other.isPresent && _value == other._value + } + + override fun hashCode(): Int { + return _value.hashCode() + 43839429 + } + + override fun toString(): String { + if (isPresent) { + return "KOptional[value = $value]" + } else { + return "KOptional[empty]" + } + } + + override fun get(): T { + return value + } + + // gson hack since type token can't diff between nullable and non-null types + @Deprecated("internal class") + internal class Nullable private constructor() + @Deprecated("internal class") + internal class NotNull private constructor() + + companion object { + private val EMPTY = KOptional(null, false) + private val NULL = KOptional(null, true) + private val TRUE = KOptional(true, true) + private val FALSE = KOptional(false, true) + + @JvmStatic + fun empty(): KOptional { + return EMPTY as KOptional + } + + @JvmStatic + fun of(value: T): KOptional { + if (value == null) { + return NULL as KOptional + } else { + return KOptional(value, true) + } + } + + @JvmStatic + fun ofNullable(value: T): KOptional { + if (value == null) { + return EMPTY as KOptional + } else { + return KOptional(value, true) + } + } + + @JvmStatic + fun of(value: Boolean): KOptional { + if (value) { + return TRUE + } else { + return FALSE + } + } + + @JvmStatic + fun of(value: Boolean?): KOptional { + if (value == null) { + return NULL as KOptional + } else if (value) { + return TRUE + } else { + return FALSE + } + } + } +} diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/event/IBooleanSubscriptable.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/event/IBooleanSubscriptable.kt new file mode 100644 index 0000000..dc817fb --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/event/IBooleanSubscriptable.kt @@ -0,0 +1,43 @@ +package ru.dbotthepony.kommons.event + +import ru.dbotthepony.kommons.util.BooleanConsumer +import java.util.function.Consumer + +interface IBooleanSubscriptable : ISubscriptable { + @Deprecated("Use type specific listener") + override fun addListener(listener: Consumer): ISubscriptable.L { + return addListener(listener::accept) + } + + fun addListener(listener: BooleanConsumer): ISubscriptable.L + + class Impl : IBooleanSubscriptable, Consumer, BooleanConsumer { + private inner class L(val callback: BooleanConsumer) : ISubscriptable.L { + private var isRemoved = false + + init { + subscribers.add(this) + } + + override fun remove() { + if (!isRemoved) { + isRemoved = true + queue.add(this) + } + } + } + + private val subscribers = LinkedHashSet(0) + private val queue = ArrayList(0) + + override fun addListener(listener: BooleanConsumer): ISubscriptable.L { + return L(listener) + } + + override fun accept(t: Boolean) { + queue.forEach { subscribers.remove(it) } + queue.clear() + subscribers.forEach { it.callback.accept(t) } + } + } +} \ No newline at end of file diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/event/IDoubleSubcripable.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/event/IDoubleSubcripable.kt new file mode 100644 index 0000000..15c0a46 --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/event/IDoubleSubcripable.kt @@ -0,0 +1,43 @@ +package ru.dbotthepony.kommons.event + +import java.util.function.Consumer +import java.util.function.DoubleConsumer + +interface IDoubleSubcripable : ISubscriptable { + @Deprecated("Use type specific listener") + override fun addListener(listener: Consumer): ISubscriptable.L { + return addListener(DoubleConsumer { listener.accept(it) }) + } + + fun addListener(listener: DoubleConsumer): ISubscriptable.L + + class Impl : IDoubleSubcripable, Consumer, DoubleConsumer { + private inner class L(val callback: DoubleConsumer) : ISubscriptable.L { + private var isRemoved = false + + init { + subscribers.add(this) + } + + override fun remove() { + if (!isRemoved) { + isRemoved = true + queue.add(this) + } + } + } + + private val subscribers = LinkedHashSet(0) + private val queue = ArrayList(0) + + override fun addListener(listener: DoubleConsumer): ISubscriptable.L { + return L(listener) + } + + override fun accept(t: Double) { + queue.forEach { subscribers.remove(it) } + queue.clear() + subscribers.forEach { it.callback.accept(t) } + } + } +} \ No newline at end of file diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/event/IFloatSubcripable.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/event/IFloatSubcripable.kt new file mode 100644 index 0000000..8933745 --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/event/IFloatSubcripable.kt @@ -0,0 +1,43 @@ +package ru.dbotthepony.kommons.event + +import ru.dbotthepony.kommons.util.FloatConsumer +import java.util.function.Consumer + +interface IFloatSubcripable : ISubscriptable { + @Deprecated("Use type specific listener") + override fun addListener(listener: Consumer): ISubscriptable.L { + return addListener(listener::accept) + } + + fun addListener(listener: FloatConsumer): ISubscriptable.L + + class Impl : IFloatSubcripable, Consumer, FloatConsumer { + private inner class L(val callback: FloatConsumer) : ISubscriptable.L { + private var isRemoved = false + + init { + subscribers.add(this) + } + + override fun remove() { + if (!isRemoved) { + isRemoved = true + queue.add(this) + } + } + } + + private val subscribers = LinkedHashSet(0) + private val queue = ArrayList(0) + + override fun addListener(listener: FloatConsumer): ISubscriptable.L { + return L(listener) + } + + override fun accept(t: Float) { + queue.forEach { subscribers.remove(it) } + queue.clear() + subscribers.forEach { it.callback.accept(t) } + } + } +} \ No newline at end of file diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/event/IIntSubcripable.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/event/IIntSubcripable.kt new file mode 100644 index 0000000..5d39b02 --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/event/IIntSubcripable.kt @@ -0,0 +1,43 @@ +package ru.dbotthepony.kommons.event + +import java.util.function.Consumer +import java.util.function.IntConsumer + +interface IIntSubcripable : ISubscriptable { + @Deprecated("Use type specific listener") + override fun addListener(listener: Consumer): ISubscriptable.L { + return addListener(IntConsumer { listener.accept(it) }) + } + + fun addListener(listener: IntConsumer): ISubscriptable.L + + class Impl : IIntSubcripable, Consumer, IntConsumer { + private inner class L(val callback: IntConsumer) : ISubscriptable.L { + private var isRemoved = false + + init { + subscribers.add(this) + } + + override fun remove() { + if (!isRemoved) { + isRemoved = true + queue.add(this) + } + } + } + + private val subscribers = LinkedHashSet(0) + private val queue = ArrayList(0) + + override fun addListener(listener: IntConsumer): ISubscriptable.L { + return L(listener) + } + + override fun accept(t: Int) { + queue.forEach { subscribers.remove(it) } + queue.clear() + subscribers.forEach { it.callback.accept(t) } + } + } +} \ No newline at end of file diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/event/ILongSubcripable.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/event/ILongSubcripable.kt new file mode 100644 index 0000000..7684670 --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/event/ILongSubcripable.kt @@ -0,0 +1,43 @@ +package ru.dbotthepony.kommons.event + +import java.util.function.Consumer +import java.util.function.LongConsumer + +interface ILongSubcripable : ISubscriptable { + @Deprecated("Use type specific listener") + override fun addListener(listener: Consumer): ISubscriptable.L { + return addListener(LongConsumer { listener.accept(it) }) + } + + fun addListener(listener: LongConsumer): ISubscriptable.L + + class Impl : ILongSubcripable, Consumer, LongConsumer { + private inner class L(val callback: LongConsumer) : ISubscriptable.L { + private var isRemoved = false + + init { + subscribers.add(this) + } + + override fun remove() { + if (!isRemoved) { + isRemoved = true + queue.add(this) + } + } + } + + private val subscribers = LinkedHashSet(0) + private val queue = ArrayList(0) + + override fun addListener(listener: LongConsumer): ISubscriptable.L { + return L(listener) + } + + override fun accept(t: Long) { + queue.forEach { subscribers.remove(it) } + queue.clear() + subscribers.forEach { it.callback.accept(t) } + } + } +} \ No newline at end of file diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/event/ISubscriptable.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/event/ISubscriptable.kt new file mode 100644 index 0000000..d188f14 --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/event/ISubscriptable.kt @@ -0,0 +1,60 @@ +package ru.dbotthepony.kommons.event + +import java.util.function.Consumer + +interface ISubscriptable { + /** + * Listener token, allows to remove listener from subscriber list + */ + fun interface L { + /** + * Removes this listener + */ + fun remove() + } + + fun addListener(listener: Consumer): L + + class Impl : ISubscriptable, Consumer { + private inner class L(val callback: Consumer) : ISubscriptable.L { + private var isRemoved = false + + init { + subscribers.add(this) + } + + override fun remove() { + if (!isRemoved) { + isRemoved = true + queue.add(this) + } + } + } + + private val subscribers = LinkedHashSet(0) + private val queue = ArrayList(0) + + override fun addListener(listener: Consumer): ISubscriptable.L { + return L(listener) + } + + override fun accept(t: V) { + queue.forEach { subscribers.remove(it) } + queue.clear() + subscribers.forEach { it.callback.accept(t) } + } + } + + companion object : ISubscriptable, L { + @Suppress("unchecked_cast") + fun empty(): ISubscriptable { + return this as ISubscriptable + } + + override fun remove() {} + + override fun addListener(listener: Consumer): L { + return this + } + } +} diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/event/IUnitSubscripable.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/event/IUnitSubscripable.kt new file mode 100644 index 0000000..05d6304 --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/event/IUnitSubscripable.kt @@ -0,0 +1,41 @@ +package ru.dbotthepony.kommons.event + +import java.util.function.Consumer + +interface IUnitSubscripable : ISubscriptable { + fun addListener(listener: Runnable): ISubscriptable.L + + override fun addListener(listener: Consumer): ISubscriptable.L { + return addListener(Runnable { listener.accept(Unit) }) + } + + class Impl : IUnitSubscripable, Runnable { + private inner class L(val callback: Runnable) : ISubscriptable.L { + private var isRemoved = false + + init { + subscribers.add(this) + } + + override fun remove() { + if (!isRemoved) { + isRemoved = true + queue.add(this) + } + } + } + + private val subscribers = LinkedHashSet(0) + private val queue = ArrayList(0) + + override fun addListener(listener: Runnable): ISubscriptable.L { + return L(listener) + } + + override fun run() { + queue.forEach { subscribers.remove(it) } + queue.clear() + subscribers.forEach { it.callback.run() } + } + } +} \ No newline at end of file diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/util/BooleanConsumer.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/util/BooleanConsumer.kt new file mode 100644 index 0000000..23c1e79 --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/util/BooleanConsumer.kt @@ -0,0 +1,7 @@ +package ru.dbotthepony.kommons.util + +import java.util.function.Consumer + +fun interface BooleanConsumer : Consumer { + override fun accept(value: Boolean) +} diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/util/ComparatorUtils.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/util/ComparatorUtils.kt new file mode 100644 index 0000000..d7f153d --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/util/ComparatorUtils.kt @@ -0,0 +1,38 @@ +package ru.dbotthepony.kommons.util + +import java.util.function.Supplier + + +fun Comparator.nullsFirst(): Comparator { + return Comparator.nullsFirst(this) +} + +fun Comparator.nullsLast(): Comparator { + return Comparator.nullsLast(this) +} + +class MappedComparator(private val parent: Comparator, private val mapper: (T) -> O) : Comparator { + override fun compare(o1: T, o2: T): Int { + return parent.compare(mapper.invoke(o1), mapper.invoke(o2)) + } + + override fun equals(other: Any?): Boolean { + return other is MappedComparator<*, *> && parent == other.parent + } + + override fun hashCode(): Int { + return parent.hashCode() + } + + override fun toString(): String { + return "MappedComparator[$parent]" + } +} + +fun Comparator.map(mapper: (B) -> A): Comparator { + return MappedComparator(this, mapper) +} + +fun Comparator.suppliers(): Comparator> { + return MappedComparator(this) { it.get() } +} diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/util/FloatConsumer.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/util/FloatConsumer.kt new file mode 100644 index 0000000..d013ad5 --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/util/FloatConsumer.kt @@ -0,0 +1,7 @@ +package ru.dbotthepony.kommons.util + +import java.util.function.Consumer + +fun interface FloatConsumer : Consumer { + override fun accept(value: Float) +} diff --git a/core/src/main/kotlin/ru/dbotthepony/kommons/util/FloatSupplier.kt b/core/src/main/kotlin/ru/dbotthepony/kommons/util/FloatSupplier.kt new file mode 100644 index 0000000..082fc5e --- /dev/null +++ b/core/src/main/kotlin/ru/dbotthepony/kommons/util/FloatSupplier.kt @@ -0,0 +1,12 @@ +package ru.dbotthepony.kommons.util + +import java.util.function.Supplier + +fun interface FloatSupplier : Supplier { + fun getAsFloat(): Float + + @Deprecated("Use type-specific method", replaceWith = ReplaceWith("this.getAsFloat()")) + override fun get(): Float { + return getAsFloat() + } +} diff --git a/gradle.properties b/gradle.properties new file mode 100644 index 0000000..282f804 --- /dev/null +++ b/gradle.properties @@ -0,0 +1,14 @@ + +kotlin.code.style=official + +projectGroup=ru.dbotthepony.kommons + +guavaDepVersion=33.0.0 + +kommonsVersion=1.0 +coreVersion=1.0 +ioVersion=1.0 +networkingVersion=1.0 +mathVersion=1.0 +collectVersion=1.0 +guavaVersion=1.0 diff --git a/gradle/wrapper/gradle-wrapper.jar b/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..249e5832f090a2944b7473328c07c9755baa3196 GIT binary patch literal 60756 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 '} + case $link in #( + /*) app_path=$link ;; #( + *) app_path=$APP_HOME$link ;; + esac +done + +APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit + +APP_NAME="Gradle" +APP_BASE_NAME=${0##*/} + +# 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"' + +# Use the maximum available, or set MAX_FD != -1 to use that value. +MAX_FD=maximum + +warn () { + echo "$*" +} >&2 + +die () { + echo + echo "$*" + echo + exit 1 +} >&2 + +# OS specific support (must be 'true' or 'false'). +cygwin=false +msys=false +darwin=false +nonstop=false +case "$( uname )" in #( + CYGWIN* ) cygwin=true ;; #( + Darwin* ) darwin=true ;; #( + MSYS* | MINGW* ) msys=true ;; #( + NONSTOP* ) nonstop=true ;; +esac + +CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar + + +# Determine the Java command to use to start the JVM. +if [ -n "$JAVA_HOME" ] ; then + if [ -x "$JAVA_HOME/jre/sh/java" ] ; then + # IBM's JDK on AIX uses strange locations for the executables + JAVACMD=$JAVA_HOME/jre/sh/java + else + JAVACMD=$JAVA_HOME/bin/java + fi + if [ ! -x "$JAVACMD" ] ; then + die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." + fi +else + JAVACMD=java + which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. + +Please set the JAVA_HOME variable in your environment to match the +location of your Java installation." +fi + +# Increase the maximum file descriptors if we can. +if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then + case $MAX_FD in #( + max*) + MAX_FD=$( ulimit -H -n ) || + warn "Could not query maximum file descriptor limit" + esac + case $MAX_FD in #( + '' | soft) :;; #( + *) + ulimit -n "$MAX_FD" || + warn "Could not set maximum file descriptor limit to $MAX_FD" + esac +fi + +# Collect all arguments for the java command, stacking in reverse order: +# * args from the command line +# * the main class name +# * -classpath +# * -D...appname settings +# * --module-path (only if needed) +# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables. + +# For Cygwin or MSYS, switch paths to Windows format before running java +if "$cygwin" || "$msys" ; then + APP_HOME=$( cygpath --path --mixed "$APP_HOME" ) + CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" ) + + JAVACMD=$( cygpath --unix "$JAVACMD" ) + + # Now convert the arguments - kludge to limit ourselves to /bin/sh + for arg do + if + case $arg in #( + -*) false ;; # don't mess with options #( + /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath + [ -e "$t" ] ;; #( + *) false ;; + esac + then + arg=$( cygpath --path --ignore --mixed "$arg" ) + fi + # Roll the args list around exactly as many times as the number of + # args, so each arg winds up back in the position where it started, but + # possibly modified. + # + # NB: a `for` loop captures its iteration list before it begins, so + # changing the positional parameters here affects neither the number of + # iterations, nor the values presented in `arg`. + shift # remove old arg + set -- "$@" "$arg" # push replacement arg + done +fi + +# Collect all arguments for the java command; +# * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of +# shell script including quotes and variable substitutions, so put them in +# double quotes to make sure that they get re-expanded; and +# * put everything else in single quotes, so that it's not re-expanded. + +set -- \ + "-Dorg.gradle.appname=$APP_BASE_NAME" \ + -classpath "$CLASSPATH" \ + org.gradle.wrapper.GradleWrapperMain \ + "$@" + +# Use "xargs" to parse quoted args. +# +# With -n1 it outputs one arg per line, with the quotes and backslashes removed. +# +# In Bash we could simply go: +# +# readarray ARGS < <( xargs -n1 <<<"$var" ) && +# set -- "${ARGS[@]}" "$@" +# +# but POSIX shell has neither arrays nor command substitution, so instead we +# post-process each arg (as a line of input to sed) to backslash-escape any +# character that might be a shell metacharacter, then use eval to reverse +# that process (while maintaining the separation between arguments), and wrap +# the whole thing up as a single "set" statement. +# +# This will of course break if any of these variables contains a newline or +# an unmatched quote. +# + +eval "set -- $( + printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" | + xargs -n1 | + sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' | + tr '\n' ' ' + )" '"$@"' + +exec "$JAVACMD" "$@" diff --git a/gradlew.bat b/gradlew.bat new file mode 100644 index 0000000..107acd3 --- /dev/null +++ b/gradlew.bat @@ -0,0 +1,89 @@ +@rem +@rem Copyright 2015 the original author or authors. +@rem +@rem Licensed under the Apache License, Version 2.0 (the "License"); +@rem you may not use this file except in compliance with the License. +@rem You may obtain a copy of the License at +@rem +@rem https://www.apache.org/licenses/LICENSE-2.0 +@rem +@rem Unless required by applicable law or agreed to in writing, software +@rem distributed under the License is distributed on an "AS IS" BASIS, +@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +@rem See the License for the specific language governing permissions and +@rem limitations under the License. +@rem + +@if "%DEBUG%" == "" @echo off +@rem ########################################################################## +@rem +@rem Gradle startup script for Windows +@rem +@rem ########################################################################## + +@rem Set local scope for the variables with windows NT shell +if "%OS%"=="Windows_NT" setlocal + +set DIRNAME=%~dp0 +if "%DIRNAME%" == "" set DIRNAME=. +set APP_BASE_NAME=%~n0 +set APP_HOME=%DIRNAME% + +@rem Resolve any "." and ".." in APP_HOME to make it shorter. +for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi + +@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script. +set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m" + +@rem Find java.exe +if defined JAVA_HOME goto findJavaFromJavaHome + +set JAVA_EXE=java.exe +%JAVA_EXE% -version >NUL 2>&1 +if "%ERRORLEVEL%" == "0" goto execute + +echo. +echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:findJavaFromJavaHome +set JAVA_HOME=%JAVA_HOME:"=% +set JAVA_EXE=%JAVA_HOME%/bin/java.exe + +if exist "%JAVA_EXE%" goto execute + +echo. +echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% +echo. +echo Please set the JAVA_HOME variable in your environment to match the +echo location of your Java installation. + +goto fail + +:execute +@rem Setup the command line + +set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar + + +@rem Execute Gradle +"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %* + +:end +@rem End local scope for the variables with windows NT shell +if "%ERRORLEVEL%"=="0" goto mainEnd + +:fail +rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of +rem the _cmd.exe /c_ return code! +if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1 +exit /b 1 + +:mainEnd +if "%OS%"=="Windows_NT" endlocal + +:omega diff --git a/guava/build.gradle.kts b/guava/build.gradle.kts new file mode 100644 index 0000000..0b83e59 --- /dev/null +++ b/guava/build.gradle.kts @@ -0,0 +1,43 @@ +plugins { + kotlin("jvm") + `maven-publish` +} + +val guavaVersion: String by project +val guavaDepVersion: String by project +val projectGroup: String by project + +group = projectGroup +version = guavaVersion + +repositories { + mavenCentral() +} + +dependencies { + testImplementation("org.jetbrains.kotlin:kotlin-test") + + implementation("com.google.guava:guava:$guavaDepVersion-jre") +} + +tasks.test { + useJUnitPlatform() +} + +kotlin { + jvmToolchain(17) +} + +publishing { + publications { + create("mavenJava") { + from(components["java"]) + + pom { + dependencies { + implementation(kotlin("stdlib")) + } + } + } + } +} diff --git a/guava/src/main/kotlin/ru/dbotthepony/kommons/collect/GuavaCollections.kt b/guava/src/main/kotlin/ru/dbotthepony/kommons/collect/GuavaCollections.kt new file mode 100644 index 0000000..1dd6e99 --- /dev/null +++ b/guava/src/main/kotlin/ru/dbotthepony/kommons/collect/GuavaCollections.kt @@ -0,0 +1,54 @@ +package ru.dbotthepony.kommons.collect + +import com.google.common.collect.ImmutableList +import com.google.common.collect.ImmutableMap +import com.google.common.collect.ImmutableMultimap +import com.google.common.collect.ImmutableSet +import java.util.function.Consumer + +inline fun immutableList(size: Int, initializer: (index: Int) -> T): ImmutableList { + require(size >= 0) { "Invalid list size $size" } + + return when (size) { + 0 -> ImmutableList.of() + 1 -> ImmutableList.of(initializer(0)) + else -> ImmutableList.Builder().let { + for (i in 0 until size) { + it.add(initializer(i)) + } + + it.build() + } + } +} + +inline fun immutableMap(initializer: ImmutableMap.Builder.() -> Unit): ImmutableMap { + val builder = ImmutableMap.Builder() + initializer.invoke(builder) + return builder.build() +} + +inline fun immutableMultimap(initializer: ImmutableMultimap.Builder.() -> Unit): ImmutableMultimap { + val builder = ImmutableMultimap.Builder() + initializer.invoke(builder) + return builder.build() +} + +inline fun immutableSet(initializer: Consumer.() -> Unit): ImmutableSet { + val builder = ImmutableSet.Builder() + initializer.invoke(builder::add) + return builder.build() +} + +inline fun immutableList(initializer: Consumer.() -> Unit): ImmutableList { + val builder = ImmutableList.Builder() + initializer.invoke(builder::add) + return builder.build() +} + +fun immutableList(a: V, vararg values: V): ImmutableList { + val builder = ImmutableList.Builder() + builder.add(a) + builder.addAll(values.iterator()) + return builder.build() +} diff --git a/io-math/build.gradle.kts b/io-math/build.gradle.kts new file mode 100644 index 0000000..fa3b946 --- /dev/null +++ b/io-math/build.gradle.kts @@ -0,0 +1,44 @@ +plugins { + kotlin("jvm") + `maven-publish` +} + +val kommonsVersion: String by project +val projectGroup: String by project + +group = projectGroup +version = kommonsVersion + +repositories { + mavenCentral() +} + +dependencies { + testImplementation("org.jetbrains.kotlin:kotlin-test") + implementation(project(":io")) + implementation(project(":math")) +} + +tasks.test { + useJUnitPlatform() +} + +kotlin { + jvmToolchain(17) +} + +publishing { + publications { + create("mavenJava") { + from(components["java"]) + + pom { + dependencies { + implementation(kotlin("stdlib")) + implementation(project(":io")) + implementation(project(":math")) + } + } + } + } +} diff --git a/io-math/src/main/kotlin/ru/dbotthepony/kommons/io/DecimalIO.kt b/io-math/src/main/kotlin/ru/dbotthepony/kommons/io/DecimalIO.kt new file mode 100644 index 0000000..0cca8a0 --- /dev/null +++ b/io-math/src/main/kotlin/ru/dbotthepony/kommons/io/DecimalIO.kt @@ -0,0 +1,23 @@ +package ru.dbotthepony.kommons.io + +import ru.dbotthepony.kommons.math.Decimal +import java.io.DataInputStream +import java.io.DataOutputStream +import java.io.InputStream +import java.io.OutputStream + +fun InputStream.readDecimal(): Decimal { + val size = readVarInt() + require(size >= 0) { "Negative payload size: $size" } + val bytes = ByteArray(size) + read(bytes) + return Decimal.fromByteArray(bytes) +} + +fun OutputStream.writeDecimal(value: Decimal) { + val bytes = value.toByteArray() + writeVarInt(bytes.size) + write(bytes) +} + +val DecimalValueCodec = StreamCodec(DataInputStream::readDecimal, DataOutputStream::writeDecimal) diff --git a/io/build.gradle.kts b/io/build.gradle.kts new file mode 100644 index 0000000..ff3c321 --- /dev/null +++ b/io/build.gradle.kts @@ -0,0 +1,42 @@ +plugins { + kotlin("jvm") + `maven-publish` +} + +val ioVersion: String by project +val projectGroup: String by project + +group = projectGroup +version = ioVersion + +repositories { + mavenCentral() +} + +dependencies { + testImplementation("org.jetbrains.kotlin:kotlin-test") + implementation(project(":core")) +} + +tasks.test { + useJUnitPlatform() +} + +kotlin { + jvmToolchain(17) +} + +publishing { + publications { + create("mavenJava") { + from(components["java"]) + + pom { + dependencies { + implementation(kotlin("stdlib")) + implementation(project(":core")) + } + } + } + } +} diff --git a/io/src/main/kotlin/ru/dbotthepony/kommons/io/CollectionStreamCodec.kt b/io/src/main/kotlin/ru/dbotthepony/kommons/io/CollectionStreamCodec.kt new file mode 100644 index 0000000..2cca67a --- /dev/null +++ b/io/src/main/kotlin/ru/dbotthepony/kommons/io/CollectionStreamCodec.kt @@ -0,0 +1,34 @@ +package ru.dbotthepony.kommons.io + +import java.io.DataInputStream +import java.io.DataOutputStream + +class CollectionStreamCodec>(val elementCodec: IStreamCodec, val collectionFactory: (Int) -> C) : + IStreamCodec { + override fun read(stream: DataInputStream): C { + val size = stream.readVarInt() + + if (size <= 0) { + return collectionFactory.invoke(0) + } + + val collection = collectionFactory.invoke(size) + + for (i in 0 until size) { + collection.add(elementCodec.read(stream)) + } + + return collection + } + + override fun write(stream: DataOutputStream, value: C) { + stream.writeVarInt(value.size) + value.forEach { elementCodec.write(stream, it) } + } + + override fun copy(value: C): C { + val new = collectionFactory.invoke(value.size) + value.forEach { new.add(elementCodec.copy(it)) } + return new + } +} \ No newline at end of file diff --git a/io/src/main/kotlin/ru/dbotthepony/kommons/io/EnumValueCodec.kt b/io/src/main/kotlin/ru/dbotthepony/kommons/io/EnumValueCodec.kt new file mode 100644 index 0000000..eae5883 --- /dev/null +++ b/io/src/main/kotlin/ru/dbotthepony/kommons/io/EnumValueCodec.kt @@ -0,0 +1,48 @@ +package ru.dbotthepony.kommons.io + +import java.io.DataInputStream +import java.io.DataOutputStream + +class EnumValueCodec>(clazz: Class) : IStreamCodec { + val clazz = searchClass(clazz) + val values: List = listOf(*this.clazz.enumConstants!!) + val valuesMap = values.associateBy { it.name } + + override fun read(stream: DataInputStream): V { + val id = stream.readVarInt() + return values.getOrNull(id) ?: throw NoSuchElementException("No such enum with index $id") + } + + override fun write(stream: DataOutputStream, value: V) { + stream.writeVarInt(value.ordinal) + } + + override fun copy(value: V): V { + return value + } + + override fun compare(a: V, b: V): Boolean { + return a === b + } + + companion object { + /** + * FIXME: enums with abstract methods which get compiled to subclasses, whose DO NOT expose "parent's" enum constants array + * + * is there an already existing solution? + */ + fun > searchClass(clazz: Class): Class { + var search: Class<*> = clazz + + while (search.enumConstants == null && search.superclass != null) { + search = search.superclass + } + + if (search.enumConstants == null) { + throw ClassCastException("$clazz does not represent an enum or enum subclass") + } + + return search as Class + } + } +} \ No newline at end of file diff --git a/io/src/main/kotlin/ru/dbotthepony/kommons/io/IStreamCodec.kt b/io/src/main/kotlin/ru/dbotthepony/kommons/io/IStreamCodec.kt new file mode 100644 index 0000000..c1b170a --- /dev/null +++ b/io/src/main/kotlin/ru/dbotthepony/kommons/io/IStreamCodec.kt @@ -0,0 +1,28 @@ +package ru.dbotthepony.kommons.io + +import java.io.DataInputStream +import java.io.DataOutputStream + +/** + * Represents value which can be encoded onto or decoded from stream. + * + * Also provides [copy] and [compare] methods + */ +interface IStreamCodec { + fun read(stream: DataInputStream): V + fun write(stream: DataOutputStream, value: V) + + /** + * if value is immutable, return it right away + */ + fun copy(value: V): V + + /** + * Optional equality check override. Utilized to determine whenever e.g. network value is different from new value + * + * By default uses [Any.equals] + */ + fun compare(a: V, b: V): Boolean { + return a == b + } +} \ No newline at end of file diff --git a/io/src/main/kotlin/ru/dbotthepony/kommons/io/InputStreamUtils.kt b/io/src/main/kotlin/ru/dbotthepony/kommons/io/InputStreamUtils.kt new file mode 100644 index 0000000..3e6014f --- /dev/null +++ b/io/src/main/kotlin/ru/dbotthepony/kommons/io/InputStreamUtils.kt @@ -0,0 +1,151 @@ +package ru.dbotthepony.kommons.io + +import java.io.DataInput +import java.io.InputStream +import java.io.RandomAccessFile +import java.math.BigDecimal +import java.math.BigInteger +import java.util.function.IntSupplier + +fun InputStream.readBigDecimal(): BigDecimal { + val scale = readInt() + val size = readVarInt() + require(size >= 0) { "Negative payload size: $size" } + val bytes = ByteArray(size) + read(bytes) + return BigDecimal(BigInteger(bytes), scale) +} + +fun > S.readCollection(reader: S.() -> V, factory: (Int) -> C): C { + val size = readVarInt() + val collection = factory.invoke(size) + + for (i in 0 until size) { + collection.add(reader(this)) + } + + return collection +} + +fun S.readCollection(reader: S.() -> V) = readCollection(reader, ::ArrayList) + +fun InputStream.readInt(): Int { + if (this is DataInput) { + return readInt() + } + + return (read() shl 24) or (read() shl 16) or (read() shl 8) or read() +} + +fun InputStream.readLong(): Long { + if (this is DataInput) { + return readLong() + } + + return (read().toLong() shl 48) or + (read().toLong() shl 40) or + (read().toLong() shl 32) or + (read().toLong() shl 24) or + (read().toLong() shl 16) or + (read().toLong() shl 8) or + read().toLong() +} + +fun InputStream.readFloat() = Float.fromBits(readInt()) +fun InputStream.readDouble() = Double.fromBits(readLong()) + +data class VarIntReadResult(val value: Int, val cells: Int) +data class VarLongReadResult(val value: Long, val cells: Int) + +private fun readVarLongInfo(supplier: IntSupplier): VarLongReadResult { + var result = 0L + var read = supplier.asInt + var i = 1 + + while (true) { + result = (result shl 7) or (read.toLong() and 0x7F) + + if (read and 0x80 == 0) + break + + read = supplier.asInt + i++ + } + + return VarLongReadResult(result, i) +} + +private fun readVarIntInfo(supplier: IntSupplier): VarIntReadResult { + val read = readVarLongInfo(supplier) + return VarIntReadResult(read.value.toInt(), read.cells) +} + +private fun readVarInt(supplier: IntSupplier): Int { + return readVarIntInfo(supplier).value +} + +private fun readVarLong(supplier: IntSupplier): Long { + return readVarLongInfo(supplier).value +} + +private fun Int.fromSignedVar(): Int { + val sign = this and 1 + + if (sign == 0) + return this ushr 1 + else + return -(this ushr 1) - 1 +} + +private fun VarIntReadResult.fromSignedVar(): VarIntReadResult { + val sign = this.value and 1 + + if (sign == 0) + return VarIntReadResult(this.value ushr 1, this.cells) + else + return VarIntReadResult(-(this.value ushr 1) - 1, this.cells) +} + +private fun Long.fromSignedVar(): Long { + val sign = this and 1 + + if (sign == 0L) + return this ushr 1 + else + return -(this ushr 1) - 1L +} + +private fun VarLongReadResult.fromSignedVar(): VarLongReadResult { + val sign = this.value and 1 + + if (sign == 0L) + return VarLongReadResult(this.value ushr 1, this.cells) + else + return VarLongReadResult(-(this.value ushr 1) - 1, this.cells) +} + +fun RandomAccessFile.readVarLong() = readVarLong(::readUnsignedByte) +fun RandomAccessFile.readVarInt() = readVarInt(::readUnsignedByte) +fun RandomAccessFile.readVarLongInfo() = readVarLongInfo(::readUnsignedByte) +fun RandomAccessFile.readVarIntInfo() = readVarIntInfo(::readUnsignedByte) +fun InputStream.readVarLong() = readVarLong(::read) +fun InputStream.readVarInt() = readVarInt(::read) +fun InputStream.readVarLongInfo() = readVarLongInfo(::read) +fun InputStream.readVarIntInfo() = readVarIntInfo(::read) + +fun RandomAccessFile.readSignedVarLong() = readVarLong(::readUnsignedByte).fromSignedVar() +fun RandomAccessFile.readSignedVarInt() = readVarInt(::readUnsignedByte).fromSignedVar() +fun RandomAccessFile.readSignedVarLongInfo() = readVarLongInfo(::readUnsignedByte).fromSignedVar() +fun RandomAccessFile.readSignedVarIntInfo() = readVarIntInfo(::readUnsignedByte).fromSignedVar() +fun InputStream.readSignedVarLong() = readVarLong(::read).fromSignedVar() +fun InputStream.readSignedVarInt() = readVarInt(::read).fromSignedVar() +fun InputStream.readSignedVarLongInfo() = readVarLongInfo(::read).fromSignedVar() +fun InputStream.readSignedVarIntInfo() = readVarIntInfo(::read).fromSignedVar() + +fun InputStream.readBinaryString(): String { + val size = readVarInt() + require(size >= 0) { "Negative payload size: $size" } + val bytes = ByteArray(size) + read(bytes) + return bytes.decodeToString() +} diff --git a/io/src/main/kotlin/ru/dbotthepony/kommons/io/OutputStreamUtils.kt b/io/src/main/kotlin/ru/dbotthepony/kommons/io/OutputStreamUtils.kt new file mode 100644 index 0000000..47dbb27 --- /dev/null +++ b/io/src/main/kotlin/ru/dbotthepony/kommons/io/OutputStreamUtils.kt @@ -0,0 +1,105 @@ +package ru.dbotthepony.kommons.io + +import java.io.DataOutput +import java.io.OutputStream +import java.io.RandomAccessFile +import java.math.BigDecimal +import java.util.function.IntConsumer + +fun OutputStream.writeBigDecimal(value: BigDecimal) { + writeInt(value.scale()) + val bytes = value.unscaledValue().toByteArray() + writeVarInt(bytes.size) + write(bytes) +} + +fun S.writeCollection(collection: Collection, writer: S.(V) -> Unit) { + writeVarInt(collection.size) + + for (value in collection) { + writer(this, value) + } +} + +fun OutputStream.writeInt(value: Int) { + if (this is DataOutput) { + writeInt(value) + return + } + + write(value ushr 24) + write(value ushr 16) + write(value ushr 8) + write(value) +} + +fun OutputStream.writeLong(value: Long) { + if (this is DataOutput) { + writeLong(value) + return + } + + write((value ushr 48).toInt()) + write((value ushr 40).toInt()) + write((value ushr 32).toInt()) + write((value ushr 24).toInt()) + write((value ushr 16).toInt()) + write((value ushr 8).toInt()) + write(value.toInt()) +} + +fun OutputStream.writeFloat(value: Float) = writeInt(value.toBits()) +fun OutputStream.writeDouble(value: Double) = writeLong(value.toBits()) + +private fun writeVarLong(write: IntConsumer, value: Long): Int { + var value = value + var i = 0 + + do { + val toWrite = (value and 0x7F).toInt() + value = value ushr 7 + + if (value == 0L) + write.accept(toWrite) + else + write.accept(toWrite or 0x80) + + i++ + } while (value != 0L) + + return i +} + +private fun writeVarInt(write: IntConsumer, value: Int): Int { + return writeVarLong(write, value.toLong()) +} + +private fun Int.toSignedVar(): Int { + if (this >= 0) + return this shl 1 + else + return (this shl 1) or 1 +} + +private fun Long.toSignedVar(): Long { + if (this >= 0) + return this shl 1 + else + return ((-this - 1) shl 1) or 1L +} + +fun RandomAccessFile.writeVarLong(value: Long) = writeVarLong(::write, value) +fun RandomAccessFile.writeVarInt(value: Int) = writeVarInt(::write, value) +fun OutputStream.writeVarLong(value: Long) = writeVarLong(::write, value) +fun OutputStream.writeVarInt(value: Int) = writeVarInt(::write, value) + +fun RandomAccessFile.writeSignedVarLong(value: Long) = writeVarLong(::write, value.toSignedVar()) +fun RandomAccessFile.writeSignedVarInt(value: Int) = writeVarInt(::write, value.toSignedVar()) +fun OutputStream.writeSignedVarLong(value: Long) = writeVarLong(::write, value.toSignedVar()) +fun OutputStream.writeSignedVarInt(value: Int) = writeVarInt(::write, value.toSignedVar()) + +fun OutputStream.writeBinaryString(input: String) { + val bytes = input.encodeToByteArray() + writeVarInt(bytes.size) + write(bytes) +} diff --git a/io/src/main/kotlin/ru/dbotthepony/kommons/io/StreamCodecs.kt b/io/src/main/kotlin/ru/dbotthepony/kommons/io/StreamCodecs.kt new file mode 100644 index 0000000..7f56857 --- /dev/null +++ b/io/src/main/kotlin/ru/dbotthepony/kommons/io/StreamCodecs.kt @@ -0,0 +1,77 @@ +package ru.dbotthepony.kommons.io + +import java.io.DataInputStream +import java.io.DataOutputStream +import java.util.* +import kotlin.reflect.KClass + +class StreamCodec( + private val reader: (stream: DataInputStream) -> V, + private val writer: (stream: DataOutputStream, value: V) -> Unit, + private val copier: ((value: V) -> V) = { it }, + private val comparator: ((a: V, b: V) -> Boolean) = { a, b -> a == b } +) : IStreamCodec { + constructor( + reader: (stream: DataInputStream) -> V, + payloadSize: Long, + writer: (stream: DataOutputStream, value: V) -> Unit, + copier: ((value: V) -> V) = { it }, + comparator: ((a: V, b: V) -> Boolean) = { a, b -> a == b } + ) : this({ stream -> reader.invoke(stream) }, writer, copier, comparator) + + val nullable = object : IStreamCodec { + override fun read(stream: DataInputStream): V? { + return if (stream.read() == 0) null else reader.invoke(stream) + } + + override fun write(stream: DataOutputStream, value: V?) { + if (value === null) stream.write(0) else { + stream.write(1) + writer.invoke(stream, value) + } + } + + override fun copy(value: V?): V? { + return if (value === null) null else copier.invoke(value) + } + + override fun compare(a: V?, b: V?): Boolean { + if (a === null && b === null) return true + if (a === null || b === null) return false + return comparator.invoke(a, b) + } + } + + override fun read(stream: DataInputStream): V { + return reader.invoke(stream) + } + + override fun write(stream: DataOutputStream, value: V) { + writer.invoke(stream, value) + } + + override fun copy(value: V): V { + return copier.invoke(value) + } + + override fun compare(a: V, b: V): Boolean { + return comparator.invoke(a, b) + } +} + +val NullValueCodec = StreamCodec({ _ -> null }, { _, _ -> }) +val BooleanValueCodec = StreamCodec(DataInputStream::readBoolean, 1L, DataOutputStream::writeBoolean) { a, b -> a == b } +val ByteValueCodec = StreamCodec(DataInputStream::readByte, 1L, { s, v -> s.writeByte(v.toInt()) }) { a, b -> a == b } +val ShortValueCodec = StreamCodec(DataInputStream::readShort, 2L, { s, v -> s.writeShort(v.toInt()) }) { a, b -> a == b } +val IntValueCodec = StreamCodec(DataInputStream::readInt, 4L, DataOutputStream::writeInt) { a, b -> a == b } +val LongValueCodec = StreamCodec(DataInputStream::readLong, 8L, DataOutputStream::writeLong) { a, b -> a == b } +val FloatValueCodec = StreamCodec(DataInputStream::readFloat, 4L, DataOutputStream::writeFloat) { a, b -> a == b } +val DoubleValueCodec = StreamCodec(DataInputStream::readDouble, 8L, DataOutputStream::writeDouble) { a, b -> a == b } +val BigDecimalValueCodec = StreamCodec(DataInputStream::readBigDecimal, DataOutputStream::writeBigDecimal) +val UUIDValueCodec = StreamCodec({ s -> UUID(s.readLong(), s.readLong()) }, { s, v -> s.writeLong(v.mostSignificantBits); s.writeLong(v.leastSignificantBits) }) +val VarIntValueCodec = StreamCodec(DataInputStream::readSignedVarInt, DataOutputStream::writeSignedVarInt) { a, b -> a == b } +val VarLongValueCodec = StreamCodec(DataInputStream::readSignedVarLong, DataOutputStream::writeSignedVarLong) { a, b -> a == b } +val BinaryStringCodec = StreamCodec(DataInputStream::readBinaryString, DataOutputStream::writeBinaryString) + +fun > Class.codec() = EnumValueCodec(this) +fun > KClass.codec() = EnumValueCodec(this.java) diff --git a/math/build.gradle.kts b/math/build.gradle.kts new file mode 100644 index 0000000..2d363f8 --- /dev/null +++ b/math/build.gradle.kts @@ -0,0 +1,40 @@ +plugins { + kotlin("jvm") + `maven-publish` +} + +val mathVersion: String by project +val projectGroup: String by project + +group = projectGroup +version = mathVersion + +repositories { + mavenCentral() +} + +dependencies { + testImplementation("org.jetbrains.kotlin:kotlin-test") +} + +tasks.test { + useJUnitPlatform() +} + +kotlin { + jvmToolchain(17) +} + +publishing { + publications { + create("mavenJava") { + from(components["java"]) + + pom { + dependencies { + implementation(kotlin("stdlib")) + } + } + } + } +} diff --git a/math/src/main/kotlin/ru/dbotthepony/kommons/math/Decimal.kt b/math/src/main/kotlin/ru/dbotthepony/kommons/math/Decimal.kt new file mode 100644 index 0000000..bcad465 --- /dev/null +++ b/math/src/main/kotlin/ru/dbotthepony/kommons/math/Decimal.kt @@ -0,0 +1,1553 @@ +package ru.dbotthepony.kommons.math + +import java.math.BigDecimal +import java.math.BigInteger +import java.math.MathContext +import java.math.RoundingMode + +private val BI_MINUS_ONE = -BigInteger.ONE +private val PERCENTAGE_CONTEXT = MathContext(6) // 6 ибо это число знаков для вычисления процента + +fun Decimal(value: Byte) = Decimal.valueOf(value) +fun Decimal(value: Short) = Decimal.valueOf(value) +fun Decimal(value: Int) = Decimal.valueOf(value) +fun Decimal(value: Long) = Decimal.valueOf(value) +fun Decimal(value: Float) = Decimal.valueOf(value) +fun Decimal(value: Double) = Decimal.valueOf(value) +fun Decimal(value: BigDecimal) = Decimal.valueOf(value) +fun Decimal(value: BigInteger) = Decimal.valueOf(value) +fun Decimal(value: String) = Decimal.valueOf(value) + +inline val BigInteger.isZero get() = this.signum() == 0 +inline val BigInteger.isPositive get() = this.signum() > 0 +inline val BigInteger.isNegative get() = this.signum() < 0 + +inline val BigDecimal.isZero get() = this.signum() == 0 +inline val BigDecimal.isPositive get() = this.signum() > 0 +inline val BigDecimal.isNegative get() = this.signum() < 0 + +val BI_INT_MAX: BigInteger = BigInteger.valueOf(Int.MAX_VALUE.toLong()) +val BI_INT_MIN: BigInteger = BigInteger.valueOf(Int.MIN_VALUE.toLong()) +val BI_LONG_MAX: BigInteger = BigInteger.valueOf(Long.MAX_VALUE) +val BI_LONG_MIN: BigInteger = BigInteger.valueOf(Long.MIN_VALUE) + +val BI_FLOAT_MAX: BigInteger = BigDecimal(Float.MAX_VALUE.toString()).toBigInteger() +val BI_FLOAT_MIN: BigInteger = BigDecimal(Float.MIN_VALUE.toString()).toBigInteger() +val BI_DOUBLE_MAX: BigInteger = BigDecimal(Double.MAX_VALUE.toString()).toBigInteger() +val BI_DOUBLE_MIN: BigInteger = BigDecimal(Double.MIN_VALUE.toString()).toBigInteger() + +/** + * Fixed point arbitrary precision Decimal value. Values of this class embed [BigInteger] unscaled value, scale + * is defined at compile time by [PRECISION]. + */ +sealed class Decimal : Number(), Comparable { + /** + * Whole part of this Decimal + */ + abstract val whole: BigInteger + + /** + * Arbitrary fractional part of this Decimal, as [BigInteger] + * + * Makes sense only when utilized along [PRECISION], [PRECISION_POW], [PRECISION_POW_BI] + */ + abstract val fractional: BigInteger + + /** + * *Signed* normalized (-1,1) fractional part of this Decimal, as [Float] + */ + inline val fractionalFloat: Float get() { + return fractional.toFloat() / PRECISION_FLOAT + } + + /** + * *Signed* normalized (-1,1) fractional part of this Decimal, as [Double] + */ + inline val fractionalDouble: Double get() { + return fractional.toDouble() / PRECISION_DOUBLE + } + + abstract operator fun plus(other: Decimal): Decimal + abstract operator fun minus(other: Decimal): Decimal + abstract operator fun times(other: Decimal): Decimal + abstract operator fun div(other: Decimal): Decimal + + abstract operator fun rem(other: Decimal): Decimal + + // Primitive operators + abstract operator fun plus(other: Float): Decimal + abstract operator fun minus(other: Float): Decimal + abstract operator fun times(other: Float): Decimal + abstract operator fun div(other: Float): Decimal + + abstract operator fun plus(other: Double): Decimal + abstract operator fun minus(other: Double): Decimal + abstract operator fun times(other: Double): Decimal + abstract operator fun div(other: Double): Decimal + + abstract operator fun plus(other: Int): Decimal + abstract operator fun minus(other: Int): Decimal + abstract operator fun times(other: Int): Decimal + abstract operator fun div(other: Int): Decimal + + abstract operator fun plus(other: Long): Decimal + abstract operator fun minus(other: Long): Decimal + abstract operator fun times(other: Long): Decimal + abstract operator fun div(other: Long): Decimal + + abstract operator fun plus(other: BigInteger): Decimal + abstract operator fun minus(other: BigInteger): Decimal + abstract operator fun times(other: BigInteger): Decimal + abstract operator fun div(other: BigInteger): Decimal + // /Primitive operators + + // "de-virtualize" generic method + abstract override fun compareTo(other: Decimal): Int + + abstract operator fun unaryMinus(): Decimal + operator fun unaryPlus() = this + + /** + * Sign number of this Decimal, as defined by [BigInteger.signum] + */ + abstract fun signum(): Int + + /** + * Whenever this Decimal is negative (less than zero) + */ + inline val isNegative get() = signum() < 0 + + /** + * Whenever this Decimal is positive (bigger than zero) + */ + inline val isPositive get() = signum() > 0 + + /** + * Whenever this Decimal is zero + */ + inline val isZero get() = signum() == 0 + + abstract val isInfinite: Boolean + abstract val isFinite: Boolean + + /** + * Alias for [coerceAtLeast] with [ZERO] constant, except this method might + * perform faster. + */ + fun moreThanZero(): Decimal { + if (signum() >= 0) + return this + + return Zero + } + + /** + * Alias for [coerceAtMost] with [ZERO] constant, except this method might + * perform faster. + */ + fun lessOrZero(): Decimal { + if (signum() <= 0) + return this + + return Zero + } + + abstract fun toByteArray(): ByteArray + + val absoluteValue: Decimal + get() { + return if (isNegative) { + -this + } else { + this + } + } + + /** + * Truncates fractional part of this Decimal + */ + abstract fun floor(): Decimal + + abstract fun toString(decimals: Int): String + override fun toString(): String = toString(-1) + + abstract fun toBigDecmial(): BigDecimal + + fun percentage(divisor: Decimal): Float { + if (isZero || divisor.isZero) return 0f + + if (this >= divisor) + return 1f + else if (this <= FLOAT_MAX_VALUE && divisor <= FLOAT_MAX_VALUE) + return (toDouble() / divisor.toDouble()).toFloat() + else if (divisor === PositiveInfinity || divisor === NegativeInfinity) + return 0f + + return toBigDecmial().divide(divisor.toBigDecmial(), PERCENTAGE_CONTEXT).toFloat() + } + + private class Regular(val mag: BigInteger, marker: Nothing?) : Decimal() { + constructor(value: BigInteger) : this(value * PRECISION_POW_BI, null) + constructor(value: BigDecimal) : this(value.setScale(PRECISION, RoundingMode.HALF_UP).unscaledValue(), null) + constructor(value: Float) : this(BigDecimal.valueOf(value.toDouble())) + constructor(value: Double) : this(BigDecimal(value)) + constructor(value: String) : this(BigDecimal(value)) + + override val isInfinite: Boolean + get() = false + override val isFinite: Boolean + get() = true + + private var _whole: BigInteger? = null + private var _fractional: BigInteger? = null + + private fun computeWholeFractional(): BigInteger { + val (a, b) = mag.divideAndRemainder(PRECISION_POW_BI) + _whole = a + _fractional = b + return a + } + + override val whole: BigInteger get() { + return _whole ?: computeWholeFractional() + } + + override val fractional: BigInteger get() { + if (_fractional == null) computeWholeFractional() + return _fractional!! + } + + override fun toDouble(): Double { + return mag.toDouble() / PRECISION_DOUBLE + } + + override fun toFloat(): Float { + return mag.toFloat() / PRECISION_FLOAT + } + + override fun toByte(): Byte { + return whole.toByte() + } + + override fun toShort(): Short { + return whole.toShort() + } + + override fun signum(): Int { + return mag.signum() + } + + override fun toInt(): Int { + return if (whole > BI_INT_MAX) { + Int.MAX_VALUE + } else if (whole < BI_INT_MIN) { + Int.MIN_VALUE + } else { + whole.toInt() + } + } + + override fun toLong(): Long { + return if (whole > BI_LONG_MAX) { + Long.MAX_VALUE + } else if (whole < BI_LONG_MIN) { + Long.MIN_VALUE + } else { + whole.toLong() + } + } + + override fun compareTo(other: Decimal): Int { + return if (other === Zero) + signum() + else if (other is Regular) + mag.compareTo(other.mag) + else if (other === PositiveInfinity) + -1 + else if (other === NegativeInfinity) + 1 + else + throw RuntimeException("unreachable code") + } + + + override fun plus(other: Decimal): Decimal { + return if (other is Regular) { + raw(mag + other.mag) + } else if (other === Zero) { + this + } else if (other === PositiveInfinity) { + PositiveInfinity + } else if (other === NegativeInfinity) { + NegativeInfinity + } else { + throw RuntimeException("Unreachable code") + } + } + + override fun minus(other: Decimal): Decimal { + return if (other is Regular) { + raw(mag - other.mag) + } else if (other === Zero) { + this + } else if (other === PositiveInfinity) { + NegativeInfinity + } else if (other === NegativeInfinity) { + PositiveInfinity + } else { + throw RuntimeException("Unreachable code") + } + } + + override fun times(other: Decimal): Decimal { + if (other is Regular) { + if (other == ONE) { + return this + } else if (other == MINUS_ONE) { + return raw(-mag) + } + + val result = mag * other.mag + val (a, b) = result.divideAndRemainder(PRECISION_POW_BI) + + return if (b >= PRECISION_POW_BI_HIGH) { + raw(a + BigInteger.ONE) + } else { + raw(a) + } + } else if (other === Zero) { + return Zero + } else if (other === PositiveInfinity) { + return PositiveInfinity + } else if (other === NegativeInfinity) { + return NegativeInfinity + } else { + throw RuntimeException("Unreachable code") + } + } + + override fun div(other: Decimal): Decimal { + if (other is Regular) { + if (other == ONE) { + return this + } else if (other == MINUS_ONE) { + return raw(-mag) + } + + return raw((mag * PRECISION_POW_BI) / other.mag) + } else if (other === Zero) { + throw ArithmeticException("$this / 0") + } else if (other === PositiveInfinity || other === NegativeInfinity) { + return Zero + } else { + throw RuntimeException("Unreachable code") + } + } + + override fun rem(other: Decimal): Decimal { + return if (other is Regular) { + raw(mag % other.mag) + } else if (other === Zero) { + throw ArithmeticException("$this % 0") + } else if (other === PositiveInfinity) { + this + } else if (other === NegativeInfinity) { + -this + } else { + throw RuntimeException("Unreachable code") + } + } + + // Primitive operators + override fun plus(other: Float): Decimal { + if (other == 0f) { + return this + } else if (other.isNaN()) { + throw ArithmeticException("$this + NaN") + } else if (other == Float.POSITIVE_INFINITY) { + return PositiveInfinity + } else if (other == Float.NEGATIVE_INFINITY) { + return NegativeInfinity + } + + return plus(valueOf(other)) + } + + override fun minus(other: Float): Decimal { + if (other == 0f) { + return this + } else if (other.isNaN()) { + throw ArithmeticException("$this - NaN") + } else if (other == Float.POSITIVE_INFINITY) { + return NegativeInfinity + } else if (other == Float.NEGATIVE_INFINITY) { + return PositiveInfinity + } + + return minus(valueOf(other)) + } + + override fun times(other: Float): Decimal { + if (other == 1f) { + return this + } else if (other == 0f) { + return Zero + } else if (other == -1f) { + return -this + } else if (other.isNaN()) { + throw ArithmeticException("$this * NaN") + } else if (other == Float.POSITIVE_INFINITY) { + return if (signum() < 0) NegativeInfinity else PositiveInfinity + } else if (other == Float.NEGATIVE_INFINITY) { + return if (signum() < 0) PositiveInfinity else NegativeInfinity + } + + return times(valueOf(other)) + } + + override fun div(other: Float): Decimal { + if (other == 0f) { + throw ArithmeticException("$this / 0") + } else if (other == 1f) { + return this + } else if (other == -1f) { + return -this + } else if (other.isNaN()) { + throw ArithmeticException("$this / NaN") + } else if (other.isInfinite()) { + return Zero + } + + return div(valueOf(other)) + } + + override fun plus(other: Double): Decimal { + if (other == 0.0) { + return this + } else if (other.isNaN()) { + throw ArithmeticException("$this + NaN") + } else if (other == Double.POSITIVE_INFINITY) { + return PositiveInfinity + } else if (other == Double.NEGATIVE_INFINITY) { + return NegativeInfinity + } + + return plus(valueOf(other)) + } + + override fun minus(other: Double): Decimal { + if (other == 0.0) { + return this + } else if (other.isNaN()) { + throw ArithmeticException("$this - NaN") + } else if (other == Double.POSITIVE_INFINITY) { + return NegativeInfinity + } else if (other == Double.NEGATIVE_INFINITY) { + return PositiveInfinity + } + + return minus(valueOf(other)) + } + + override fun times(other: Double): Decimal { + if (other == 1.0) { + return this + } else if (other == 0.0) { + return Zero + } else if (other == -1.0) { + return -this + } else if (other.isNaN()) { + throw ArithmeticException("$this * NaN") + } else if (other == Double.POSITIVE_INFINITY) { + return if (signum() < 0) NegativeInfinity else PositiveInfinity + } else if (other == Double.NEGATIVE_INFINITY) { + return if (signum() < 0) PositiveInfinity else NegativeInfinity + } + + return times(valueOf(other)) + } + + override fun div(other: Double): Decimal { + if (other == 0.0) { + throw ArithmeticException("$this / zero") + } else if (other == 1.0) { + return this + } else if (other == -1.0) { + return -this + } else if (other.isNaN()) { + throw ArithmeticException("$this / NaN") + } else if (other.isInfinite()) { + return Zero + } + + return div(valueOf(other)) + } + + override fun plus(other: Int): Decimal { + if (other == 0) + return this + + return plus(valueOf(other)) + } + + override fun minus(other: Int): Decimal { + if (other == 0) + return this + + return minus(valueOf(other)) + } + + override fun times(other: Int): Decimal { + if (other == 1) { + return this + } else if (other == 0) { + return Zero + } else if (other == -1) { + return -this + } + + return times(valueOf(other)) + } + + override fun div(other: Int): Decimal { + if (other == 0) { + throw ArithmeticException("$this / 0") + } else if (other == 1) { + return this + } else if (other == -1) { + return -this + } + + return div(valueOf(other)) + } + + override fun plus(other: Long): Decimal { + if (other == 0L) + return this + + return plus(valueOf(other)) + } + + override fun minus(other: Long): Decimal { + if (other == 0L) + return this + + return minus(valueOf(other)) + } + + override fun times(other: Long): Decimal { + if (other == 1L) { + return this + } else if (other == 0L) { + return Zero + } else if (other == -1L) { + return -this + } + + return times(valueOf(other)) + } + + override fun div(other: Long): Decimal { + if (other == 0L) { + throw ArithmeticException("$this / 0") + } else if (other == 1L || isZero) { + return this + } else if (other == -1L) { + return -this + } + + return div(valueOf(other)) + } + + override fun plus(other: BigInteger): Decimal { + if (other == BigInteger.ZERO) + return this + + return plus(valueOf(other)) + } + + override fun minus(other: BigInteger): Decimal { + if (other == BigInteger.ZERO) + return this + + return minus(valueOf(other)) + } + + override fun times(other: BigInteger): Decimal { + if (other == BigInteger.ONE) { + return this + } else if (other.signum() == 0) { + return Zero + } else if (other == BI_MINUS_ONE) { + return -this + } + + return times(valueOf(other)) + } + + override fun div(other: BigInteger): Decimal { + if (other == BigInteger.ZERO) { + throw ArithmeticException("$this / 0") + } else if (other == BigInteger.ONE) { + return this + } else if (other == BI_MINUS_ONE) { + return -this + } + + return div(valueOf(other)) + } + // /Primitive operators + + override fun unaryMinus(): Decimal { + return Regular(-mag, null) + } + + override fun toByteArray(): ByteArray { + val result = mag.toByteArray() + val copy = ByteArray(result.size + 1) + copy[0] = TYPE_NORMAL + result.copyInto(copy, 1) + return copy + } + + override fun floor(): Decimal { + return Regular(whole) + } + + override fun toString(decimals: Int): String { + if (decimals == 0) { + return whole.toString() + } + + if (mag.signum() == 0) { + return if (decimals < 0) { + "0.0" + } else { + "0." + "0".repeat(decimals) + } + } + + var original = mag.toString() + + if (mag.signum() < 0) { + // если у нас отрицательное число - убираем знак минуса + original = original.substring(1) + } + + if (original.length <= PRECISION) { + // если у нас чисто дробное число - дописываем нули в начало + original = "0".repeat(PRECISION - original.length + 1) + original + } + + // теперь у нас беззнаковая строка с нужной длиной + + if (decimals < 0) { + // нам неважно количество знаков после запятой + var result = original.substring(0, original.length - PRECISION) + "." + original.substring(original.length - PRECISION) + + if (mag.signum() < 0) { + result = "-$result" + } + + var pos = result.length - 1 + + while (result[pos] == '0') { + if (result[pos - 1] == '0' || result[pos - 1] != '.') + pos-- + else + break + } + + return result.substring(0, pos + 1) + } else { + // нужно некоторое количество знаков после запятой + val result = original.substring(0, original.length - PRECISION) + "." + var decimalPart = original.substring(original.length - PRECISION) + + if (decimalPart.length < decimals) { + decimalPart += "0".repeat(decimals - decimalPart.length) + } else if (decimalPart.length > decimals) { + decimalPart = decimalPart.substring(0, decimals) + } + + return if (mag.signum() < 0) { + "-$result$decimalPart" + } else { + "$result$decimalPart" + } + } + } + + override fun toBigDecmial(): BigDecimal { + return BigDecimal(mag, PRECISION) + } + + override fun equals(other: Any?): Boolean { + return this === other || other is Regular && mag == other.mag + } + + override fun hashCode(): Int { + return mag.hashCode() + } + } + + private object PositiveInfinity : Decimal() { + private fun readResolve(): Any = PositiveInfinity + + override val isInfinite: Boolean + get() = true + override val isFinite: Boolean + get() = false + + override fun compareTo(other: Decimal): Int { + return if (other === this) 0 else 1 + } + + override fun toByte(): Byte { + return Byte.MAX_VALUE + } + + override fun toDouble(): Double { + return Double.POSITIVE_INFINITY + } + + override fun toFloat(): Float { + return Float.POSITIVE_INFINITY + } + + override fun toInt(): Int { + return Int.MAX_VALUE + } + + override fun toLong(): Long { + return Long.MAX_VALUE + } + + override fun toShort(): Short { + return Short.MAX_VALUE + } + + override val whole: BigInteger + get() = throw UnsupportedOperationException("Attempt to get whole part of positive infinity") + override val fractional: BigInteger + get() = throw UnsupportedOperationException("Attempt to get fractional part of positive infinity") + + override fun plus(other: Decimal): Decimal { + // not very mathematically correct, since + // case "infinity + infinity" with either sign on either side + // is undefined + return this + } + + override fun minus(other: Decimal): Decimal { + // not very mathematically correct, since + // case "infinity - infinity" with either sign on either side + // is undefined + return this + } + + override fun times(other: Decimal): Decimal { + return if (other.signum() == 0) + Zero + else if (other.signum() < 0) + NegativeInfinity + else + this + } + + override fun div(other: Decimal): Decimal { + return if (other.signum() == 0) + throw ArithmeticException("Attempt to divide positive infinity by zero") + else if (other === this) + throw ArithmeticException("Dividing positive infinity by itself is undefined") + else if (other === NegativeInfinity) + throw ArithmeticException("Dividing positive infinity by negative infinity is undefined") + else if (other.signum() < 0) + NegativeInfinity + else + this + } + + override fun rem(other: Decimal): Decimal { + return if (other.signum() == 0) + throw ArithmeticException("Attempt to remainder divide positive infinity by zero") + else if (other.signum() < 0) + NegativeInfinity + else + this + } + + override fun plus(other: Float): Decimal { + return this + } + + override fun minus(other: Float): Decimal { + return this + } + + override fun times(other: Float): Decimal { + return if (other == 0f) + Zero + else if (other < 0f) + NegativeInfinity + else + PositiveInfinity + } + + override fun div(other: Float): Decimal { + return if (other == 0f) + throw ArithmeticException("Attempt to divide positive infinity by zero") + else if (other < 0f) + NegativeInfinity + else + PositiveInfinity + } + + override fun plus(other: Double): Decimal { + return this + } + + override fun minus(other: Double): Decimal { + return this + } + + override fun times(other: Double): Decimal { + return if (other == 0.0) + Zero + else if (other < 0.0) + NegativeInfinity + else + PositiveInfinity + } + + override fun div(other: Double): Decimal { + return if (other == 0.0) + throw ArithmeticException("Attempt to divide positive infinity by zero") + else if (other < 0.0) + NegativeInfinity + else + PositiveInfinity + } + + override fun plus(other: Int): Decimal { + return this + } + + override fun minus(other: Int): Decimal { + return this + } + + override fun times(other: Int): Decimal { + return if (other == 0) + Zero + else if (other < 0) + NegativeInfinity + else + PositiveInfinity + } + + override fun div(other: Int): Decimal { + return if (other == 0) + throw ArithmeticException("Attempt to divide positive infinity by zero") + else if (other < 0) + NegativeInfinity + else + PositiveInfinity + } + + override fun plus(other: Long): Decimal { + return this + } + + override fun minus(other: Long): Decimal { + return this + } + + override fun times(other: Long): Decimal { + return if (other == 0L) + Zero + else if (other < 0L) + NegativeInfinity + else + PositiveInfinity + } + + override fun div(other: Long): Decimal { + return if (other == 0L) + throw ArithmeticException("Attempt to divide positive infinity by zero") + else if (other < 0L) + NegativeInfinity + else + PositiveInfinity + } + + override fun plus(other: BigInteger): Decimal { + return this + } + + override fun minus(other: BigInteger): Decimal { + return this + } + + override fun times(other: BigInteger): Decimal { + return if (other.signum() == 0) + Zero + else if (other.signum() < 0) + NegativeInfinity + else + PositiveInfinity + } + + override fun div(other: BigInteger): Decimal { + return if (other.signum() == 0) + throw ArithmeticException("Attempt to divide positive infinity by zero") + else if (other.signum() < 0) + NegativeInfinity + else + PositiveInfinity + } + + override fun unaryMinus(): Decimal { + return NegativeInfinity + } + + override fun signum(): Int { + return 1 + } + + override fun toByteArray(): ByteArray { + return byteArrayOf(TYPE_POSITIVE_INFINITY) + } + + override fun floor(): Decimal { + return this + } + + override fun toString(decimals: Int): String { + return "+Infinity" + } + + override fun toBigDecmial(): BigDecimal { + throw UnsupportedOperationException("Unable to construct BigDecimal of positive infinity") + } + } + + private object NegativeInfinity : Decimal() { + private fun readResolve(): Any = NegativeInfinity + + override val isInfinite: Boolean + get() = true + override val isFinite: Boolean + get() = false + + override fun compareTo(other: Decimal): Int { + return if (other === this) 0 else -1 + } + + override fun toByte(): Byte { + return Byte.MIN_VALUE + } + + override fun toDouble(): Double { + return Double.NEGATIVE_INFINITY + } + + override fun toFloat(): Float { + return Float.NEGATIVE_INFINITY + } + + override fun toInt(): Int { + return Int.MIN_VALUE + } + + override fun toLong(): Long { + return Long.MIN_VALUE + } + + override fun toShort(): Short { + return Short.MIN_VALUE + } + + override val whole: BigInteger + get() = throw UnsupportedOperationException("Attempt to get whole part of negative infinity") + override val fractional: BigInteger + get() = throw UnsupportedOperationException("Attempt to get fractional part of negative infinity") + + override fun plus(other: Decimal): Decimal { + return this + } + + override fun minus(other: Decimal): Decimal { + return this + } + + override fun times(other: Decimal): Decimal { + return if (other.signum() == 0) + Zero + else if (other.signum() < 0) + PositiveInfinity + else + this + } + + override fun div(other: Decimal): Decimal { + return if (other.signum() == 0) + throw ArithmeticException("Attempt to divide negative infinity by zero") + else if (other === this) + throw ArithmeticException("Dividing negative infinity by itself is undefined") + else if (other === PositiveInfinity) + throw ArithmeticException("Dividing negative infinity by positive infinity is undefined") + else if (other.signum() < 0) + PositiveInfinity + else + this + } + + override fun rem(other: Decimal): Decimal { + return if (other.signum() == 0) + throw ArithmeticException("Attempt to remainder divide negative infinity by zero") + else if (other.signum() < 0) + PositiveInfinity + else + this + } + + override fun plus(other: Float): Decimal { + return this + } + + override fun minus(other: Float): Decimal { + return this + } + + override fun times(other: Float): Decimal { + return if (other == 0f) + Zero + else if (other < 0f) + PositiveInfinity + else + this + } + + override fun div(other: Float): Decimal { + return if (other == 0f) + throw ArithmeticException("Attempt to divide negative negative by zero") + else if (other < 0f) + PositiveInfinity + else + this + } + + override fun plus(other: Double): Decimal { + return this + } + + override fun minus(other: Double): Decimal { + return this + } + + override fun times(other: Double): Decimal { + return if (other == 0.0) + Zero + else if (other < 0.0) + PositiveInfinity + else + this + } + + override fun div(other: Double): Decimal { + return if (other == 0.0) + throw ArithmeticException("Attempt to divide negative infinity by zero") + else if (other < 0.0) + PositiveInfinity + else + this + } + + override fun plus(other: Int): Decimal { + return this + } + + override fun minus(other: Int): Decimal { + return this + } + + override fun times(other: Int): Decimal { + return if (other == 0) + Zero + else if (other < 0) + PositiveInfinity + else + this + } + + override fun div(other: Int): Decimal { + return if (other == 0) + throw ArithmeticException("Attempt to divide negative infinity by zero") + else if (other < 0) + PositiveInfinity + else + this + } + + override fun plus(other: Long): Decimal { + return this + } + + override fun minus(other: Long): Decimal { + return this + } + + override fun times(other: Long): Decimal { + return if (other == 0L) + Zero + else if (other < 0L) + PositiveInfinity + else + this + } + + override fun div(other: Long): Decimal { + return if (other == 0L) + throw ArithmeticException("Attempt to divide negative infinity by zero") + else if (other < 0L) + PositiveInfinity + else + this + } + + override fun plus(other: BigInteger): Decimal { + return this + } + + override fun minus(other: BigInteger): Decimal { + return this + } + + override fun times(other: BigInteger): Decimal { + return if (other.signum() == 0) + Zero + else if (other.signum() < 0) + PositiveInfinity + else + this + } + + override fun div(other: BigInteger): Decimal { + return if (other.signum() == 0) + throw ArithmeticException("Attempt to divide negative infinity by zero") + else if (other.signum() < 0) + PositiveInfinity + else + this + } + + override fun unaryMinus(): Decimal { + return PositiveInfinity + } + + override fun signum(): Int { + return -1 + } + + override fun toByteArray(): ByteArray { + return byteArrayOf(TYPE_NEGATIVE_INFINITY) + } + + override fun floor(): Decimal { + return this + } + + override fun toString(decimals: Int): String { + return "-Infinity" + } + + override fun toBigDecmial(): BigDecimal { + throw UnsupportedOperationException("Unable to construct BigDecimal of negative infinity") + } + } + + private object Zero : Decimal() { + private fun readResolve(): Any = Zero + + override val isInfinite: Boolean + get() = false + override val isFinite: Boolean + get() = true + + override fun compareTo(other: Decimal): Int { + return -other.signum() + } + + override fun toByte(): Byte { + return 0 + } + + override fun toDouble(): Double { + return 0.0 + } + + override fun toFloat(): Float { + return 0f + } + + override fun toInt(): Int { + return 0 + } + + override fun toLong(): Long { + return 0L + } + + override fun toShort(): Short { + return 0 + } + + override val whole: BigInteger + get() = BigInteger.ZERO + override val fractional: BigInteger + get() = BigInteger.ZERO + + override fun plus(other: Decimal): Decimal { + return other + } + + override fun minus(other: Decimal): Decimal { + return -other + } + + override fun times(other: Decimal): Decimal { + return this + } + + override fun div(other: Decimal): Decimal { + if (other === this) + throw ArithmeticException("0 / 0") + else + return this + } + + override fun rem(other: Decimal): Decimal { + if (other === this) + throw ArithmeticException("0 % 0") + else + return this + } + + override fun plus(other: Float): Decimal { + return valueOf(other) + } + + override fun minus(other: Float): Decimal { + return valueOf(-other) + } + + override fun times(other: Float): Decimal { + return this + } + + override fun div(other: Float): Decimal { + if (other == 0f) + throw ArithmeticException("0 / 0") + + return this + } + + override fun plus(other: Double): Decimal { + return valueOf(other) + } + + override fun minus(other: Double): Decimal { + return valueOf(-other) + } + + override fun times(other: Double): Decimal { + return this + } + + override fun div(other: Double): Decimal { + if (other == 0.0) + throw ArithmeticException("0 / 0") + + return this + } + + override fun plus(other: Int): Decimal { + return valueOf(other) + } + + override fun minus(other: Int): Decimal { + return valueOf(-other) + } + + override fun times(other: Int): Decimal { + return this + } + + override fun div(other: Int): Decimal { + if (other == 0) + throw ArithmeticException("0 / 0") + + return this + } + + override fun plus(other: Long): Decimal { + return valueOf(other) + } + + override fun minus(other: Long): Decimal { + return valueOf(-other) + } + + override fun times(other: Long): Decimal { + return this + } + + override fun div(other: Long): Decimal { + if (other == 0L) + throw ArithmeticException("0 / 0") + + return this + } + + override fun plus(other: BigInteger): Decimal { + return valueOf(other) + } + + override fun minus(other: BigInteger): Decimal { + return valueOf(-other) + } + + override fun times(other: BigInteger): Decimal { + return this + } + + override fun div(other: BigInteger): Decimal { + if (other == BigInteger.ZERO) + throw ArithmeticException("0 / 0") + + return this + } + + override fun unaryMinus(): Decimal { + return this + } + + override fun signum(): Int { + return 0 + } + + override fun toByteArray(): ByteArray { + return byteArrayOf(TYPE_ZERO) + } + + override fun floor(): Decimal { + return this + } + + override fun toString(decimals: Int): String { + if (decimals == 0) + return "0" + else if (decimals < 0) + return "0.0" + else + return "0." + "0".repeat(decimals) + } + + override fun toBigDecmial(): BigDecimal { + return BigDecimal.ZERO + } + } + + @Suppress("unused") + companion object { + /** + * Amount of digits after fixed point, in 10 radix + */ + const val PRECISION = 11 + + const val TYPE_ZERO: Byte = 0 + const val TYPE_NORMAL: Byte = 1 + const val TYPE_POSITIVE_INFINITY: Byte = 2 + const val TYPE_NEGATIVE_INFINITY: Byte = 3 + + @JvmField + val PRECISION_POW_BI: BigInteger = BigInteger("1" + "0".repeat(PRECISION)) + @JvmField + val PRECISION_DOUBLE = PRECISION_POW_BI.toDouble() + @JvmField + val PRECISION_FLOAT = PRECISION_POW_BI.toFloat() + @JvmField + val PRECISION_POW_BI_NEGATIVE: BigInteger = -PRECISION_POW_BI + @JvmField + val PRECISION_POW_BI_HIGH: BigInteger = PRECISION_POW_BI / BigInteger.TWO + + private const val cacheSize = 16384 + private const val cacheSizeL = cacheSize.toLong() + + private val cache = Array(cacheSize) { Regular(BigInteger.valueOf(it.toLong() - cacheSize / 2)) } + + init { + check(cache[cacheSize / 2].signum() == 0) + cache[cacheSize / 2] = Zero + } + + /** + * Returns pooled value if present, otherwise constructs new object + */ + @JvmStatic + fun valueOf(value: Int): Decimal { + if (value in (cacheSize / -2) until cacheSize / 2) { + return cache[value + cacheSize / 2] + } + + return Regular(BigInteger.valueOf(value.toLong())) + } + + /** + * Returns pooled value if present, otherwise constructs new object + */ + @JvmStatic + fun valueOf(value: Long): Decimal { + if (value in (cacheSizeL / -2L) until cacheSizeL / 2L) { + return cache[value.toInt() + cacheSize / 2] + } + + return Regular(BigInteger.valueOf(value)) + } + + /** + * Returns pooled value if present, otherwise constructs new object + */ + @JvmStatic + fun valueOf(value: Short) = valueOf(value.toInt()) + + /** + * Returns pooled value if present, otherwise constructs new object + */ + @JvmStatic + fun valueOf(value: Byte) = valueOf(value.toInt()) + + @JvmStatic fun valueOf(value: BigInteger): Decimal { + return if (value.signum() == 0) { + Zero + } else { + Regular(value) + } + } + + @JvmStatic fun valueOf(value: BigDecimal): Decimal { + return if (value.signum() == 0) { + Zero + } else { + Regular(value) + } + } + + @JvmStatic fun valueOf(value: String): Decimal { + if (value == "0") { + return Zero + } else { + val lower = value.lowercase() + + // why not + if (lower.startsWith("+inf") || lower.startsWith("inf") || lower == "∞" || lower == "+∞") { + return PositiveInfinity + } else if (lower.startsWith("-inf") || lower == "-∞") { + return NegativeInfinity + } else { + val result = Regular(value) + if (result.signum() == 0) return Zero + return result + } + } + } + + @JvmStatic fun valueOf(value: Float): Decimal { + return if (value == 0f) { + Zero + } else if (value == Float.POSITIVE_INFINITY) { + PositiveInfinity + } else if (value == Float.NEGATIVE_INFINITY) { + NegativeInfinity + } else { + Regular(value) + } + } + + @JvmStatic fun valueOf(value: Double): Decimal { + return if (value == 0.0) { + Zero + } else if (value == Double.POSITIVE_INFINITY) { + PositiveInfinity + } else if (value == Double.NEGATIVE_INFINITY) { + NegativeInfinity + } else { + Regular(value) + } + } + + @JvmStatic + fun fromByteArray(input: ByteArray): Decimal { + return if (input.isEmpty()) { + Zero + } else { + return when (input[0]) { + TYPE_NORMAL -> raw(BigInteger(input.copyOfRange(1, input.size))) + TYPE_NEGATIVE_INFINITY -> if (input.size == 1) NegativeInfinity else Zero + TYPE_POSITIVE_INFINITY -> if (input.size == 1) PositiveInfinity else Zero + // TYPE_ZERO -> Zero + else -> Zero + } + } + } + + /** + * Takes in [value] as-is and constructs [Decimal] out of it ([value] is treated as already scaled by [PRECISION]) + */ + @JvmStatic + fun raw(value: BigInteger): Decimal { + return if (value.signum() == 0) { + Zero + } else { + Regular(value, null) + } + } + + @JvmField val POSITIVE_INFINITY: Decimal = PositiveInfinity + @JvmField val NEGATIVE_INFINITY: Decimal = NegativeInfinity + @JvmField val ZERO: Decimal = Zero + @JvmField val ONE = valueOf(1) + @JvmField val TWO = valueOf(2) + @JvmField val TEN = valueOf(10) + @JvmField val MINUS_ONE = valueOf(-1) + @JvmField val MINUS_TWO = valueOf(-2) + @JvmField val MINUS_TEN = valueOf(-10) + @JvmField val ONE_TENTH = valueOf("0.1") + @JvmField val ONE_QUARTER = valueOf("0.25") + @JvmField val ONE_EIGHTH = valueOf("0.125") + @JvmField val ONE_HALF = valueOf("0.5") + @JvmField val MINUS_ONE_TENTH = valueOf("-0.1") + @JvmField val MINUS_ONE_EIGHTH = valueOf("-0.125") + @JvmField val MINUS_ONE_QUARTER = valueOf("-0.25") + @JvmField val MINUS_ONE_HALF = valueOf("-0.5") + + @JvmField val INT_MAX_VALUE: Decimal = Regular(BI_INT_MAX) + @JvmField val INT_MIN_VALUE: Decimal = Regular(BI_INT_MIN) + @JvmField val LONG_MAX_VALUE: Decimal = Regular(BI_LONG_MAX) + @JvmField val LONG_MIN_VALUE: Decimal = Regular(BI_LONG_MIN) + + @JvmField val FLOAT_MAX_VALUE: Decimal = Regular(BI_FLOAT_MAX) + @JvmField val FLOAT_MIN_VALUE: Decimal = Regular(BI_FLOAT_MIN) + @JvmField val DOUBLE_MAX_VALUE: Decimal = Regular(BI_DOUBLE_MAX) + @JvmField val DOUBLE_MIN_VALUE: Decimal = Regular(BI_DOUBLE_MIN) + } +} + +fun Float.toDecimal() = Decimal(this) +fun Double.toDecimal() = Decimal(this) +fun Int.toDecimal() = Decimal(this) +fun Byte.toDecimal() = Decimal(this) +fun Short.toDecimal() = Decimal(this) +fun Long.toDecimal() = Decimal(this) +fun Decimal.toDecimal() = this diff --git a/math/src/main/kotlin/ru/dbotthepony/kommons/math/HSVColor.kt b/math/src/main/kotlin/ru/dbotthepony/kommons/math/HSVColor.kt new file mode 100644 index 0000000..e8ca0b1 --- /dev/null +++ b/math/src/main/kotlin/ru/dbotthepony/kommons/math/HSVColor.kt @@ -0,0 +1,53 @@ +package ru.dbotthepony.kommons.math + +class HSVColor(hue: Float, saturation: Float, value: Float) : Comparable { + val hue = (hue % 360f).let { if (it < 0f) it + 360f else it } + val saturation = saturation.coerceIn(0f, 1f) + val value = value.coerceIn(0f, 1f) + + override fun equals(other: Any?): Boolean { + return other === this || other is HSVColor && other.hue == hue && other.saturation == saturation && other.value == value + } + + override fun hashCode(): Int { + return hue.hashCode() + saturation.hashCode() * 31 + value.hashCode() * 31 * 31 + } + + fun copy(hue: Float = this.hue, saturation: Float = this.saturation, value: Float = this.value): HSVColor { + return HSVColor(hue, saturation, value) + } + + operator fun component1() = hue + operator fun component2() = saturation + operator fun component3() = value + + fun toRGBA(alpha: Float = 1f): RGBAColor { + val valueMin = (1f - saturation) * value + val delta = (value - valueMin) * (hue % 60f) / 60f + val valueInc = valueMin + delta + val valueDec = value - delta + + return when ((hue / 60f).toInt()) { + 0 -> RGBAColor(value, valueInc, valueMin, alpha) + 1 -> RGBAColor(valueDec, value, valueMin, alpha) + 2 -> RGBAColor(valueMin, value, valueInc, alpha) + 3 -> RGBAColor(valueMin, valueDec, value, alpha) + 4 -> RGBAColor(valueInc, valueMin, value, alpha) + 5 -> RGBAColor(value, valueMin, valueDec, alpha) + else -> throw IllegalStateException("whut") + } + } + + override fun compareTo(other: HSVColor): Int { + return comparator.compare(this, other) + } + + companion object { + @JvmField val WHITE = HSVColor(0f, 1f, 1f) + + private val comparator = Comparator + .comparing(HSVColor::hue) + .thenComparing(HSVColor::saturation) + .thenComparing(HSVColor::value) + } +} diff --git a/math/src/main/kotlin/ru/dbotthepony/kommons/math/RGBAColor.kt b/math/src/main/kotlin/ru/dbotthepony/kommons/math/RGBAColor.kt new file mode 100644 index 0000000..0282101 --- /dev/null +++ b/math/src/main/kotlin/ru/dbotthepony/kommons/math/RGBAColor.kt @@ -0,0 +1,299 @@ +package ru.dbotthepony.kommons.math + +import kotlin.math.roundToInt + +private fun hex(value: Int): String { + require(value in 0 .. 255) + val v = value.toString(16) + + if (v.length == 1) + return "0$v" + else + return v +} + +class RGBAColor(red: Float, green: Float, blue: Float, alpha: Float = 1f) : Comparable { + constructor(r: Int, g: Int, b: Int) : this((r / 255f), (g / 255f), (b / 255f), 1f) + constructor(r: Int, g: Int, b: Int, a: Int) : this((r / 255f), (g / 255f), (b / 255f), (a / 255f)) + constructor(r: Int, g: Int, b: Int, a: Float) : this((r / 255f), (g / 255f), (b / 255f), a) + + val red = red.coerceIn(0f, 1f) + val green = green.coerceIn(0f, 1f) + val blue = blue.coerceIn(0f, 1f) + val alpha = alpha.coerceIn(0f, 1f) + + val redInt get() = (red * 255f).roundToInt() + val greenInt get() = (green * 255f).roundToInt() + val blueInt get() = (blue * 255f).roundToInt() + val alphaInt get() = (alpha * 255f).roundToInt() + + fun toRGBA(): Int { + return (redInt shl 24) or (greenInt shl 16) or (blueInt shl 8) or alphaInt + } + + fun toARGB(): Int { + return (alphaInt shl 24) or (redInt shl 16) or (greenInt shl 8) or blueInt + } + + fun toBGRA(): Int { + return (blueInt shl 24) or (greenInt shl 16) or (redInt shl 8) or alphaInt + } + + val isFullyTransparent get() = alpha <= 0f + val isWhite: Boolean get() = red >= 1f && green >= 1f && blue >= 1f && alpha >= 1f + + fun canRepresentHue(): Boolean { + val min = red.coerceAtMost(green).coerceAtMost(blue) + val max = red.coerceAtLeast(green).coerceAtLeast(blue) + return min != max + } + + fun hue(ifNoHue: Float = 0f): Float { + val min = red.coerceAtMost(green).coerceAtMost(blue) + val max = red.coerceAtLeast(green).coerceAtLeast(blue) + + if (min == max) { + return ifNoHue + } + + val diff = max - min + + return if (max == red && green >= blue) { + 60f * (green - blue) / diff + } else if (max == red) { + 60f * (green - blue) / diff + 360f + } else if (max == green) { + 60f * (blue - red) / diff + 120f + } else if (max == blue) { + 60f * (red - green) / diff + 240f + } else { + throw IllegalStateException("Whut $red $green $blue ($min / $max)") + } + } + + fun toHSV(): HSVColor { + val min = red.coerceAtMost(green).coerceAtMost(blue) + val max = red.coerceAtLeast(green).coerceAtLeast(blue) + + if (min == max) { + return HSVColor(0f, if (max == 0f) 0f else 1f - min / max, max) + } + + val diff = max - min + + val hue = if (max == red && green >= blue) { + 60f * (green - blue) / diff + } else if (max == red) { + 60f * (green - blue) / diff + 360f + } else if (max == green) { + 60f * (blue - red) / diff + 120f + } else if (max == blue) { + 60f * (red - green) / diff + 240f + } else { + throw IllegalStateException("Whut $red $green $blue ($min / $max)") + } + + return HSVColor(hue, 1f - min / max, max) + } + + fun toHexStringRGB(): String { + return "#${hex(redInt)}${hex(greenInt)}${hex(blueInt)}" + } + + fun toHexStringRGBA(): String { + return "#${hex(redInt)}${hex(greenInt)}${hex(blueInt)}${hex(alphaInt)}" + } + + fun toHexStringARGB(): String { + return "#${hex(alphaInt)}${hex(redInt)}${hex(greenInt)}${hex(blueInt)}" + } + + override fun toString(): String { + return "RGBAColor[$red $green $blue $alpha]" + } + + operator fun component1() = red + operator fun component2() = green + operator fun component3() = blue + operator fun component4() = alpha + + fun toIntInv(): Int { + return (blueInt shl 16) or (greenInt shl 8) or redInt + } + + fun toRGB(): Int { + return (redInt shl 16) or (greenInt shl 8) or blueInt + } + + fun copy(red: Float = this.red, green: Float = this.green, blue: Float = this.blue, alpha: Float = this.alpha): RGBAColor { + return RGBAColor(red, green, blue, alpha) + } + + override fun compareTo(other: RGBAColor): Int { + if (canRepresentHue() && other.canRepresentHue()) + return hue().compareTo(other.hue()).let { + if (it != 0) + it + else + toHSV().compareTo(other.toHSV()) + } + + return comparator.compare(this, other) + } + + override fun equals(other: Any?): Boolean { + return other === this || other is RGBAColor && comparator.compare(this, other) == 0 + } + + override fun hashCode(): Int { + return red.hashCode() + green.hashCode() * 31 + blue.hashCode() * 31 * 31 + alpha.hashCode() * 31 * 31 * 31 + } + + /*fun linearInterpolation(t: Float, other: RGBAColor, interpolateAlpha: Boolean = true): RGBAColor { + return RGBAColor( + linearInterpolation(t, red, other.red), + linearInterpolation(t, green, other.green), + linearInterpolation(t, blue, other.blue), + if (interpolateAlpha) linearInterpolation(t, alpha, other.alpha) else alpha, + ) + }*/ + + operator fun times(other: RGBAColor): RGBAColor { + if (isWhite) + return other + else if (other.isWhite) + return this + + return RGBAColor(red * other.red, green * other.green, blue * other.blue, alpha * other.alpha) + } + + @Suppress("unused") + companion object { + private val comparator = Comparator + .comparing(RGBAColor::red) + .thenComparing(RGBAColor::green) + .thenComparing(RGBAColor::blue) + .thenComparing(RGBAColor::alpha) + + @JvmField val TRANSPARENT_BLACK = RGBAColor(0f, 0f, 0f, 0f) + @JvmField val TRANSPARENT_WHITE = RGBAColor(1f, 1f, 1f, 0f) + + @JvmField val BLACK = RGBAColor(0f, 0f, 0f) + @JvmField val WHITE = RGBAColor(1f, 1f, 1f) + @JvmField val RED = RGBAColor(1f, 0f, 0f) + @JvmField val GREEN = RGBAColor(0f, 1f, 0f) + @JvmField val LIGHT_GREEN = RGBAColor(136, 255, 124) + @JvmField val SLATE_GRAY = RGBAColor(64, 64, 64) + @JvmField val GRAY = rgb(0x2C2C2CL) + @JvmField val LIGHT_GRAY = rgb(0x7F7F7FL) + @JvmField val HEADING_TEXT = rgb(0x404040L) + + @JvmField val LOW_POWER = RGBAColor(173, 41, 41) + @JvmField val FULL_POWER = RGBAColor(255, 242, 40) + @JvmField val LOW_MATTER = RGBAColor(0, 24, 148) + @JvmField val FULL_MATTER = RGBAColor(72, 90, 255) + @JvmField val LOW_PATTERNS = RGBAColor(44, 104, 57) + @JvmField val FULL_PATTERNS = RGBAColor(65, 255, 87) + + @JvmField val HALF_TRANSPARENT = RGBAColor(1f, 1f, 1f, 0.5f) + @JvmField val REDDISH = RGBAColor(1f, 0.4f, 0.4f) + + fun rgb(color: Int): RGBAColor { + val r = (color and 0xFF0000 ushr 16) / 255f + val g = (color and 0xFF00 ushr 8) / 255f + val b = (color and 0xFF) / 255f + return RGBAColor(r, g, b) + } + + fun rgb(color: Long): RGBAColor { + val r = (color and 0xFF0000 ushr 16) / 255f + val g = (color and 0xFF00 ushr 8) / 255f + val b = (color and 0xFF) / 255f + return RGBAColor(r, g, b) + } + + fun bgr(color: Int): RGBAColor { + val r = (color and 0xFF0000 ushr 16) / 255f + val g = (color and 0xFF00 ushr 8) / 255f + val b = (color and 0xFF) / 255f + return RGBAColor(b, g, r) + } + + fun bgr(color: Long): RGBAColor { + val r = (color and 0xFF0000 ushr 16) / 255f + val g = (color and 0xFF00 ushr 8) / 255f + val b = (color and 0xFF) / 255f + return RGBAColor(b, g, r) + } + + fun abgr(color: Int): RGBAColor { + val r = (color and -0x1000000 ushr 24) / 255f + val g = (color and 0xFF0000 ushr 16) / 255f + val b = (color and 0xFF00 ushr 8) / 255f + val a = (color and 0xFF) / 255f + return RGBAColor(a, b, g, r) + } + + fun argb(color: Int): RGBAColor { + val a = (color and -0x1000000 ushr 24) / 255f + val r = (color and 0xFF0000 ushr 16) / 255f + val g = (color and 0xFF00 ushr 8) / 255f + val b = (color and 0xFF) / 255f + return RGBAColor(r, g, b, a) + } + + private val hexChars = HashSet() + + init { + "#0123456789abcdefABCDEF".forEach { hexChars.add(it) } + } + + fun isHexCharacter(char: Char): Boolean { + return char in hexChars + } + + private val shorthandRGBHex = Regex("#?([0-9abcdef])([0-9abcdef])([0-9abcdef])", RegexOption.IGNORE_CASE) + private val longhandRGBHex = Regex("#?([0-9abcdef]{2})([0-9abcdef]{2})([0-9abcdef]{2})", RegexOption.IGNORE_CASE) + + private val shorthandRGBAHex = Regex("#?([0-9abcdef])([0-9abcdef])([0-9abcdef])([0-9abcdef])", RegexOption.IGNORE_CASE) + private val longhandRGBAHex = Regex("#?([0-9abcdef]{2})([0-9abcdef]{2})([0-9abcdef]{2})([0-9abcdef]{2})", RegexOption.IGNORE_CASE) + + fun fromHexStringRGB(value: String): RGBAColor? { + if (value.length == 3 || value.length == 4) { + val match = shorthandRGBHex.find(value) ?: return null + val red = match.groupValues[1].toIntOrNull(16) ?: return null + val green = match.groupValues[2].toIntOrNull(16) ?: return null + val blue = match.groupValues[3].toIntOrNull(16) ?: return null + return RGBAColor(red * 16, green * 16, blue * 16) + } else if (value.length == 6 || value.length == 7) { + val match = longhandRGBHex.find(value) ?: return null + val red = match.groupValues[1].toIntOrNull(16) ?: return null + val green = match.groupValues[2].toIntOrNull(16) ?: return null + val blue = match.groupValues[3].toIntOrNull(16) ?: return null + return RGBAColor(red, green, blue) + } else { + return null + } + } + + fun fromHexStringRGBA(value: String): RGBAColor? { + if (value.length == 4 || value.length == 5) { + val match = shorthandRGBAHex.find(value) ?: return null + val red = match.groupValues[1].toIntOrNull(16) ?: return null + val green = match.groupValues[2].toIntOrNull(16) ?: return null + val blue = match.groupValues[3].toIntOrNull(16) ?: return null + val alpha = match.groupValues[4].toIntOrNull(16) ?: return null + return RGBAColor(red * 16, green * 16, blue * 16, alpha * 16) + } else if (value.length == 8 || value.length == 9) { + val match = longhandRGBAHex.find(value) ?: return null + val red = match.groupValues[1].toIntOrNull(16) ?: return null + val green = match.groupValues[2].toIntOrNull(16) ?: return null + val blue = match.groupValues[3].toIntOrNull(16) ?: return null + val alpha = match.groupValues[4].toIntOrNull(16) ?: return null + return RGBAColor(red, green, blue, alpha) + } else { + return null + } + } + } +} diff --git a/networking/build.gradle.kts b/networking/build.gradle.kts new file mode 100644 index 0000000..2baf89b --- /dev/null +++ b/networking/build.gradle.kts @@ -0,0 +1,47 @@ + +plugins { + kotlin("jvm") + `maven-publish` +} + +val networkingVersion: String by project +val projectGroup: String by project + +group = projectGroup +version = networkingVersion + +repositories { + mavenCentral() +} + +dependencies { + testImplementation("org.jetbrains.kotlin:kotlin-test") + implementation(project(":core")) + implementation(project(":io")) + implementation(project(":collect")) +} + +tasks.test { + useJUnitPlatform() +} + +kotlin { + jvmToolchain(17) +} + +publishing { + publications { + create("mavenJava") { + from(components["java"]) + + pom { + dependencies { + implementation(kotlin("stdlib")) + implementation(project(":core")) + implementation(project(":io")) + implementation(project(":collect")) + } + } + } + } +} diff --git a/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/ChangesetAction.kt b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/ChangesetAction.kt new file mode 100644 index 0000000..341ce4e --- /dev/null +++ b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/ChangesetAction.kt @@ -0,0 +1,5 @@ +package ru.dbotthepony.kommons.networking + +enum class ChangesetAction { + CLEAR, ADD, REMOVE +} diff --git a/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldAccess.kt b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldAccess.kt new file mode 100644 index 0000000..a653bef --- /dev/null +++ b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldAccess.kt @@ -0,0 +1,41 @@ +package ru.dbotthepony.kommons.networking + +interface FieldAccess { + fun read(): V + fun write(value: V) +} + +interface FloatFieldAccess : FieldAccess { + override fun write(value: Float) + @Deprecated("Use type specific method", replaceWith = ReplaceWith("this.readFloat()")) + override fun read() = readFloat() + fun readFloat(): Float +} + +interface DoubleFieldAccess : FieldAccess { + override fun write(value: Double) + @Deprecated("Use type specific method", replaceWith = ReplaceWith("this.readDouble()")) + override fun read() = readDouble() + fun readDouble(): Double +} + +interface IntFieldAccess : FieldAccess { + override fun write(value: Int) + @Deprecated("Use type specific method", replaceWith = ReplaceWith("this.readInt()")) + override fun read() = readInt() + fun readInt(): Int +} + +interface LongFieldAccess : FieldAccess { + override fun write(value: Long) + @Deprecated("Use type specific method", replaceWith = ReplaceWith("this.readLong()")) + override fun read() = readLong() + fun readLong(): Long +} + +interface BooleanFieldAccess : FieldAccess { + override fun write(value: Boolean) + @Deprecated("Use type specific method", replaceWith = ReplaceWith("this.readBoolean()")) + override fun read() = readBoolean() + fun readBoolean(): Boolean +} diff --git a/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldGetter.kt b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldGetter.kt new file mode 100644 index 0000000..36ee42d --- /dev/null +++ b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldGetter.kt @@ -0,0 +1,50 @@ +package ru.dbotthepony.kommons.networking + +fun interface FieldGetter { + fun invoke(field: FieldAccess): V +} + +fun interface FloatFieldGetter : FieldGetter { + fun invoke(field: FloatFieldAccess): Float + + @Deprecated("Use type specific invoke") + override fun invoke(field: FieldAccess): Float { + return invoke(field as FloatFieldAccess) + } +} + +fun interface DoubleFieldGetter : FieldGetter { + fun invoke(field: DoubleFieldAccess): Double + + @Deprecated("Use type specific invoke") + override fun invoke(field: FieldAccess): Double { + return invoke(field as DoubleFieldAccess) + } +} + +fun interface IntFieldGetter : FieldGetter { + fun invoke(field: IntFieldAccess): Int + + @Deprecated("Use type specific invoke") + override fun invoke(field: FieldAccess): Int { + return invoke(field as IntFieldAccess) + } +} + +fun interface LongFieldGetter : FieldGetter { + fun invoke(field: LongFieldAccess): Long + + @Deprecated("Use type specific invoke") + override fun invoke(field: FieldAccess): Long { + return invoke(field as LongFieldAccess) + } +} + +fun interface BooleanFieldGetter : FieldGetter { + fun invoke(field: BooleanFieldAccess): Boolean + + @Deprecated("Use type specific invoke") + override fun invoke(field: FieldAccess): Boolean { + return invoke(field as BooleanFieldAccess) + } +} diff --git a/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldSetter.kt b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldSetter.kt new file mode 100644 index 0000000..4c4b690 --- /dev/null +++ b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldSetter.kt @@ -0,0 +1,50 @@ +package ru.dbotthepony.kommons.networking + +fun interface FieldSetter { + fun invoke(value: V, access: FieldAccess, setByRemote: Boolean) +} + +fun interface FloatFieldSetter : FieldSetter { + fun invoke(value: Float, access: FloatFieldAccess, setByRemote: Boolean) + + @Deprecated("Use type specific invoke") + override fun invoke(value: Float, access: FieldAccess, setByRemote: Boolean) { + invoke(value, access as FloatFieldAccess, setByRemote) + } +} + +fun interface DoubleFieldSetter : FieldSetter { + fun invoke(value: Double, access: DoubleFieldAccess, setByRemote: Boolean) + + @Deprecated("Use type specific invoke") + override fun invoke(value: Double, access: FieldAccess, setByRemote: Boolean) { + invoke(value, access as DoubleFieldAccess, setByRemote) + } +} + +fun interface IntFieldSetter : FieldSetter { + fun invoke(value: Int, access: IntFieldAccess, setByRemote: Boolean) + + @Deprecated("Use type specific invoke") + override fun invoke(value: Int, access: FieldAccess, setByRemote: Boolean) { + invoke(value, access as IntFieldAccess, setByRemote) + } +} + +fun interface LongFieldSetter : FieldSetter { + fun invoke(value: Long, access: LongFieldAccess, setByRemote: Boolean) + + @Deprecated("Use type specific invoke") + override fun invoke(value: Long, access: FieldAccess, setByRemote: Boolean) { + invoke(value, access as LongFieldAccess, setByRemote) + } +} + +fun interface BooleanFieldSetter : FieldSetter { + fun invoke(value: Boolean, access: BooleanFieldAccess, setByRemote: Boolean) + + @Deprecated("Use type specific invoke") + override fun invoke(value: Boolean, access: FieldAccess, setByRemote: Boolean) { + invoke(value, access as BooleanFieldAccess, setByRemote) + } +} diff --git a/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldSynchronizer.kt b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldSynchronizer.kt new file mode 100644 index 0000000..131cd2c --- /dev/null +++ b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/FieldSynchronizer.kt @@ -0,0 +1,2159 @@ +@file:Suppress("DeprecatedCallableAddReplaceWith") + +package ru.dbotthepony.kommons.networking + +import ru.dbotthepony.kommons.collect.ProxiedMap +import ru.dbotthepony.kommons.collect.forValidRefs +import ru.dbotthepony.kommons.event.IBooleanSubscriptable +import ru.dbotthepony.kommons.event.IDoubleSubcripable +import ru.dbotthepony.kommons.event.IFloatSubcripable +import ru.dbotthepony.kommons.event.IIntSubcripable +import ru.dbotthepony.kommons.event.ILongSubcripable +import ru.dbotthepony.kommons.event.ISubscriptable +import ru.dbotthepony.kommons.io.BigDecimalValueCodec +import ru.dbotthepony.kommons.io.BinaryStringCodec +import ru.dbotthepony.kommons.io.ByteValueCodec +import ru.dbotthepony.kommons.io.EnumValueCodec +import ru.dbotthepony.kommons.io.IStreamCodec +import ru.dbotthepony.kommons.io.ShortValueCodec +import ru.dbotthepony.kommons.io.UUIDValueCodec +import ru.dbotthepony.kommons.io.readSignedVarInt +import ru.dbotthepony.kommons.io.readSignedVarLong +import ru.dbotthepony.kommons.io.readVarInt +import ru.dbotthepony.kommons.io.readVarLong +import ru.dbotthepony.kommons.io.writeSignedVarInt +import ru.dbotthepony.kommons.io.writeSignedVarLong +import ru.dbotthepony.kommons.io.writeVarInt +import ru.dbotthepony.kommons.io.writeVarLong +import ru.dbotthepony.kommons.util.BooleanConsumer +import ru.dbotthepony.kommons.util.FloatConsumer +import ru.dbotthepony.kommons.util.FloatSupplier +import java.io.ByteArrayOutputStream +import java.io.DataInputStream +import java.io.DataOutputStream +import java.io.InputStream +import java.lang.ref.WeakReference +import java.math.BigDecimal +import java.util.* +import java.util.function.BooleanSupplier +import java.util.function.Consumer +import java.util.function.DoubleConsumer +import java.util.function.DoubleSupplier +import java.util.function.IntConsumer +import java.util.function.IntSupplier +import java.util.function.LongConsumer +import java.util.function.LongSupplier +import java.util.function.Supplier +import kotlin.collections.LinkedHashSet +import kotlin.reflect.KMutableProperty0 +import kotlin.reflect.KProperty +import kotlin.reflect.KProperty0 + +/** + * Universal, one-to-many value synchronizer, allowing to synchronize values from server to client + * anywhere, where input/output streams are supported + */ +@Suppress("unused", "BlockingMethodInNonBlockingContext") +class FieldSynchronizer(private val callback: Runnable, private val alwaysCallCallback: Boolean) { + constructor() : this(Runnable {}, false) + constructor(callback: Runnable) : this(callback, false) + + private var freeSlots = 0 + // почему не удалять поля напрямую? + // чтоб не возникло проблем в состоянии гонки + // формируем пакет -> удаляем поле по обе стороны -> клиент принимает пакет -> клиент считывает неверные данные + // конечно, всё равно всё сломается если было удалено поле, которое находится в пакете + // но если поля нет в пакете, то всё окей + private val fields = ArrayList?>(0) + private val observers = ArrayList>(0) + + private var nextFieldID = 0 + + val hasObservers: Boolean get() = observers.isNotEmpty() + + var isEmpty: Boolean = true + private set + + val isNotEmpty: Boolean get() = !isEmpty + + var isDirty: Boolean = false + private set(value) { + if (value != field) { + field = value + + if (value && !alwaysCallCallback) { + callback.run() + } + } + + if (alwaysCallCallback && value) { + callback.run() + } + } + + fun markClean() { + isDirty = false + } + + fun computedByte(getter: () -> Byte) = ComputedField(getter, ByteValueCodec) + fun computedBool(getter: BooleanSupplier) = ComputedBooleanField(getter) + fun computedShort(getter: () -> Short) = ComputedField(getter, ShortValueCodec) + fun computedLong(getter: LongSupplier) = ComputedLongField(getter) + fun computedFixedLong(getter: LongSupplier) = ComputedFixedLongField(getter) + fun computedFloat(getter: FloatSupplier) = ComputedFloatField(getter) + fun computedDouble(getter: DoubleSupplier) = ComputedDoubleField(getter) + fun computedUuid(getter: () -> UUID) = ComputedField(getter, UUIDValueCodec) + fun computedInt(getter: IntSupplier) = ComputedIntField(getter) + fun computedFixedInt(getter: IntSupplier) = ComputedFixedIntField(getter) + fun computedBigDecimal(getter: () -> BigDecimal) = ComputedField(getter, BigDecimalValueCodec) + fun computedString(getter: () -> String) = ComputedField(getter, BinaryStringCodec) + + fun computedByte(getter: KProperty0) = ComputedField(getter, ByteValueCodec) + fun computedBool(getter: KProperty0) = ComputedBooleanField(getter::get) + fun computedShort(getter: KProperty0) = ComputedField(getter, ShortValueCodec) + fun computedLong(getter: KProperty0) = ComputedLongField(getter::get) + fun computedFixedLong(getter: KProperty0) = ComputedFixedLongField(getter::get) + fun computedFloat(getter: KProperty0) = ComputedFloatField(getter::get) + fun computedDouble(getter: KProperty0) = ComputedDoubleField(getter::get) + fun computedUuid(getter: KProperty0) = ComputedField(getter, UUIDValueCodec) + fun computedInt(getter: KProperty0) = ComputedIntField(getter::get) + fun computedFixedInt(getter: KProperty0) = ComputedFixedIntField(getter::get) + fun computedBigDecimal(getter: KProperty0) = ComputedField(getter, BigDecimalValueCodec) + fun computedString(getter: KProperty0) = ComputedField(getter, BinaryStringCodec) + + fun computedByte(getter: Supplier) = ComputedField(getter::get, ByteValueCodec) + fun computedBool(getter: Supplier) = ComputedBooleanField(getter::get) + fun computedShort(getter: Supplier) = ComputedField(getter::get, ShortValueCodec) + fun computedLong(getter: Supplier) = ComputedLongField(getter::get) + fun computedFixedLong(getter: Supplier) = ComputedFixedLongField(getter::get) + fun computedFloat(getter: Supplier) = ComputedFloatField(getter::get) + fun computedDouble(getter: Supplier) = ComputedDoubleField(getter::get) + fun computedUuid(getter: Supplier) = ComputedField(getter::get, UUIDValueCodec) + fun computedInt(getter: Supplier) = ComputedIntField(getter::get) + fun computedFixedInt(getter: Supplier) = ComputedFixedIntField(getter::get) + fun computedBigDecimal(getter: Supplier) = ComputedField(getter::get, BigDecimalValueCodec) + fun computedString(getter: Supplier) = ComputedField(getter::get, BinaryStringCodec) + + fun > computedEnum(type: Class, getter: () -> T) = ComputedField(getter, EnumValueCodec(type)) + inline fun > computedEnum(noinline getter: () -> T) = ComputedField(getter, EnumValueCodec(T::class.java)) + + fun > computedEnum(type: Class, getter: KProperty0) = ComputedField(getter, EnumValueCodec(type)) + inline fun > computedEnum(getter: KProperty0) = ComputedField(getter, EnumValueCodec(T::class.java)) + + fun > computedEnum(type: Class, getter: Supplier) = ComputedField(getter::get, EnumValueCodec(type)) + inline fun > computedEnum(getter: Supplier) = ComputedField(getter::get, EnumValueCodec(T::class.java)) + + @JvmOverloads + fun byte( + value: Byte = 0, + getter: FieldGetter? = null, + setter: FieldSetter? = null, + ): Field { + return Field(value, ByteValueCodec, getter, setter) + } + + @JvmOverloads + fun bool( + value: Boolean = false, + getter: BooleanFieldGetter? = null, + setter: BooleanFieldSetter? = null, + ): BooleanField { + return BooleanField(value, getter, setter) + } + + @JvmOverloads + fun short( + value: Short = 0, + getter: FieldGetter? = null, + setter: FieldSetter? = null, + ): Field { + return Field(value, ShortValueCodec, getter, setter) + } + + @JvmOverloads + fun long( + value: Long = 0L, + getter: LongFieldGetter? = null, + setter: LongFieldSetter? = null, + ): LongField { + return LongField(value, getter, setter) + } + + @JvmOverloads + fun fixedLong( + value: Long = 0L, + getter: LongFieldGetter? = null, + setter: LongFieldSetter? = null, + ): FixedLongField { + return FixedLongField(value, getter, setter) + } + + @JvmOverloads + fun float( + value: Float = 0f, + getter: FloatFieldGetter? = null, + setter: FloatFieldSetter? = null, + ): FloatField { + return FloatField(value, getter, setter) + } + + @JvmOverloads + fun double( + value: Double = 0.0, + getter: DoubleFieldGetter? = null, + setter: DoubleFieldSetter? = null, + ): DoubleField { + return DoubleField(value, getter, setter) + } + + @JvmOverloads + fun uuid( + value: UUID = UUID(0L, 0L), + getter: FieldGetter? = null, + setter: FieldSetter? = null, + ): Field { + return Field(value, UUIDValueCodec, getter, setter) + } + + @JvmOverloads + fun int( + value: Int = 0, + getter: IntFieldGetter? = null, + setter: IntFieldSetter? = null, + ): IntField { + return IntField(value, getter, setter) + } + + @JvmOverloads + fun string( + value: String = "", + getter: FieldGetter? = null, + setter: FieldSetter? = null, + ): Field { + return Field(value, BinaryStringCodec, getter, setter) + } + + @JvmOverloads + fun fixedInt( + value: Int = 0, + getter: IntFieldGetter? = null, + setter: IntFieldSetter? = null, + ): FixedIntField { + return FixedIntField(value, getter, setter) + } + + @JvmOverloads + fun bigDecimal( + value: BigDecimal = BigDecimal.ZERO, + getter: FieldGetter? = null, + setter: FieldSetter? = null, + ): Field { + return Field(value, BigDecimalValueCodec, getter, setter) + } + + @JvmOverloads + fun > enum( + type: Class, + value: T = type.enumConstants[0], + getter: FieldGetter? = null, + setter: FieldSetter? = null, + ): Field { + return Field(value, EnumValueCodec(type), getter, setter) + } + + @JvmOverloads + fun > enum( + value: T, + getter: FieldGetter? = null, + setter: FieldSetter? = null, + ): Field { + return Field(value, EnumValueCodec(value::class.java), getter, setter) + } + + private var endpointsMaxCapacity = 1 + private val endpoints = ArrayList>(1) + val defaultEndpoint = Endpoint() + + private var lastEndpointCleanup = System.nanoTime() + + private fun notifyEndpoints(dirtyField: AbstractField<*>) { + isDirty = true + + forEachEndpoint { + it.addDirtyField(dirtyField) + } + } + + private inline fun forEachEndpoint(execute: (Endpoint) -> Unit) { + synchronized(endpoints) { + endpoints.forValidRefs { execute.invoke(it) } + + if (endpoints.size < endpointsMaxCapacity / 2) { + endpoints.trimToSize() + endpointsMaxCapacity = endpoints.size + } + } + } + + inner class Endpoint { + init { + synchronized(endpoints) { + endpoints.add(WeakReference(this)) + endpointsMaxCapacity = endpointsMaxCapacity.coerceAtLeast(endpoints.size) + + if (System.nanoTime() - lastEndpointCleanup <= 60) { + lastEndpointCleanup = System.nanoTime() + + val iterator = endpoints.listIterator() + + for (value in iterator) { + if (value.get() == null) { + iterator.remove() + } + } + + if (endpoints.size < endpointsMaxCapacity / 2) { + endpoints.trimToSize() + endpointsMaxCapacity = endpoints.size + } + } + } + } + + private val dirtyFields = LinkedHashSet>() + + // use LinkedList because it is ensured memory is freed on LinkedList#clear + private val mapBacklogs = IdentityHashMap, LinkedList Unit>>>() + private val setBacklogs = IdentityHashMap, LinkedList Unit>>>() + + var unused: Boolean = false + private set + + fun markUnused() { + require(this === defaultEndpoint) { "This is not a default endpoint" } + if (unused) return + unused = true + mapBacklogs.clear() + dirtyFields.clear() + + val iterator = endpoints.listIterator() + + for (value in iterator) { + if (value.get() === this) { + iterator.remove() + } + } + } + + init { + markDirty() + } + + fun markDirty() { + for (field in fields) { + field?.markDirty(this) + } + } + + internal fun addDirtyField(field: AbstractField<*>) { + if (unused) { + return + } + + dirtyFields.add(field) + } + + internal fun removeDirtyField(field: AbstractField<*>) { + dirtyFields.remove(field) + } + + internal fun getMapBacklog(map: Map): LinkedList Unit>> { + if (unused) { + return LinkedList() + } + + return mapBacklogs.computeIfAbsent(map) { + LinkedList() + } + } + + internal fun removeMapBacklog(map: Map) { + mapBacklogs.remove(map) + } + + internal fun getSetBacklog(set: Set): LinkedList Unit>> { + if (unused) { + return LinkedList() + } + + return setBacklogs.computeIfAbsent(set) { + LinkedList() + } + } + + internal fun removeSetBacklog(set: Set) { + setBacklogs.remove(set) + } + + fun collectNetworkPayload(): ByteArrayOutputStream? { + if (unused || dirtyFields.isEmpty()) { + return null + } + + val stream = ByteArrayOutputStream() + val dataStream = DataOutputStream(stream) + + for (field in dirtyFields) { + stream.writeVarInt(field.id) + field.write(dataStream, this) + } + + dirtyFields.clear() + stream.write(0) + + return stream + } + } + + private val boundEndpoints = WeakHashMap() + + fun computeEndpointFor(obj: Any): Endpoint { + return boundEndpoints.computeIfAbsent(obj) { Endpoint() } + } + + fun removeEndpointFor(obj: Any): Endpoint? { + return boundEndpoints.remove(obj) + } + + fun endpointFor(obj: Any): Endpoint? { + return boundEndpoints[obj] + } + + @Suppress("LeakingThis") + abstract inner class AbstractField : IField { + val id: Int + + init { + if (freeSlots > 0) { + var found = -1 + + for (i in fields.indices) { + if (fields[i] == null) { + fields[i] = this + found = i + 1 + freeSlots-- + break + } + } + + if (found == -1) { + throw RuntimeException("freeSlots = $freeSlots but no null entries in field list!") + } else { + id = found + } + } else { + fields.add(this) + id = fields.size + isEmpty = false + } + } + + final override var isRemoved = false + private set + + protected var isDirty = false + + override fun remove() { + if (isRemoved) + return + + isRemoved = true + freeSlots++ + fields[id - 1] = null + observers.remove(this) + isEmpty = fields.all { it == null } + + while (fields[fields.size - 1] == null) { + fields.removeAt(fields.size - 1) + freeSlots-- + } + + forEachEndpoint { + it.removeDirtyField(this) + } + } + + override fun markDirty(endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + endpoint.addDirtyField(this) + } + + override fun markDirty() { + check(!isRemoved) { "Field was removed" } + notifyEndpoints(this@AbstractField) + isDirty = true + } + } + + /** + * Networked variable with backing field holding immutable value + */ + inner class Field( + private var field: V, + private val codec: IStreamCodec, + private val getter: FieldGetter? = null, + private val setter: FieldSetter? = null, + isObserver: Boolean = false, + ) : AbstractField(), IMutableField { + private var remote: V = codec.copy(field) + private val subs = ISubscriptable.Impl() + + override fun addListener(listener: Consumer): ISubscriptable.L { + return subs.addListener(listener) + } + + init { + if (isObserver) { + observers.add(this) + } + } + + private val access = object : FieldAccess { + override fun read(): V { + return field + } + + override fun write(value: V) { + if (!isDirty && !codec.compare(remote, value)) { + notifyEndpoints(this@Field) + isDirty = true + } + + this@Field.field = value + subs.accept(value) + } + } + + override fun observe(): Boolean { + check(!isRemoved) { "Field was removed" } + + if (!isDirty && !codec.compare(remote, field)) { + notifyEndpoints(this@Field) + isDirty = true + } + + return isDirty + } + + override var value: V + get() { + val getter = this.getter + + if (getter != null) { + return getter.invoke(access) + } + + return this.field + } + set(value) { + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, false) + } else { + if (!isDirty && !codec.compare(remote, value)) { + notifyEndpoints(this@Field) + isDirty = true + } + + this.field = value + subs.accept(value) + } + } + + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + codec.write(stream, field) + isDirty = false + remote = codec.copy(field) + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val value = codec.read(stream) + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, true) + } else { + this.field = value + subs.accept(value) + } + } + } + + abstract inner class PrimitiveField : AbstractField() { + override fun observe(): Boolean { + check(!isRemoved) { "Field was removed" } + return isDirty + } + } + + /** + * Type specific field, storing primitive [Float] directly + */ + inner class FloatField(field: Float, private val getter: FloatFieldGetter? = null, private val setter: FloatFieldSetter? = null) : PrimitiveField(), IMutableFloatField { + private val subs = IFloatSubcripable.Impl() + + override fun addListener(listener: FloatConsumer): ISubscriptable.L { + return subs.addListener(listener) + } + + private var field = field + set(value) { + if (field != value) { + field = value + subs.accept(value) + } + } + + override val property = object : IMutableFloatProperty { + override fun getValue(thisRef: Any?, property: KProperty<*>): Float { + return this@FloatField.float + } + + override fun setValue(thisRef: Any?, property: KProperty<*>, value: Float) { + this@FloatField.float = value + } + } + + private val access = object : FloatFieldAccess { + override fun readFloat(): Float { + return this@FloatField.field + } + + override fun write(value: Float) { + if (!isDirty && value != this@FloatField.field) { + notifyEndpoints(this@FloatField) + isDirty = true + } + + this@FloatField.field = value + } + } + + override var float: Float + get() { + return getter?.invoke(access) ?: this.field + } + set(value) { + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, false) + } else if (value != this.field) { + if (!isDirty) { + notifyEndpoints(this) + isDirty = true + } + + this.field = value + } + } + + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeFloat(this.field) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val value = stream.readFloat() + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, true) + } else { + this.field = value + } + } + } + + /** + * Type specific field, storing primitive [Double] directly + */ + inner class DoubleField(field: Double, private val getter: DoubleFieldGetter? = null, private val setter: DoubleFieldSetter? = null) : PrimitiveField(), IMutableDoubleField { + private val subs = IDoubleSubcripable.Impl() + + override fun addListener(listener: DoubleConsumer): ISubscriptable.L { + return subs.addListener(listener) + } + + private var field = field + set(value) { + if (field != value) { + field = value + subs.accept(value) + } + } + + override val property = object : IMutableDoubleProperty { + override fun getValue(thisRef: Any?, property: KProperty<*>): Double { + return this@DoubleField.double + } + + override fun setValue(thisRef: Any?, property: KProperty<*>, value: Double) { + this@DoubleField.double = value + } + } + + private val access = object : DoubleFieldAccess { + override fun readDouble(): Double { + return this@DoubleField.field + } + + override fun write(value: Double) { + if (!isDirty && value != this@DoubleField.field) { + notifyEndpoints(this@DoubleField) + isDirty = true + } + + this@DoubleField.field = value + } + } + + override var double: Double + get() { + return getter?.invoke(access) ?: this.field + } + set(value) { + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, false) + } else if (value != this.field) { + if (!isDirty) { + notifyEndpoints(this) + isDirty = true + } + + this.field = value + } + } + + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeDouble(this.field) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val value = stream.readDouble() + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, true) + } else { + this.field = value + } + } + } + + abstract inner class AbstractIntField(field: Int, private val getter: IntFieldGetter? = null, protected val setter: IntFieldSetter? = null) : PrimitiveField(), IMutableIntField { + private val subs = IIntSubcripable.Impl() + + override fun addListener(listener: IntConsumer): ISubscriptable.L { + return subs.addListener(listener) + } + + protected var field = field + set(value) { + if (field != value) { + field = value + subs.accept(value) + } + } + + final override val property = object : IMutableIntProperty { + override fun getValue(thisRef: Any?, property: KProperty<*>): Int { + return this@AbstractIntField.int + } + + override fun setValue(thisRef: Any?, property: KProperty<*>, value: Int) { + this@AbstractIntField.int = value + } + } + + protected val access = object : IntFieldAccess { + override fun readInt(): Int { + return this@AbstractIntField.field + } + + override fun write(value: Int) { + if (!isDirty && value != this@AbstractIntField.field) { + notifyEndpoints(this@AbstractIntField) + isDirty = true + } + + this@AbstractIntField.field = value + } + } + + final override var int: Int + get() { + return getter?.invoke(access) ?: this.field + } + set(value) { + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, false) + } else if (value != this.field) { + if (!isDirty) { + notifyEndpoints(this) + isDirty = true + } + + this.field = value + } + } + } + + /** + * Type specific field, storing primitive [Int] directly, and networking it as variable length integer + */ + inner class IntField(field: Int, getter: IntFieldGetter? = null, setter: IntFieldSetter? = null) : AbstractIntField(field, getter, setter) { + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeVarInt(this.field) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val value = stream.readVarInt() + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, true) + } else { + this.field = value + } + } + } + + /** + * Type specific field, storing primitive [Int] directly, and networking it as 4 octets + */ + inner class FixedIntField(field: Int, getter: IntFieldGetter? = null, setter: IntFieldSetter? = null) : AbstractIntField(field, getter, setter) { + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeInt(this.field) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val value = stream.readInt() + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, true) + } else { + this.field = value + } + } + } + + /** + * Type specific field, storing primitive [Long] directly + */ + abstract inner class AbstractLongField(field: Long, private val getter: LongFieldGetter? = null, protected val setter: LongFieldSetter? = null) : PrimitiveField(), IMutableLongField { + private val subs = ILongSubcripable.Impl() + + override fun addListener(listener: LongConsumer): ISubscriptable.L { + return subs.addListener(listener) + } + + protected var field = field + set(value) { + if (field != value) { + field = value + subs.accept(value) + } + } + + final override val property = object : IMutableLongProperty { + override fun getValue(thisRef: Any?, property: KProperty<*>): Long { + return this@AbstractLongField.long + } + + override fun setValue(thisRef: Any?, property: KProperty<*>, value: Long) { + this@AbstractLongField.long = value + } + } + + protected val access = object : LongFieldAccess { + override fun readLong(): Long { + return this@AbstractLongField.field + } + + override fun write(value: Long) { + if (!isDirty && value != this@AbstractLongField.field) { + notifyEndpoints(this@AbstractLongField) + isDirty = true + } + + this@AbstractLongField.field = value + } + } + + final override var long: Long + get() { + return getter?.invoke(access) ?: this.field + } + set(value) { + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, false) + } else if (value != this.field) { + if (!isDirty) { + notifyEndpoints(this) + isDirty = true + } + + this.field = value + } + } + } + + /** + * Type specific field, storing primitive [Long] directly, and networking it as variable length integer + */ + inner class LongField(field: Long, getter: LongFieldGetter? = null, setter: LongFieldSetter? = null) : AbstractLongField(field, getter, setter) { + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeVarLong(this.field) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val value = stream.readVarLong() + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, true) + } else { + this.field = value + } + } + } + + /** + * Type specific field, storing primitive [Long] directly, and networking it as 8 octets + */ + inner class FixedLongField(field: Long, getter: LongFieldGetter? = null, setter: LongFieldSetter? = null) : AbstractLongField(field, getter, setter) { + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeLong(this.field) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val value = stream.readLong() + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, true) + } else { + this.field = value + } + } + } + + /** + * Type specific field, storing primitive [Boolean] directly + */ + inner class BooleanField(field: Boolean, private val getter: BooleanFieldGetter? = null, private val setter: BooleanFieldSetter? = null) : PrimitiveField(), IMutableBooleanField { + private val subs = IBooleanSubscriptable.Impl() + + override fun addListener(listener: BooleanConsumer): ISubscriptable.L { + return subs.addListener(listener) + } + + private var field = field + set(value) { + if (field != value) { + field = value + subs.accept(value) + } + } + + override val property = object : IMutableBooleanProperty { + override fun getValue(thisRef: Any?, property: KProperty<*>): Boolean { + return this@BooleanField.boolean + } + + override fun setValue(thisRef: Any?, property: KProperty<*>, value: Boolean) { + this@BooleanField.boolean = value + } + } + + private val access = object : BooleanFieldAccess { + override fun readBoolean(): Boolean { + return this@BooleanField.field + } + + override fun write(value: Boolean) { + if (!isDirty && value != this@BooleanField.field) { + notifyEndpoints(this@BooleanField) + isDirty = true + } + + this@BooleanField.field = value + } + } + + override var boolean: Boolean + get() { + return getter?.invoke(access) ?: this.field + } + set(value) { + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, false) + } else if (value != this.field) { + if (!isDirty) { + notifyEndpoints(this) + isDirty = true + } + + this.field = value + } + } + + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeBoolean(this.field) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val value = stream.readBoolean() + val setter = this.setter + + if (setter != null) { + setter.invoke(value, access, true) + } else { + this.field = value + } + } + } + + /** + * Networked value with backing getter which is constantly polled + */ + inner class ComputedField( + private val getter: () -> V, + private val codec: IStreamCodec, + observer: ((new: V) -> Unit)? = null + ) : AbstractField(), IField { + private var remote: Any? = Mark + private var clientValue: Any? = Mark + private val subs = ISubscriptable.Impl() + + init { + if (observer != null) { + subs.addListener(observer) + } + } + + override fun addListener(listener: Consumer): ISubscriptable.L { + return subs.addListener(listener) + } + + init { + observers.add(this) + } + + override fun observe(): Boolean { + check(!isRemoved) { "Field was removed" } + + val value = value + + if (!isDirty && (remote === Mark || !codec.compare(remote as V, value))) { + notifyEndpoints(this) + isDirty = true + remote = codec.copy(value) + } + + return isDirty + } + + override val value: V + get() { + val clientValue = clientValue + + if (clientValue === Mark) { + return getter.invoke() + } else { + return clientValue as V + } + } + + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + codec.write(stream, value) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val newValue = codec.read(stream) + clientValue = newValue + subs.accept(newValue) + } + } + + /** + * Networked value with backing getter which is constantly polled + * + * This class has concrete implementation for [Float] primitive + */ + inner class ComputedFloatField(private val getter: FloatSupplier, observer: FloatConsumer? = null) : AbstractField(), IFloatField { + private var remote: Float = 0f + private var isRemoteSet = false + private var clientValue: Float = 0f + private var isClientValue = false + private val subs = IFloatSubcripable.Impl() + + init { + if (observer != null) { + subs.addListener(observer) + } + } + + override fun addListener(listener: FloatConsumer): ISubscriptable.L { + return subs.addListener(listener) + } + + override val property = object : IFloatProperty { + override fun getValue(thisRef: Any?, property: KProperty<*>): Float { + return float + } + } + + init { + observers.add(this) + } + + override fun observe(): Boolean { + check(!isRemoved) { "Field was removed" } + + val value = getter.getAsFloat() + + if (!isDirty && (!isRemoteSet || remote != value)) { + notifyEndpoints(this) + isDirty = true + isRemoteSet = true + remote = value + } + + return isDirty + } + + override fun markDirty() { + check(!isRemoved) { "Field was removed" } + notifyEndpoints(this) + isDirty = true + } + + override val float: Float + get() { + if (isClientValue) { + return clientValue + } else { + return getter.getAsFloat() + } + } + + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeFloat(getter.getAsFloat()) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val newValue = stream.readFloat() + clientValue = newValue + isClientValue = true + subs.accept(newValue) + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Float { + return float + } + } + + /** + * Networked value with backing getter which is constantly polled + * + * This class has concrete implementation for [Double] primitive + */ + inner class ComputedDoubleField(private val getter: DoubleSupplier, observer: DoubleConsumer? = null) : AbstractField(), IDoubleField { + private var remote: Double = 0.0 + private var isRemoteSet = false + private var clientValue: Double = 0.0 + private var isClientValue = false + private val subs = IDoubleSubcripable.Impl() + + init { + if (observer != null) { + subs.addListener(observer) + } + } + + override fun addListener(listener: DoubleConsumer): ISubscriptable.L { + return subs.addListener(listener) + } + + override val property = object : IDoubleProperty { + override fun getValue(thisRef: Any?, property: KProperty<*>): Double { + return double + } + } + + init { + observers.add(this) + } + + override fun observe(): Boolean { + check(!isRemoved) { "Field was removed" } + + val value = getter.asDouble + + if (!isDirty && (!isRemoteSet || remote != value)) { + notifyEndpoints(this) + isDirty = true + isRemoteSet = true + remote = value + } + + return isDirty + } + + override val double: Double + get() { + if (isClientValue) { + return clientValue + } else { + return getter.asDouble + } + } + + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeDouble(getter.asDouble) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val newValue = stream.readDouble() + clientValue = newValue + isClientValue = true + subs.accept(newValue) + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Double { + return double + } + } + + /** + * Networked value with backing getter which is constantly polled + * + * This class has concrete implementation for [Int] primitive + */ + abstract inner class AbstractComputedIntField(protected val getter: IntSupplier, observer: IntConsumer? = null) : AbstractField(), IIntField { + private var remote: Int = 0 + private var isRemoteSet = false + protected var clientValue: Int = 0 + set(value) { + isClientValue = true + + if (field != value) { + field = value + subs.accept(value) + } + } + + protected var isClientValue = false + private val subs = IIntSubcripable.Impl() + + init { + if (observer != null) { + subs.addListener(observer) + } + } + + override fun addListener(listener: IntConsumer): ISubscriptable.L { + return subs.addListener(listener) + } + + final override val property = object : IIntProperty { + override fun getValue(thisRef: Any?, property: KProperty<*>): Int { + return int + } + } + + init { + observers.add(this) + } + + final override fun observe(): Boolean { + check(!isRemoved) { "Field was removed" } + + val value = getter.asInt + + if (!isDirty && (!isRemoteSet || remote != value)) { + notifyEndpoints(this) + isDirty = true + isRemoteSet = true + remote = value + } + + return isDirty + } + + final override val int: Int + get() { + if (isClientValue) { + return clientValue + } else { + return getter.asInt + } + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Int { + return int + } + } + + /** + * Networked value with backing getter which is constantly polled + * + * This class has concrete implementation for [Int] primitive, networking it as variable length integer + */ + inner class ComputedIntField(getter: IntSupplier, observer: IntConsumer = IntConsumer {}) : AbstractComputedIntField(getter, observer) { + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeSignedVarInt(getter.asInt) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + clientValue = stream.readSignedVarInt() + } + } + + /** + * Networked value with backing getter which is constantly polled + * + * This class has concrete implementation for [Int] primitive, networking it as 4 octets + */ + inner class ComputedFixedIntField(getter: IntSupplier, observer: IntConsumer = IntConsumer {}) : AbstractComputedIntField(getter, observer) { + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeInt(getter.asInt) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + clientValue = stream.readInt() + } + } + + /** + * Networked value with backing getter which is constantly polled + * + * This class has concrete implementation for [Long] primitive + */ + abstract inner class AbstractComputedLongField(protected val getter: LongSupplier, observer: LongConsumer? = null) : AbstractField(), ILongField { + private var remote: Long = 0L + private var isRemoteSet = false + protected var clientValue: Long = 0L + set(value) { + isClientValue = true + + if (field != value) { + field = value + subs.accept(value) + } + } + + protected var isClientValue = false + private val subs = ILongSubcripable.Impl() + + init { + if (observer != null) { + subs.addListener(observer) + } + } + + override fun addListener(listener: LongConsumer): ISubscriptable.L { + return subs.addListener(listener) + } + + final override val property = object : ILongProperty { + override fun getValue(thisRef: Any?, property: KProperty<*>): Long { + return long + } + } + + init { + observers.add(this) + } + + final override fun observe(): Boolean { + check(!isRemoved) { "Field was removed" } + + val value = getter.asLong + + if (!isDirty && (!isRemoteSet || remote != value)) { + notifyEndpoints(this) + isDirty = true + isRemoteSet = true + remote = value + } + + return isDirty + } + + final override val long: Long + get() { + if (isClientValue) { + return clientValue + } else { + return getter.asLong + } + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Long { + return long + } + } + + /** + * Networked value with backing getter which is constantly polled + * + * This class has concrete implementation for [Long] primitive, networking it as variable length integer + */ + inner class ComputedLongField(getter: LongSupplier, observer: LongConsumer = LongConsumer {}) : AbstractComputedLongField(getter, observer) { + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeSignedVarLong(getter.asLong) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + clientValue = stream.readSignedVarLong() + } + } + + /** + * Networked value with backing getter which is constantly polled + * + * This class has concrete implementation for [Long] primitive, networking it as 8 octets + */ + inner class ComputedFixedLongField(getter: LongSupplier, observer: LongConsumer = LongConsumer {}) : AbstractComputedLongField(getter, observer) { + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeLong(getter.asLong) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + clientValue = stream.readLong() + } + } + + /** + * Networked value with backing getter which is constantly polled + * + * This class has concrete implementation for [Boolean] primitive + */ + inner class ComputedBooleanField(private val getter: BooleanSupplier, observer: BooleanConsumer? = null) : AbstractField(), IBooleanField { + private var remote: Boolean = false + private var isRemoteSet = false + private var clientValue: Boolean = false + private var isClientValue = false + private val subs = IBooleanSubscriptable.Impl() + + init { + if (observer != null) { + subs.addListener(observer) + } + } + + override fun addListener(listener: BooleanConsumer): ISubscriptable.L { + return subs.addListener(listener) + } + + override val property = object : IBooleanProperty { + override fun getValue(thisRef: Any?, property: KProperty<*>): Boolean { + return boolean + } + } + + init { + observers.add(this) + } + + override fun observe(): Boolean { + check(!isRemoved) { "Field was removed" } + + val value = getter.asBoolean + + if (!isDirty && (!isRemoteSet || remote != value)) { + notifyEndpoints(this) + isDirty = true + isRemoteSet = true + remote = value + } + + return isDirty + } + + override val boolean: Boolean + get() { + if (isClientValue) { + return clientValue + } else { + return getter.asBoolean + } + } + + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + stream.writeBoolean(getter.asBoolean) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + val newValue = stream.readBoolean() + clientValue = newValue + isClientValue = true + subs.accept(newValue) + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Boolean { + return boolean + } + } + + /** + * Networked variable with backing field holding mutable value, which is constantly observed for changes + */ + inner class ObservedField : AbstractField, IMutableField { + private val codec: IStreamCodec + private val getter: () -> V + private val setter: (V) -> Unit + private var remote: V + private val subs = ISubscriptable.Impl() + + override fun addListener(listener: Consumer): ISubscriptable.L { + return subs.addListener(listener) + } + + override var value: V + get() = getter.invoke() + set(value) { setter.invoke(value) } + + constructor(field: KMutableProperty0, codec: IStreamCodec) : super() { + this.codec = codec + getter = field::get + setter = field::set + remote = codec.copy(value) + } + + constructor(getter: () -> V, setter: (V) -> Unit, codec: IStreamCodec) : super() { + this.codec = codec + this.getter = getter + this.setter = setter + remote = codec.copy(value) + } + + init { + observers.add(this) + } + + override fun observe(): Boolean { + check(!isRemoved) { "Field was removed" } + + val value = value + + if (!isDirty && !codec.compare(remote, value)) { + notifyEndpoints(this) + isDirty = true + remote = codec.copy(value) + } + + return isDirty + } + + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + codec.write(stream, value) + isDirty = false + } + + override fun read(stream: DataInputStream) { + check(!isRemoved) { "Field was removed" } + this.value = codec.read(stream) + subs.accept(this.value) + } + } + + inner class Set( + private val codec: IStreamCodec, + private val backingSet: MutableSet, + private val callback: ((changes: Collection>) -> Unit)? = null, + ) : AbstractField>(), ISubscriptable> by ISubscriptable.empty() { + private var isRemote = false + + private fun pushBacklog(element: E, action: (DataOutputStream) -> Unit) { + check(!isRemote) { "Field marked as remote" } + + val pair = element to action + + forEachEndpoint { + val list = it.getSetBacklog(this) + val iterator = list.listIterator() + + for (value in iterator) { + if (value.first == element) { + iterator.remove() + } + } + + list.addLast(pair) + } + } + + override fun observe(): Boolean { + return false + } + + override fun remove() { + if (!isRemoved) { + forEachEndpoint { it.removeSetBacklog(this) } + } + + super.remove() + } + + override fun markDirty() { + check(!isRemoved) { "Field was removed" } + + if (isRemote || endpoints.isEmpty()) + return + + isDirty = true + + val endpoints = LinkedList Unit>>>() + + forEachEndpoint { + endpoints.add(it.getSetBacklog(this)) + it.addDirtyField(this) + } + + endpoints.forEach { + it.clear() + it.add(null to ClearBacklogEntry) + } + + for (value in backingSet) { + val valueCopy = codec.copy(value) + val pair: Pair Unit> = valueCopy to { it.write(ChangesetAction.ADD.ordinal + 1); codec.write(it, valueCopy) } + + endpoints.forEach { + it.add(pair) + } + } + } + + override fun markDirty(endpoint: Endpoint) { + super.markDirty(endpoint) + + endpoint.getSetBacklog(this).let { + it.clear() + it.add(null to ClearBacklogEntry) + + for (value in backingSet) { + val valueCopy = codec.copy(value) + it.add(valueCopy to { it.write(ChangesetAction.ADD.ordinal + 1); codec.write(it, valueCopy) }) + } + } + } + + override val value: MutableSet = object : MutableSet { + override fun add(element: E): Boolean { + if (backingSet.add(element)) { + if (!isRemote) { + markDirty() + + val copy = codec.copy(element) + + pushBacklog(element) { + it.write(ChangesetAction.ADD.ordinal + 1) + codec.write(it, copy) + } + } + + return true + } + + return false + } + + override fun addAll(elements: Collection): Boolean { + var any = false + elements.forEach { any = add(it) || any } + return any + } + + override fun clear() { + if (backingSet.isNotEmpty()) { + backingSet.clear() + + if (!isRemote) { + markDirty() + + forEachEndpoint { + it.getSetBacklog(this@Set).let { + it.clear() + it.add(null to ClearBacklogEntry) + } + } + } + } + } + + override fun iterator(): MutableIterator { + return object : MutableIterator { + private val parent = backingSet.iterator() + private var lastElement: Any? = Mark + + override fun hasNext(): Boolean { + return parent.hasNext() + } + + override fun next(): E { + return parent.next().also { lastElement = it } + } + + override fun remove() { + parent.remove() + val lastElement = lastElement + + if (lastElement !== Mark) { + this.lastElement = Mark + + if (!isRemote) { + markDirty() + + @Suppress("unchecked_cast") + pushBacklog(lastElement as E) { + it.write(ChangesetAction.REMOVE.ordinal + 1) + codec.write(it, lastElement as E) + } + } + } + } + } + } + + override fun remove(element: E): Boolean { + if (backingSet.remove(element)) { + if (!isRemote) { + markDirty() + + val copy = codec.copy(element) + + pushBacklog(element) { + it.write(ChangesetAction.REMOVE.ordinal + 1) + codec.write(it, copy) + } + } + + return true + } + + return false + } + + override fun removeAll(elements: Collection): Boolean { + var any = false + elements.forEach { any = remove(it) || any } + return any + } + + override fun retainAll(elements: Collection): Boolean { + var any = false + + val iterator = iterator() + + for (value in iterator) { + if (value !in elements) { + any = true + iterator.remove() + } + } + + return any + } + + override val size: Int + get() = backingSet.size + + override fun contains(element: E): Boolean { + return element in backingSet + } + + override fun containsAll(elements: Collection): Boolean { + return backingSet.containsAll(elements) + } + + override fun isEmpty(): Boolean { + return backingSet.isEmpty() + } + } + + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + val list = endpoint.getSetBacklog(this) + + for (value in list) { + value.second.invoke(stream) + } + + stream.write(0) + list.clear() + isDirty = false + } + + override fun read(stream: DataInputStream) { + if (!isRemote) { + isRemote = true + forEachEndpoint { it.removeSetBacklog(this) } + } + + isDirty = false + + var action = stream.read() + val changeset = LinkedList>() + + while (action != 0) { + if ((action - 1) !in ChangesetActionList.indices) { + throw IllegalArgumentException("Unknown changeset action with index ${action - 1}") + } + + when (ChangesetActionList[action - 1]) { + ChangesetAction.CLEAR -> { + changeset.add(SetChangeset(ChangesetAction.CLEAR, null)) + backingSet.clear() + } + + ChangesetAction.ADD -> { + val read = codec.read(stream) + changeset.add(SetChangeset(ChangesetAction.ADD, read)) + backingSet.add(read) + } + + ChangesetAction.REMOVE -> { + val read = codec.read(stream) + changeset.add(SetChangeset(ChangesetAction.REMOVE, read)) + backingSet.remove(read) + } + } + + action = stream.read() + } + + callback?.invoke(changeset) + } + } + + inner class Map( + private val keyCodec: IStreamCodec, + private val valueCodec: IStreamCodec, + private val backingMap: MutableMap, + private val callback: ((changes: Collection>) -> Unit)? = null, + ) : AbstractField>(), IField>, ISubscriptable> by ISubscriptable.empty() { + private var sentAllValues = false + private var isRemote = false + + private fun pushBacklog(key: Any?, value: (DataOutputStream) -> Unit) { + val pair = key to value + + forEachEndpoint { + val list = it.getMapBacklog(this) + val iterator = list.listIterator() + + for (e in iterator) { + if (e.first == key) { + iterator.remove() + } + } + + list.addLast(pair) + } + } + + override fun observe(): Boolean { + return false + } + + override fun markDirty() { + check(!isRemoved) { "Field was removed" } + + if (isRemote || endpoints.isEmpty()) + return + + isDirty = true + val backlogs = LinkedList Unit>>>() + + forEachEndpoint { + it.addDirtyField(this) + val value = it.getMapBacklog(this) + backlogs.add(value) + value.clear() + value.add(null to ClearBacklogEntry) + } + + for ((key, value) in backingMap) { + val valueCopy = valueCodec.copy(value) + + val action = key to { it: DataOutputStream -> + it.write(ChangesetAction.ADD.ordinal + 1) + keyCodec.write(it, key) + valueCodec.write(it, valueCopy) + } + + for (backlog in backlogs) { + backlog.add(action) + } + } + } + + override fun markDirty(endpoint: Endpoint) { + check(!isRemoved) { "Field was removed" } + + if (isRemote) + return + + val backlog = endpoint.getMapBacklog(this) + + backlog.clear() + backlog.add(null to ClearBacklogEntry) + + for ((key, value) in backingMap) { + val valueCopy = valueCodec.copy(value) + + backlog.add(key to { + it.write(ChangesetAction.ADD.ordinal + 1) + keyCodec.write(it, key) + valueCodec.write(it, valueCopy) + }) + } + } + + private fun lmarkDirty() { + if (!isDirty) { + notifyEndpoints(this@Map) + isDirty = true + } + } + + override val value: MutableMap = object : ProxiedMap(backingMap) { + override fun onClear() { + if (isRemote || endpoints.isEmpty()) + return + + forEachEndpoint { endpoint -> + endpoint.getMapBacklog(this@Map).let { + it.clear() + it.add(null to ClearBacklogEntry) + } + } + + lmarkDirty() + this@FieldSynchronizer.isDirty = true + } + + override fun onValueAdded(key: K, value: V) { + if (isRemote || endpoints.isEmpty()) + return + + val keyCopy = keyCodec.copy(key) + val valueCopy = valueCodec.copy(value) + + pushBacklog(key) { + it.write(ChangesetAction.ADD.ordinal + 1) + keyCodec.write(it, keyCopy) + valueCodec.write(it, valueCopy) + } + + lmarkDirty() + } + + override fun onValueRemoved(key: K, value: V) { + if (isRemote || endpoints.isEmpty()) + return + + val keyCopy = keyCodec.copy(key) + + pushBacklog(key) { + it.write(ChangesetAction.REMOVE.ordinal + 1) + keyCodec.write(it, keyCopy) + } + + lmarkDirty() + } + } + + override fun write(stream: DataOutputStream, endpoint: Endpoint) { + sentAllValues = false + isDirty = false + + val iterator = endpoint.getMapBacklog(this).listIterator() + + for (entry in iterator) { + entry.second.invoke(stream) + iterator.remove() + } + + stream.write(0) + } + + override fun read(stream: DataInputStream) { + if (!isRemote) { + isRemote = true + forEachEndpoint { it.removeMapBacklog(this) } + } + + isDirty = false + + val changeset = LinkedList>() + var readAction = stream.read() - 1 + + while (readAction != -1) { + if (readAction >= ChangesetActionList.size) { + throw IndexOutOfBoundsException("Unknown map action with ID $readAction") + } + + when (ChangesetActionList[readAction]) { + ChangesetAction.CLEAR -> { + backingMap.clear() + changeset.add(ClearMapChangeset) + } + + ChangesetAction.ADD -> { + val key = keyCodec.read(stream) + val value = valueCodec.read(stream) + backingMap[key] = value + changeset.add(MapChangeset(ChangesetAction.ADD, key, value)) + } + + ChangesetAction.REMOVE -> { + val key = keyCodec.read(stream) + backingMap.remove(key) + changeset.add(MapChangeset(ChangesetAction.REMOVE, key, null)) + } + } + + readAction = stream.read() - 1 + } + + if (changeset.size != 0) { + callback?.invoke(changeset) + } + } + } + + /** + * marks all fields dirty, invalidates mappings for each endpoint + */ + fun invalidate() { + for (field in fields) { + field?.markDirty() + } + } + + /** + * Observe changes of all fields with backing computation lambda + */ + fun observe(): Boolean { + var changes = false + + if (observers.isNotEmpty()) { + for (field in observers) { + changes = field.observe() || changes + } + } + + return changes + } + + /** + * [defaultEndpoint]#collectNetworkPayload + */ + fun collectNetworkPayload(): ByteArrayOutputStream? { + check(!defaultEndpoint.unused) { "Default endpoint is not used" } + observe() + val values = defaultEndpoint.collectNetworkPayload() + markClean() + return values + } + + fun read(stream: InputStream): Int { + var fieldId = stream.readVarInt() + var i = 0 + val dataStream = DataInputStream(stream) + + while (fieldId != 0) { + val field = fields.getOrNull(fieldId - 1) ?: throw IllegalArgumentException("Unknown field ID ${fieldId - 1}") + field.read(dataStream) + fieldId = stream.readVarInt() + i++ + } + + return i + } + + private object Mark + + companion object { + private val ClearBacklogEntry = { stream: DataOutputStream -> stream.write(ChangesetAction.CLEAR.ordinal + 1) } + private val ChangesetActionList = ChangesetAction.values() + private val ClearMapChangeset = MapChangeset(ChangesetAction.CLEAR, null, null) + } +} diff --git a/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/Fields.kt b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/Fields.kt new file mode 100644 index 0000000..b7db5d2 --- /dev/null +++ b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/Fields.kt @@ -0,0 +1,173 @@ +package ru.dbotthepony.kommons.networking + +import ru.dbotthepony.kommons.event.IBooleanSubscriptable +import ru.dbotthepony.kommons.event.IDoubleSubcripable +import ru.dbotthepony.kommons.event.IFloatSubcripable +import ru.dbotthepony.kommons.event.IIntSubcripable +import ru.dbotthepony.kommons.event.ILongSubcripable +import ru.dbotthepony.kommons.event.ISubscriptable +import ru.dbotthepony.kommons.util.FloatSupplier +import java.io.DataInputStream +import java.io.DataOutputStream +import java.util.function.BooleanSupplier +import java.util.function.DoubleSupplier +import java.util.function.IntSupplier +import java.util.function.LongSupplier +import java.util.function.Supplier +import kotlin.properties.ReadOnlyProperty +import kotlin.reflect.KProperty + +sealed interface IField : ReadOnlyProperty, Supplier, () -> V, ISubscriptable { + fun observe(): Boolean + fun markDirty() + fun markDirty(endpoint: FieldSynchronizer.Endpoint) + val value: V + val isRemoved: Boolean + + fun remove() + + fun write(stream: DataOutputStream, endpoint: FieldSynchronizer.Endpoint) + fun read(stream: DataInputStream) + + override fun getValue(thisRef: Any?, property: KProperty<*>): V { + return this.value + } + + override fun get(): V { + return value + } + + override fun invoke(): V { + return value + } +} + +interface IFloatProperty { + operator fun getValue(thisRef: Any?, property: KProperty<*>): Float +} + +sealed interface IFloatField : IField, FloatSupplier, IFloatSubcripable { + val float: Float + val property: IFloatProperty + + override val value: Float + get() = float + + @Deprecated("Use type specific Supplier interface") + override fun get(): Float { + return float + } + + override fun getAsFloat(): Float { + return float + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Float { + return float + } +} + +interface IDoubleProperty { + operator fun getValue(thisRef: Any?, property: KProperty<*>): Double +} + +sealed interface IDoubleField : IField, DoubleSupplier, IDoubleSubcripable { + val double: Double + val property: IDoubleProperty + + @Deprecated("Use type specific Supplier interface") + override fun get(): Double { + return double + } + + override val value: Double + get() = double + + override fun getAsDouble(): Double { + return double + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Double { + return double + } +} + +interface IIntProperty { + operator fun getValue(thisRef: Any?, property: KProperty<*>): Int +} + +sealed interface IIntField : IField, IntSupplier, IIntSubcripable { + val int: Int + val property: IIntProperty + + @Deprecated("Use type specific Supplier interface") + override fun get(): Int { + return int + } + + override val value: Int + get() = int + + override fun getAsInt(): Int { + return int + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Int { + return int + } +} + +interface ILongProperty { + operator fun getValue(thisRef: Any?, property: KProperty<*>): Long +} + +sealed interface ILongField : IField, LongSupplier, ILongSubcripable { + val long: Long + val property: ILongProperty + + @Deprecated("Use type specific Supplier interface") + override fun get(): Long { + return long + } + + override val value: Long + get() = long + + override fun getAsLong(): Long { + return long + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Long { + return long + } +} + +interface IBooleanProperty { + operator fun getValue(thisRef: Any?, property: KProperty<*>): Boolean +} + +sealed interface IBooleanField : IField, BooleanSupplier, IBooleanSubscriptable { + val boolean: Boolean + val property: IBooleanProperty + + @Deprecated("Use type specific Supplier interface") + override fun get(): Boolean { + return boolean + } + + override val value: Boolean + get() = boolean + + override fun getAsBoolean(): Boolean { + return boolean + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Boolean { + return boolean + } +} diff --git a/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/MapChangeset.kt b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/MapChangeset.kt new file mode 100644 index 0000000..acd2b2a --- /dev/null +++ b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/MapChangeset.kt @@ -0,0 +1,23 @@ +package ru.dbotthepony.kommons.networking + +data class MapChangeset( + val action: ChangesetAction, + val key: K?, + val value: V? +) { + inline fun map(add: (K, V) -> Unit, remove: (K) -> Unit) { + when (action) { + ChangesetAction.ADD -> add.invoke(key!!, value!!) + ChangesetAction.REMOVE -> remove.invoke(key!!) + else -> {} + } + } + + inline fun map(add: (K, V) -> Unit, remove: (K) -> Unit, clear: () -> Unit) { + when (action) { + ChangesetAction.CLEAR -> clear.invoke() + ChangesetAction.ADD -> add.invoke(key!!, value!!) + ChangesetAction.REMOVE -> remove.invoke(key!!) + } + } +} diff --git a/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/MutableFields.kt b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/MutableFields.kt new file mode 100644 index 0000000..6bb66a4 --- /dev/null +++ b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/MutableFields.kt @@ -0,0 +1,165 @@ +package ru.dbotthepony.kommons.networking + +import ru.dbotthepony.kommons.util.FloatConsumer +import ru.dbotthepony.kommons.core.SentientGetterSetter +import ru.dbotthepony.kommons.util.BooleanConsumer +import java.util.function.DoubleConsumer +import java.util.function.IntConsumer +import java.util.function.LongConsumer +import kotlin.reflect.KProperty + +sealed interface IMutableField : IField, SentientGetterSetter { + override fun getValue(thisRef: Any?, property: KProperty<*>): V { + return this.value + } + + override var value: V + + override fun accept(t: V) { + value = t + } + + override fun invoke(): V { + return this.value + } +} + +interface IMutableFloatProperty : IFloatProperty { + operator fun setValue(thisRef: Any?, property: KProperty<*>, value: Float) +} + +sealed interface IMutableFloatField : IMutableField, IFloatField, FloatConsumer { + override var float: Float + override val property: IMutableFloatProperty + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.float")) + override var value: Float + get() = float + set(value) { float = value } + + override fun accept(t: Float) { + float = t + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Float { + return float + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun setValue(thisRef: Any?, property: KProperty<*>, value: Float) { + float = value + } +} + +interface IMutableDoubleProperty : IDoubleProperty { + operator fun setValue(thisRef: Any?, property: KProperty<*>, value: Double) +} + +sealed interface IMutableDoubleField : IMutableField, IDoubleField, DoubleConsumer { + override var double: Double + override val property: IMutableDoubleProperty + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.double")) + override var value: Double + get() = double + set(value) { double = value } + + override fun accept(t: Double) { + double = t + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Double { + return double + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun setValue(thisRef: Any?, property: KProperty<*>, value: Double) { + double = value + } +} + +interface IMutableIntProperty : IIntProperty { + operator fun setValue(thisRef: Any?, property: KProperty<*>, value: Int) +} + +sealed interface IMutableIntField : IMutableField, IIntField, IntConsumer { + override var int: Int + override val property: IMutableIntProperty + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.int")) + override var value: Int + get() = int + set(value) { int = value } + + override fun accept(t: Int) { + int = t + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Int { + return int + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun setValue(thisRef: Any?, property: KProperty<*>, value: Int) { + int = value + } +} + +interface IMutableLongProperty : ILongProperty { + operator fun setValue(thisRef: Any?, property: KProperty<*>, value: Long) +} + +sealed interface IMutableLongField : IMutableField, ILongField, LongConsumer { + override var long: Long + override val property: IMutableLongProperty + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.long")) + override var value: Long + get() = long + set(value) { long = value } + + override fun accept(t: Long) { + long = t + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Long { + return long + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun setValue(thisRef: Any?, property: KProperty<*>, value: Long) { + long = value + } +} + +interface IMutableBooleanProperty : IBooleanProperty { + operator fun setValue(thisRef: Any?, property: KProperty<*>, value: Boolean) +} + +sealed interface IMutableBooleanField : IMutableField, IBooleanField, BooleanConsumer { + override var boolean: Boolean + override val property: IMutableBooleanProperty + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.boolean")) + override var value: Boolean + get() = boolean + set(value) { boolean = value } + + override fun accept(t: Boolean) { + boolean = t + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun getValue(thisRef: Any?, property: KProperty<*>): Boolean { + return boolean + } + + @Deprecated("Use type specific property", replaceWith = ReplaceWith("this.property")) + override fun setValue(thisRef: Any?, property: KProperty<*>, value: Boolean) { + boolean = value + } +} diff --git a/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/SetChangeset.kt b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/SetChangeset.kt new file mode 100644 index 0000000..1bb0d35 --- /dev/null +++ b/networking/src/main/kotlin/ru/dbotthepony/kommons/networking/SetChangeset.kt @@ -0,0 +1,22 @@ +package ru.dbotthepony.kommons.networking + +data class SetChangeset( + val action: ChangesetAction, + val value: V? +) { + inline fun map(add: (V) -> Unit, remove: (V) -> Unit) { + when (action) { + ChangesetAction.ADD -> add.invoke(value!!) + ChangesetAction.REMOVE -> remove.invoke(value!!) + else -> {} + } + } + + inline fun map(add: (V) -> Unit, remove: (V) -> Unit, clear: () -> Unit) { + when (action) { + ChangesetAction.CLEAR -> clear.invoke() + ChangesetAction.ADD -> add.invoke(value!!) + ChangesetAction.REMOVE -> remove.invoke(value!!) + } + } +} diff --git a/settings.gradle.kts b/settings.gradle.kts new file mode 100644 index 0000000..e18e89d --- /dev/null +++ b/settings.gradle.kts @@ -0,0 +1,14 @@ + +plugins { + //kotlin("jvm") version "1.9.21" + id("org.gradle.toolchains.foojay-resolver-convention") version "0.5.0" +} + +rootProject.name = "kommons" +include("core") +include("networking") +include("io") +include("math") +include("io-math") +include("collect") +include("guava")