belongs to Maven artifact android.arch.persistence.room:runtime:1.1.0-beta2
InvalidationTracker
public
class
InvalidationTracker
extends Object
java.lang.Object | |
↳ | android.arch.persistence.room.InvalidationTracker |
InvalidationTracker keeps a list of tables modified by queries and notifies its callbacks about these tables.
Summary
Nested classes | |
---|---|
class |
InvalidationTracker.Observer
An observer that can listen for changes in the database. |
Public methods | |
---|---|
void
|
addObserver(InvalidationTracker.Observer observer)
Adds the given observer to the observers list and it will be notified if any table it observes changes. |
void
|
refreshVersionsAsync()
Enqueues a task to refresh the list of updated tables. |
void
|
removeObserver(InvalidationTracker.Observer observer)
Removes the observer from the observers list. |
Inherited methods | |
---|---|
Public methods
addObserver
void addObserver (InvalidationTracker.Observer observer)
Adds the given observer to the observers list and it will be notified if any table it observes changes.
Database changes are pulled on another thread so in some race conditions, the observer might be invoked for changes that were done before it is added.
If the observer already exists, this is a no-op call.
If one of the tables in the Observer does not exist in the database, this method throws an
IllegalArgumentException
.
Parameters | |
---|---|
observer |
InvalidationTracker.Observer : The observer which listens the database for changes.
|
refreshVersionsAsync
void refreshVersionsAsync ()
Enqueues a task to refresh the list of updated tables.
This method is automatically called when endTransaction()
is called but
if you have another connection to the database or directly use SupportSQLiteDatabase
, you may need to call this manually.
removeObserver
void removeObserver (InvalidationTracker.Observer observer)
Removes the observer from the observers list.
Parameters | |
---|---|
observer |
InvalidationTracker.Observer : The observer to remove.
|
Annotations
Classes
Enums
Exceptions
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2024-04-11 UTC.