Package dev.fritz2.binding

Types

EmittingHandler

class EmittingHandler<A, E>(collectWithChannel: (Flow<A>, FlowCollector<E>, Job) -> Unit, flow: MutableSharedFlow<E>) : Handler<A> , Flow<E>

An EmittingHandler is a special Handler that constitutes a new Flow by itself.

ErrorHandler

typealias ErrorHandler<T> = (Throwable, T) -> T

Defines a type for handling errors in updates

Handler

interface Handler<A>

Base-interface of the different types of handlers

Patch

sealed class Patch<out T>

A Patch describes the changes made to a List.

QueuedUpdate

class QueuedUpdate<T>(update: Update<T>, errorHandler: (Throwable, T) -> T)

Type of elements in the update-queue of a Store

RootStore

open class RootStore<T>(initialData: T, id: String) : Store<T>

A Store can be initialized with a given value.

SimpleHandler

class SimpleHandler<A>(collect: (Flow<A>, Job) -> Unit) : Handler<A>

Defines, how to handle actions in your Store.

Store

interface Store<T> : WithJob

The Store is the main type for all data binding activities.

SubStore

class SubStore<P, T>(parent: Store<P>, lens: Lens<P, T>) : Store<T>

A Store that is derived from your RootStore or another SubStore that represents a part of the data-model of it's parent.

Update

typealias Update<T> = suspend (T) -> T

Defines a type for transforming one value into the next

Functions

inspect

fun <T> Store<T>.inspect(data: T): RootInspector<T>

mountSimple

inline fun <T> mountSimple(parentJob: Job, upstream: Flow<T>, crossinline collect: (T) -> Unit)

collects the values of a given Flow one by one.

storeOf

fun <T> storeOf(initialData: T, id: String = Id.next()): RootStore<T>

convenience method to create a simple RootStore without any handlers, etc.

sub

fun <T> Store<List<T>>.sub(index: Int): SubStore<List<T>, T>

creates a SubStore using a RootStore as parent using the index in the list (do not use this, if you want to manipulate the list itself (add or move elements, filter, etc.).

fun <T, I> Store<List<T>>.sub(element: T, id: IdProvider<T, I>): SubStore<List<T>, T>

creates a SubStore using a RootStore as parent using a given IdProvider.

syncBy

inline fun <T, R> Store<T>.syncBy(handler: Handler<R>, crossinline mapper: suspend (T) -> R)

calls a handler on each new value of the Store

syncWith

fun <T, I> Store<List<T>>.syncWith(socket: Socket, resource: Resource<T, I>)

watch

fun <T> Store<T>.watch(scope: CoroutineScope = MainScope()): Store<T>

If a Store's data-Flow is never mounted, use this method to start the updating of derived values.

fun <T> Flow<T>.watch(scope: CoroutineScope = MainScope())

If a data-Flow is never mounted, use this method to start the updating of derived values.