类 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() 。

从 UI 线程调用此方法会抛出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. 应用 线程。

返回此 Realm 的可变模式。

返回：

此 Realm 的RealmSchema 。

覆盖

getSchema 在BaseRealm类中

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

返回：

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

覆盖

isEmpty 在BaseRealm类中

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

抛出异常

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

删除指定的变更侦听器。

参数

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

抛出异常

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

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

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

参数

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

返回：

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

抛出异常

• IllegalArgumentException - 如果该类不存在。