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()
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.