soil-query-core/soil.query/QueryState

QueryState

data class QueryState<T> : QueryModel<T>

State for managing the execution result of Query.

Types

Companion

object Companion

OmitKey

@JvmInline

value class OmitKey(val name: String)

Properties

error

open override val error: Throwable? = null

The error that occurred.

errorUpdatedAt

open override val errorUpdatedAt: Long = 0

The timestamp when the error occurred.

fetchStatus

open override val fetchStatus: QueryFetchStatus

The fetch status of the query.

isFailure

open val isFailure: Boolean

Returns true if the query is a failure, false otherwise.

isFetching

open val isFetching: Boolean

Returns true if the query is fetching, false otherwise.

isInvalidated

open override val isInvalidated: Boolean = false

Returns true if the query is invalidated, false otherwise.

isPending

open val isPending: Boolean

Returns true if the query is pending, false otherwise.

isSuccess

open val isSuccess: Boolean

Returns true if the query is successful, false otherwise.

open override val reply: Reply<T>

The return value from the data source.

replyUpdatedAt

open override val replyUpdatedAt: Long = 0

The timestamp when the data was updated.

revision

open val revision: String

The revision of the currently snapshot.

staleAt

open override val staleAt: Long = 0

The timestamp when the data is considered stale.

status

open override val status: QueryStatus

The status of the query.

Functions

isAwaited

open override fun isAwaited(): Boolean

Returns true if the QueryModel is awaited.

isPaused

open fun isPaused(currentAt: Long = epoch()): Boolean

Returns true if the query is paused, false otherwise.

isStaled

open fun isStaled(currentAt: Long = epoch()): Boolean

Returns true if the query is staled, false otherwise.

omit

fun omit(keys: Set<QueryState.OmitKey>): QueryState<T>

Returns a new QueryState with the items included in keys omitted from the current QueryState.