Facilitates state management with concurrency primitives and thread-safe collections. Includes `Atomic` classes, `Lock`, `ThreadLocal`, `Synchronizable`, and a unique `ThreadRef` for thread ID handling.
Stately is a state utility library to facilitate state management in Kotlin Multiplatform. It was originally written to facilitate development with the strict Kotlin/Native memory model. As of Kotlin 1.7.20, the strict model is deprecated, and the releveant modules of Stately have also been deprecated but are still published and available.
Stately currently provides concurrencly primitives and concurrent collections.
stately-concurrency includes some concurrency support classes. These include a set of Atomicxxx classes, a Lock, a ThreadLocal container, a Synchronizable type, and a class ThreadRef that allows you to hold a thread id.
Much of the functionality of this module is similar to atomic-fu. They differ in some ways, so while they both cover much of the same ground, Stately's version still has some use.
ThreadRef is unique to Stately. It allows you to capture a reference to the id of the thread in which it was created, and ask if the current thread is the same. Just FYI, it does not keep a reference to the actual thread. Just an id. Usage looks like this:
fun useRef(){
val threadRef = ThreadRef()
threadRef.same() // <- true
backgroundThread {
threadRef.same() // <- false
}
}
The Synchronizable type allows us to use the JVM's synchronized but in common, and with Kotlin/Native which doesn't natively support it.
class MyMutableData(private var count: Int = 0) : Synchronizable() {
fun add() {
synchronize { count++ }
}
val myCount: Int
get() = synchronize { count }
}
Your type should extend Synchronizable, which on the JVM is typealiased to Any. Then you can use synchronize as in the example above.
commonMain {
dependencies {
implementation("co.touchlab:stately-concurrency:2.0.0")
}
}
A set of relatively simple mutable collections that are thread safe.
val list = ConcurrentMutableList<Int>()
val list.add(42)
commonMain {
dependencies {
implementation("co.touchlab:stately-concurrent-collections:2.0.0")
}
}
Subscribe!
We build solutions that get teams started smoothly with Kotlin Multiplatform Mobile and ensure their success in production. Join our community to learn how your peers are adopting KMM. Sign up here!
Ping me on twitter @kpgalligan if you don't get a timely reply! -Kevin
Copyright 2024 Touchlab, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance the License.
You may obtain a copy of the License at
http:
Unless applicable law agreed to writing, software
distributed under the License distributed an BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express implied.
See the License the specific language governing permissions
limitations under the License.
Surfaced from shared tags and platforms — no rankings paid for.