architecture/com.splendo.kaluga.architecture.observable/ReadWritePropertyDefaultSubject

ReadWritePropertyDefaultSubject

class ReadWritePropertyDefaultSubject<R : T?, T>(defaultValue: R, readWriteProperty: ReadWriteProperty<Any?, T?>, initialValue: ObservableOptional.Value<T?> = Value( run { val v by readWriteProperty v }, ), coroutineScope: CoroutineScope?, context: CoroutineContext? = coroutineScope?.coroutineContext, observation: ObservationDefault<R, T?> = ObservationDefault(defaultValue, initialValue)) : BaseDefaultSubject<R, T> , SuspendableSetter<T?>

A BaseDefaultSubject that matches its value to a ReadWriteProperty. When the ReadWriteProperty updates, changes to the property are not immediately delegated back to the subject. Use a Flow based subject if synchronized values are required

Parameters

the type of value to expect.

the type of result to expect. Must be a subclass of T

defaultValue

The default R to return if the value of the ReadWriteProperty is null.

readWriteProperty

The ReadWriteProperty to track.

initialValue

The initial value of T. Defaults to the current value of the ReadWriteProperty.

coroutineScope

The CoroutineScope on which to emit changes to the ReadWriteProperty

context

The CoroutineContext in which to emit changes to the ReadWriteProperty

observation

The ObservationInitialized to handle observation.

Constructors

ReadWritePropertyDefaultSubject

constructor(defaultValue: R, readWriteProperty: ReadWriteProperty<Any?, T?>, initialValue: ObservableOptional.Value<T?> = Value( run { val v by readWriteProperty v }, ), coroutineScope: CoroutineScope?, context: CoroutineContext? = coroutineScope?.coroutineContext, observation: ObservationDefault<R, T?> = ObservationDefault(defaultValue, initialValue))

Properties

current

open override val current: R

The current value of R

currentOrNull

open override val currentOrNull: T?

The current value T or null being observed

defaultValue

open override val defaultValue: ObservableOptional.Value<R>

The default Value of R. Can be used in case Nothing is Initial.initialValue

initialValue

open override val initialValue: ObservableOptional.Value<T?>

The initial ObservableOptional value of T.

liveDataObserver

val <R : T, T, OO : ObservableOptional<R>> BasicSubject<R, T, OO>.liveDataObserver: Observer<T>

The Observer that observes the observable value.

stateFlow

open override val stateFlow: MutableStateFlow<R>

StateFlow that expresses the content from the observable.

valueDelegate

open override val valueDelegate: ReadWriteProperty<Any?, R>

A ReadOnlyProperty of T

Functions

bind

expect override fun bind(coroutineScope: CoroutineScope, context: CoroutineContext)

Bind changes in value to a CoroutineScope in a CoroutineContext

bind

fun <R : T, T, OO : ObservableOptional<R>> BasicSubject<R, T, OO>.bind(coroutineScope: CoroutineScope)

Convenience method for BasicSubject that calls BasicSubject.bind using the CoroutineContext of the provided CoroutineScope

getValue

open operator override fun getValue(thisRef: Any?, property: KProperty<*>): ObservableOptional.Value<R>

observe

open override fun observe(onNext: (R?) -> Unit): Disposable

Creates an observation that calls onNext each time a new value is observed until the resulting Disposable is disposed

observeInitialized

open override fun observeInitialized(onNext: (R) -> Unit): Disposable

observeNotNullOnLifecycle

fun <T> WithState<T?>.observeNotNullOnLifecycle(lifecycleOwner: LifecycleOwner, filter: suspend (T) -> Boolean = { true }, onNext: (T) -> Unit): Job

Observes WithState of a nullable value on the lifecycle of a LifecycleOwner

observeOnLifecycle

fun <T> WithState<T>.observeOnLifecycle(lifecycleOwner: LifecycleOwner, filter: suspend (T) -> Boolean = { true }, onNext: (T) -> Unit): Job

Observes WithState on the lifecycle of a LifecycleOwner

fun <T, R> WithState<T>.observeOnLifecycle(lifecycleOwner: LifecycleOwner, filter: suspend (T) -> Boolean = { true }, transform: suspend (T) -> R, onNext: (R) -> Unit): Job

Observes WithState on the lifecycle of a LifecycleOwner by transforming the observed value.

post

open override fun post(newValue: T?)

Updates the value of this Postable

set

open suspend override fun set(newValue: T?)

Updates the value of this Postable in a suspended manner.

toDefaultObservable

fun <R : T, T> ReadOnlyProperty<Any?, T?>.toDefaultObservable(defaultValue: R): ReadOnlyPropertyDefaultObservable<R, T?>

Converts a ReadOnlyProperty into a ReadOnlyPropertyDefaultObservable

toInitializedObservable

fun <T> ReadOnlyProperty<Any?, T>.toInitializedObservable(): ReadOnlyPropertyInitializedObservable<T>

Converts a ReadOnlyProperty into a ReadOnlyPropertyInitializedObservable