Kotlin: Dismiss a rejection

dismissRejection marks one journal entry acknowledged. The entry stays in the local database and can be read back, but does not appear in the default list a screen shows.

Examples#

Basic#

// app/src/main/kotlin/com/example/todo/TodoScreen.kt (excerpt)
val acknowledged = kizunasync.dismissRejection(mutationId)

Clear what the user has seen#

// app/src/main/kotlin/com/example/todo/TodoScreen.kt (excerpt)
for (entry in kizunasync.rejections()) {
    kizunasync.dismissRejection(entry.mutationId)
}

Parameters#

Returns#

Boolean. true when an entry carried that id, whether it was already dismissed or not; false only when no entry carries that id.

Errors#

Notes#

Dismissing changes nothing about the write itself. The local row was already reverted when the rejection was journalled, so this is a read-state flag for the interface, not a retry: to try the change again, apply it again with Update data after fixing what the server objected to.

A later run that journals the same mutation id replaces the entry and clears the flag, so a repeated failure comes back into view rather than staying hidden. Read the dismissed entries with rejections(includeDismissed = true).

Related reference#

• List rejections
• Update data
• Subscribe to events
• Swift: Dismiss a rejection
• JavaScript: Dismiss a rejection