InstanceTokenizer

object InstanceTokenizer

Object that returns unique strings for any Kotlin/JVM instances, and then allows the original instances to be accessed given the token strings.

Uses WeakReferences, so should not cause memory leaks on its own.

Combined with TokenizingJson in ScriptingProtocol, allows scripts to handle unserializable objects, and use them in property/key/index assignments and function calls.

Functions

clean

fun clean()

Remove all tokens and WeakReferences whose instances have already been garbage-collected.

equals

open operator fun equals(other: Any?): Boolean

getReal

fun getReal(token: Any?): Any?

Detokenize a token string into the real Kotlin/JVM instance it represents.

getToken

fun getToken(obj: Any?): String

hashCode

open fun hashCode(): Int

isToken

private fun isToken(value: Any?): Boolean

tokenFromInstance

private fun tokenFromInstance(value: Any?): String

Generate a distinctive token string to represent a Kotlin/JVM object.

toString

open fun toString(): String

tryClean

fun tryClean()

Properties

forceCleanChance

private const val forceCleanChance: Double = 0.001

forceCleanThreshold

private const val forceCleanThreshold: Int

instancesByTokens

private val instancesByTokens: MutableMap<String, WeakReference<Any>>

Map of currently known token strings to WeakReferences of the Kotlin/JVM instances they represent. Used for basic functionality of tracking tokens and transforming them back into arbitrary instances.

lastTokenCountLog

private var lastTokenCountLog: Int = 0

tokenCountLogBase

private const val tokenCountLogBase: Float = 1.3f

tokenMaxLength

private const val tokenMaxLength: Int = 100

Length to clip generated token strings to. Here in case token string generation uses the instance's .toString(), which it currently does.

tokenPrefix

private val tokenPrefix: String

Prefix that all generated token strings should start with.

tokenReuse

private const val tokenReuse: Boolean = true

tokensByInstances

private val tokensByInstances: WeakIdentityMap<Any?, String>

Sources

jvm source