io.realm

Interface RealmChangeListener

public interface RealmChangeListener

RealmChangeListener can be registered with a Realm, RealmResults or RealmObject to receive a notification about updates.

When registered against a Realm you'll get notified when a Realm instance has been updated. Register against a RealmResults or RealmObject to only get notified about changes to them.

Realm instances on a thread without an Looper (almost all background threads) don't get updated automatically, but have to call BaseRealm.refresh() manually. This will in turn trigger the RealmChangeListener for that background thread.

All RealmObject and RealmResults will automatically contain their new values when the onChange() method is called. Normally this means that it isn't necessary to query again for those objects, but just invalidate any UI elements that are using them. If there is a chance that a object has been been deleted, it can be verified by using RealmObject.isValid().

See Also:

BaseRealm.addChangeListener(RealmChangeListener), BaseRealm.removeAllChangeListeners(), BaseRealm.removeChangeListener(RealmChangeListener)

Method Summary

Modifier and Type	Method and Description
void	onChange() Called when a transaction is committed.

Method Detail

onChange

void onChange()

Called when a transaction is committed.