kotlin-extensions / io.realm.kotlin / toChangesetFlow

paraChangesetFlow

fun <T : RealmModel> T?.toChangesetFlow(): Flow<ObjectChange<T>?>

Retorna um fluxo que monitora alterações neste RealmObject. Ele emitirá o RealmObject atual após a assinatura. Para cada atualização do RealmObject, um ObjectChange que consiste em um par com o RealmObject e seu ObjectChangeSet correspondente será enviado. O changeset será null na primeira vez que o RealmObject for emitido.

O RealmObject será emitido continuamente à medida que for atualizado. Esse fluxo nunca será concluído.

Os itens emitidos são congelados (consulte RealmObject.freeze). Isso significa que eles são imutáveis e podem ser lidos em qualquer thread.

Os fluxos de Realm sempre emitem itens do thread que contém o Realm. Isso significa que, se você precisar fazer processamento adicional, é recomendável coletar os valores em um despachante de computação:

object.toChangesetFlow()
  .map { change -> doExpensiveWork(change) }
  .flowOn(Dispatchers.IO)
  .onEach { change ->
    // ...
  }.launchIn(Dispatchers.Main)

Se quiser que toChangesetFlow() pare de emitir itens, você pode instruir o fluxo a emitir apenas o primeiro item ligando para kotlinx.coroutines.flow.first:

val foo = object.toChangesetFlow()
  .flowOn(context)
  .first()

Exceções

UnsupportedOperationException - se a estrutura de corrotinas necessária não estiver no caminho de classe ou se a Instância de Realm correspondente não suportar fluxos.

IllegalStateException - se o Realm não tiver sido aberto em uma thread do loop de eventos.

Return
Kotlin Flow que nunca será concluído.