类 DynamicRealm

向 Realm 添加变更监听器。此线程或另一个线程提交变更时将执行监听器。

Realm实例按线程进行缓存。因此，请务必记住使用 removeChangeListener(RealmChangeListener) 或 removeAllChangeListeners() 再次删除侦听器。否则可能会导致内存泄漏。

参数

• listener — 变更侦听器。

抛出异常

• IllegalArgumentException - 如果变更监听器为 null 。

返回一个监控此 Realm 变更的 RxJava Flowable。 订阅时，它将发出当前状态。 随着 Realm 更新，项目将不断发出 - onComplete将永远不会被调用。

从 Realm Flowables 发出的项被冻结（请参阅冻结（） 。 这意味着它们是不可变的，可以在任何线程上读取。

Realm Flowables 始终从持有活动 Realm 的线程中发出项目。 这意味着，如果需要进行进一步处理，建议观察计算调度器上的值：

realm.asFlowable()
 .observeOn(Schedulers.computation())
 .map(rxRealm -> doExpensiveWork(rxRealm))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

如果希望asFlowable()停止发出项目，可以使用first()操作符指示 RxJava 仅发出第一项：

realm.asFlowable().first().subscribe( ... ); // You only get the results once

返回：

仅调用onNext的 RxJava Observable。 它永远不会调用onComplete或OnError 。

覆盖

asFlowable 在BaseRealm类中

实例化一个新的嵌入式对象并将其添加到 Realm。此方法只应用于创建标记为嵌入式的类型的对象。

参数

• className - 要创建的对象的类名。

• parentObject - 应包含对嵌入式对象的引用的父对象。 如果父属性是列表，则嵌入式对象将被添加到该列表的末尾。

• parentProperty - 父类中保存引用的属性。

返回：

新创建的嵌入式对象。

抛出异常

• IllegalArgumentException - 如果 clazz 不是嵌入式类或者父类中的属性无法保存适当类型的对象。

创建具有给定主键的对象。未定义主键的类必须使用 createObject(string) } 代替。

返回：

新对象。 所有字段都将具有其类型的默认值，但主键字段除外，它将具有提供的值。

抛出异常

• RealmException - 如果由于主键无效而无法创建对象。

• IllegalStateException - 如果模型 clazz 没有定义主键。

• IllegalArgumentException - 如果 primaryKeyValue 没有可以转换为预期值的值。

实例化一个新对象并将其添加到 Realm 中。

参数

• className - 要创建的对象的类名。

返回：

新对象。

抛出异常

• RealmException - 如果无法创建对象。

从 Realm 中删除指定类的所有对象。

参数

• className - 应删除所有对象的类。

抛出异常

• IllegalStateException - 如果Realm已关闭或从不正确的线程调用。

在 DynamicRealm 上执行给定事务。 beginTransaction()和commitTransaction()将被自动调用。 如果在事务期间引发任何异常，将调用cancelTransaction()而不是commitTransaction() 。

从用户界面线程调用此方法会抛出 RealmException 异常。这样做可能会导致丢帧甚至 ANR。 我们建议从非用户界面线程中调用此方法，或改用executeTransactionAsync(Transaction)。

参数

• transaction - 要执行的事务。

抛出异常

• IllegalArgumentException - 如果 transaction 为 null。

• RealmException - 如果从 用户界面 线程调用，除非在RealmConfiguration.Builder.allowWritesOnUiThread(boolean)中声明了显式选择加入。

与executeTransactionAsync(Transaction) 类似，但也接受 OnSuccess 和 OnError 回调。

参数

• transaction - 要执行的事务。

• onSuccess — 事务成功时调用的回调。

• onError — 事务失败时调用的回调。

返回：

代表可取消任务的RealmAsyncTask 。

抛出异常

• IllegalArgumentException - 如果 transaction 为 null，或者域是从另一个线程打开的。

与executeTransactionAsync(Transaction) 类似，但也接受 OnError回调。

参数

• transaction - 要执行的事务。

• onError — 事务失败时调用的回调。

返回：

代表可取消任务的RealmAsyncTask 。

抛出异常

• IllegalArgumentException - 如果 transaction 为 null，或者域是从另一个线程打开的。

与executeTransactionAsync(Transaction) 类似，但也接受 OnSuccess回调。

参数

• transaction - 要执行的事务。

• onSuccess — 事务成功时调用的回调。

返回：

代表可取消任务的RealmAsyncTask 。

抛出异常

• IllegalArgumentException - 如果 transaction 为 null，或者域是从另一个线程打开的。

与executeTransaction(Transaction) 类似，但在工作线程上异步运行。

参数

• transaction - 要执行的事务。

返回：

代表可取消任务的RealmAsyncTask 。

抛出异常

• IllegalArgumentException - 如果 transaction 为 null，或者Realm是从另一个线程打开的。

返回当前Realm的冻结快照。可以从任何线程读取和查询此Realm ，而不会引发 IllegalStateException。冻结的Realm有自己的生命周期，可以通过调用 close() 来关闭，但完全关闭生成冻结副本的Realm也会关闭冻结的Realm。

可以正常查询冻结数据，但尝试以任何方式更改数据或尝试注册任何侦听器都会引发IllegalStateException 。

注意：保持大量不同版本的 Realm 活动可能会对 Realm 的文件大小产生负面影响。 为了避免这种情况，可以设置RealmConfiguration.Builder.maxNumberOfActiveVersions(long) 。

返回：

此 Realm 的冻结副本。

覆盖

freeze 在BaseRealm类中

Realm 静态构造函数，返回由提供的io.realm.RealmConfiguration定义的 Realm 实例的动态变体。 动态 Realms 不关心 schemaVersion 和模式，因此打开 DynamicRealm 永远不会 trigger 迁移。

返回：

配置定义的 DynamicRealm。

抛出异常

• RealmFileException - 如果访问底层 Realm 文件时发生错误。

• IllegalArgumentException - 如果 configuration 参数为 null。

在进程中创建每个RealmConfiguration的第一个 Realm 实例可能需要一些时间，因为此时所有初始化代码都需要运行（设置 Realm、验证模式和创建初始数据）。 此方法将初始化工作放在背景线程中，并在初始化完成后将 Realm 实例异步传递给调用者线程。

参数

• configuration - 用于打开 Realm 的RealmConfiguration 。

• callback — 调用以返回结果。

返回：

代表可取消任务的RealmAsyncTask 。

抛出异常

• IllegalArgumentException - 如果提供了 null RealmConfiguration 或 null Callback。

• IllegalStateException - 如果从非 Looper 或 android. 应用.IntentService 线程。

返回此 Realm 的可变模式。

返回：

此 Realm 的RealmSchema 。

覆盖

getSchema 在BaseRealm类中

检查此io.realm.Realm 是否包含任何对象。

返回：

true 如果为空，则为 @{code false} 否则。

覆盖

isEmpty 在BaseRealm类中

删除所有用户定义的变更侦听器。

抛出异常

• IllegalStateException - 如果尝试从非 Looper 线程中删除侦听器。

删除指定的变更侦听器。

参数

• listener - 要删除的变更侦听器。

抛出异常

• IllegalArgumentException - 如果变更监听器为 null 。

• IllegalStateException - 如果尝试从非 Looper 线程中删除侦听器。

返回一个 RealmQuery，可用于查询提供的类。

参数

• className - 要查询的对象的类。

返回：

RealmQuery，可用于查询所提供类型的特定对象。

抛出异常

• IllegalArgumentException - 如果该类不存在。