core/dev.fritz2.routing/MapRouter

MapRouter

open class MapRouter(defaultRoute: Map<String, String> = emptyMap(), job: Job) : Router<Map<String, String>>

Represents the current Route as Map of Strings.

Parameters

defaultRoute

default Route to start with.

job

Job to be used by the Router

Constructors

MapRouter

constructor(defaultRoute: Map<String, String> = emptyMap(), job: Job)

Properties

current

open override val current: Map<String, String>

represents the current value of the Store

data

open override val data: Flow<Map<String, String>>

the Flow representing the current value of the Store. Use this to bind it to ui-elements or derive calculated values by using map for example.

open override val id: String

id of this Store. ids of depending Stores are concatenated and separated by a dot.

job

open override val job: Job

navTo

open val navTo: SimpleHandler<Map<String, String>>

Navigates to the new given route provided as T.

path

open override val path: String

Path of this Store derived from the underlying model. Paths of depending Stores are concatenated and separated by a dot.

update

open override val update: SimpleHandler<Map<String, String>>

a simple SimpleHandler that just takes the given action-value as the new value for the Store.

Functions

enqueue

open suspend override fun enqueue(update: Update<Map<String, String>>)

abstract method defining, how this Store handles an Update

errorHandler

open fun errorHandler(cause: Throwable)

Default error handler printing the error to console.

handle

open fun handle(execute: suspend (Map<String, String>) -> Map<String, String>): SimpleHandler<Unit>

Factory method to create a SimpleHandler that does not take an Action

open fun <A> handle(execute: suspend (Map<String, String>, A) -> Map<String, String>): SimpleHandler<A>

Factory method to create a SimpleHandler mapping the actual value of the Store and a given Action to a new value.

handleAndEmit

open fun <E> handleAndEmit(execute: suspend FlowCollector<E>.(Map<String, String>) -> Map<String, String>): EmittingHandler<Unit, E>

factory method to create an EmittingHandler that does not take an action in it's execute-lambda.

open fun <A, E> handleAndEmit(execute: suspend FlowCollector<E>.(Map<String, String>, A) -> Map<String, String>): EmittingHandler<A, E>

Factory method to create a EmittingHandler taking an action-value and the current store value to derive the new value. An EmittingHandler is a Flow by itself and can therefore be connected to other SimpleHandlers even in other Stores.

history

fun <D> Store<D>.history(capacity: Int = 0, initialEntries: List<D> = emptyList(), job: Job = this.job, synced: Boolean = true): History<D>

factory-method to create a History synced with the given Store, so that each update is automatically stored in history.

map

open fun <X> map(lens: Lens<Map<String, String>, X>): Store<X>

Creates a new Store that contains data derived by a given Lens.

map

fun <P, T> Store<P?>.map(lens: Lens<P & Any, T>): Store<T>

on a Store of nullable data this creates a Store with a nullable parent and non-nullable value. It can be called using a Lens on a non-nullable parent (that can be created by using the @Lenses-annotation), but you have to ensure, that the resulting Store is never used, when it's parent's value is null. Otherwise, a NullPointerException is thrown.

mapByElement

fun <D, I> Store<List<D>>.mapByElement(element: D, idProvider: IdProvider<D, I>): Store<D>

Creates a new Store containing the element for the given element and idProvider from the original Store's List.

mapByIndex

fun <D> Store<List<D>>.mapByIndex(index: Int): Store<D>

Creates a new Store containing the element for the given index from the original Store's List

mapByKey

open fun mapByKey(key: String): Store<String>

Creates a new Store containing the corresponding value for the given key.

mapByKey

fun <K, V> Store<Map<K, V>>.mapByKey(key: K): Store<V>

Creates a new Store containing the corresponding value for the given key from the original Store's Map.

mapNull

fun <T> Store<T?>.mapNull(default: T): Store<T>

Creates a new Store from a nullable parent store that either contains the original value or a given default value if the original value was null.

mapNullable

fun <T> Store<T>.mapNullable(placeholder: T): Store<T?>

Creates a new Store from a non-nullable parent store that either contains the original value or null if its value matches the given placeholder.

messages

fun <M : ValidationMessage> Store<*>.messages(): Flow<List<M>>?

Finds all exactly corresponding ValidationMessages to this Store, which means all messages, which have exactly the same path as the Store.

fun <M : ValidationMessage> Store<*>.messages(filterPredicate: (M) -> Boolean): Flow<List<M>>?

Finds all corresponding ValidationMessages to this Store which satisfy the filterPredicate-expression.

messagesOfSubModel

fun <M : ValidationMessage> Store<*>.messagesOfSubModel(): Flow<List<M>>?

Finds all corresponding ValidationMessages to this Store, which means all messages, that fit exactly with their path or which are sub-elements of this Stores data model.

select

open fun select(key: String): Flow<Pair<String?, Map<String, String>>>

Selects with the given key a Pair of the value and all routing parameters as Map.

open fun select(key: String, orElse: String): Flow<String>

Returns the value for the given key from the routing parameters.