类 RealmList

在此 List 的末尾添加指定对象。

1. 非托管 RealmList ：可以同时添加托管和非托管对象。 如果将托管对象添加到非托管 RealmList，之后使用Realm.copyToRealm(RealmModel, ImportFlag...)，则它们不会再次复制到 Realm。

2. 托管 RealmList ：可以将非托管对象添加到已托管的 RealmList 中。 在这种情况下，如果对象具有主键，则使用Realm.copyToRealm(RealmModel, ImportFlag...)或Realm.copyToRealmOrUpdate(RealmModel, ImportFlag...)以透明方式将对象复制到 Realm。

参数

• object - 要添加的对象。

返回：

始终true 。

抛出异常

• IllegalStateException - 如果Realm 实例已关闭或父对象已删除。

覆盖

add 在 AbstractList 类中

将指定对象插入此 List 的指定位置。 该对象会插入到指定位置的任何前一个元素之前。 如果该位置等于此 List 的大小，则将该对象添加到末尾。

1. 非托管 RealmList ：可以同时添加托管和非托管对象。 如果将托管对象添加到非托管 RealmList，之后使用Realm.copyToRealm(RealmModel, ImportFlag...)，则它们不会再次复制到 Realm。

2. 托管 RealmList ：可以将非托管对象添加到已托管的 RealmList 中。 在这种情况下，如果对象具有主键，则使用Realm.copyToRealm(RealmModel, ImportFlag...)或Realm.copyToRealmOrUpdate(RealmModel, ImportFlag...)以透明方式将对象复制到 Realm。

参数

• location - 要插入的索引。

• element - 要添加的元素。

抛出异常

• IllegalStateException - 如果 Realm 实例已关闭或容器对象已被删除。

• IndexOutOfBoundsException - 如果location < 0 || location > size() 。

覆盖

add 在 AbstractList 类中

向此RealmList添加变更侦听器。

注册变更侦听器不会阻止底层 RealmList 被垃圾收集。 如果对 RealmList 进行垃圾回收，则将停止触发变更侦听器。 为避免这种情况，请尽可能长时间地保留强引用，例如在类变量中。

public class MyActivity extends Activity {
    private RealmList<Dog> dogs; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      dogs = realm.where(Person.class).findFirst().getDogs();
      dogs.addChangeListener(new RealmChangeListener<RealmList<Dog>>() {
          @Override
          public void onChange(RealmList<Dog> dogs) {
              // React to change
          }
      });
    }
}

参数

• listener - 要通知的变更侦听器。

抛出异常

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

• IllegalStateException - 如果您尝试从非 Looper 或 android.app.IntentService 添加监听器 线程。

向此RealmList添加变更侦听器。

注册变更侦听器不会阻止底层 RealmList 被垃圾收集。 如果对 RealmList 进行垃圾回收，则将停止触发变更侦听器。 为避免这种情况，请尽可能长时间地保留强引用，例如在类变量中。

public class MyActivity extends Activity {
    private RealmList<Dog> dogs; // Strong reference to keep listeners alive
    @Override
    protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      dogs = realm.where(Person.class).findFirst().getDogs();
      dogs.addChangeListener(new OrderedRealmCollectionChangeListener<RealmList<Dog>>() {
          @Override
          public void onChange(RealmList<Dog> dogs, OrderedCollectionChangeSet changeSet) {
              // React to change
          }
      });
    }
}

参数

• listener - 要通知的变更侦听器。

抛出异常

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

• IllegalStateException - 如果您尝试从非 Looper 或 android.app.IntentService 添加监听器 线程。

返回一个 Rx Observable，用于监控对此 RealmList 的更改。 订阅时，它将发出当前的 RealmList。 每次更新 RealmList 时，都会发送由 RealmList 和OrderedCollectionChangeSet组成的对。 首次发出 RealmList 时，变更集将为null 。

RealmList 将在 RealmList 更新时不断发出 - onComplete将永远不会被调用。

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

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

list.asChangesetObservable()
 .observeOn(Schedulers.computation())
 .map((rxList, changes) -> doExpensiveWork(rxList, changes))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

返回：

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

抛出异常

• UnsupportedOperationException - 如果所需的 RxJava 框架不在类路径上，或者相应的 Realm 实例不支持 RxJava。

• IllegalStateException - 如果 Realm 不是在 Looper 线程上打开的。

返回一个监控此 RealmList 更改的 Rx Flowable。 订阅时，它将发出当前的 RealmList。 RealmList 将在 RealmList 更新时不断发出 - onComplete将永远不会被调用。

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

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

list.asFlowable()
 .observeOn(Schedulers.computation())
 .map(rxResults -> doExpensiveWork(rxResults))
 .observeOn(AndroidSchedulers.mainThread())
 .subscribe( ... );

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

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

返回：

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

抛出异常

• UnsupportedOperationException - 如果所需的 RxJava 框架不在类路径上，或者相应的 Realm 实例不支持 RxJava。

返回给定字段的平均值。

返回：

查询结果中对象之间给定字段的平均值。对于所有类型的数字字段，该值的类型都是 double。如果对象不存在，或者给定字段的值为null ，则返回0 。计算平均值时，具有null值的对象将被忽略。

从此列表中删除所有元素，使其为空。 此方法不会从 Realm 中删除对象。

抛出异常

• IllegalStateException - 如果Realm 实例已关闭或父对象已删除。

覆盖

clear 在 AbstractList 类中

如果列表在附加到 Realm 时包含指定元素，则返回true 。 该方法将查询原生 Realm 底层storage engine，以快速找到指定的元素。

如果列表未附加到 Realm，则默认使用 List.contains(Object) 实施将发生。

参数

• object - 要测试其在此列表中是否存在的元素。

返回：

true 如果此列表包含指定元素，否则为false 。

覆盖

contains 在 AbstractCollection 类中

从此OrderedRealmCollection创建快照。

返回：

此collection的快照。

这将从底层 Realm 以及集合中删除集合中的所有对象。

返回：

true 如果删除了对象，则返回false 。

从 Realm 中删除第一个对象。 这也会将其从该collection中删除。

返回：

true 如果删除了对象，则为false 。

从 Realm 中删除最后一个对象。 这也会将其从该collection中删除。

返回：

true 如果删除了对象，则为false 。

获取集合中的第一个对象。 如果collection为空，将使用提供的默认。

返回：

第一个对象或提供的默认值。

获取collection中的第一个对象。

返回：

第一个对象。

返回此列表中指定位置的元素。

参数

• location - 要返回的元素的索引。

返回：

指定索引处的元素。

抛出异常

• IllegalStateException - 如果Realm 实例已关闭或父对象已删除。

• IndexOutOfBoundsException - 如果location < 0 || location >= size() 。

覆盖

get 在 AbstractList 类中

返回此collection所属的Realm 实例。

不鼓励在返回的实例上调用Realm.close() ，因为这与在原始 Realm 实例上调用它相同，这可能导致 Realm 完全关闭，从而使列表失效。

返回：

此集合所属的Realm实例，如果该集合为非托管集合，则为null 。

抛出异常

• IllegalStateException - 如果Realm是 DynamicRealm 的实例或者 Realm 已关闭。

检查collection是否已完成数据加载。

返回：

true 如果数据已加载且可用，则如果仍在加载数据，则为false 。

检查collection是否由Realm托管。一个托管的collection只是底层的Realm 文件中数据的包装器。在 Looper 线程上，托管 collection 将实时更新，因此它始终点向最新数据。托管集合具有线程限制，因此除了创建它们的线程之外，无法从其他线程访问托管集合。如果此方法返回false ，则该集合为非托管集合。 非托管集合只是普通的 Java 集合，因此不会实时更新。

返回：

true 如果这是一个托管RealmCollection ，则为false 。

检查集合是否仍可有效使用，即io.realm.Realm实例尚未关闭。 对于非托管collection，它将始终返回true 。

返回：

true 如果仍可使用，则为非托管collection，否则为false 。

覆盖

iterator 在 AbstractList 类中

从collection中获取最后一个对象。如果collection为空，将使用提供的默认。

返回：

最后一个对象或提供的默认值。

从collection中获取最后一个对象。

返回：

最后一个对象。

覆盖

listIterator 在 AbstractList 类中

覆盖

listIterator 在 AbstractList 类中

阻止collection，直到所有数据都可用。

返回：

true 如果可以成功加载数据，则为false 。

查找字段的最大值。

返回：

如果对象不存在，或者给定字段的值为null ，则返回null 。否则返回最大值。 确定最大值时，具有null值的对象将被忽略。

查找最大日期。

返回：

如果对象不存在，或者给定日期字段的值为null ，则返回null 。否则，返回最大日期。 确定最大日期时，具有null值的对象将被忽略。

查找字段的最小值。

返回：

如果对象不存在，或者给定字段的值为null ，则返回null 。否则返回最小值。 确定最小值时，具有null值的对象将被忽略。

查找最小日期。

返回：

如果对象不存在，或者给定日期字段的值为null ，则返回null 。 否则，返回最小日期。 确定最小日期时，具有null值的对象将被忽略。

将对象从一个位置移动到另一个位置，同时保持列表大小固定。 RealmObject 将进行移动，因此不会引入null值。

参数

• oldPos — 要移动的 RealmObject 的索引。

• newPos - 目标位置。 如果 newPos < oldPos，则该位置的对象将向右移动。 如果 oldPos < newPos,indexes > oldPos 将向左移动一次。

抛出异常

• IllegalStateException - 如果Realm 实例已关闭或父对象已删除。

• java.lang.IndexOutOfBoundsException - 如果任何位置超出 [0 , size()]。

如果此Collection包含指定对象，则从中删除一个实例。 此实现会遍历此Collection并测试迭代器返回的每个元素e ，确定e是否等于给定对象。 如果为object != null ，则使用object.equals(e)执行此测试，否则使用object == null执行。 如果找到等于给定对象的元素，则对迭代器调用remove方法并返回true ，否则返回false 。 如果迭代器不支持删除元素，则会引发UnsupportedOperationException 。

参数

• object - 要删除的对象。

返回：

true 如果此Collection已修改，则否则为false 。

抛出异常

• ClassCastException - 如果传递的对象类型不正确。

• NullPointerException - 如果object 为null 。

覆盖

remove 在 AbstractCollection 类中

从此列表中删除指定位置的对象。

参数

• location - 要删除的对象的索引。

返回：

删除的对象。

抛出异常

• IllegalStateException - 如果Realm 实例已关闭或父对象已删除。

• IndexOutOfBoundsException - 如果location < 0 || location >= size() 。

覆盖

remove 在 AbstractList 类中

删除指定Collection中每个对象在此Collection中出现的所有情况。 在此方法返回后，在此Collection中找不到所传递的Collection中的任何元素。

此实现遍历Collection并测试迭代器返回的每个元素e ，看看它是否包含在指定的Collection中。 如果此测试是肯定的，则在迭代器上调用remove方法。

参数

• collection - 要删除的collection的对象。

返回：

true 如果此Collection已修改，则否则为false 。

抛出异常

• ClassCastException - 如果collection 的一个或多个元素的类型不正确。

• NullPointerException - 如果collection 为null 。

覆盖

removeAll 在 AbstractCollection 类中

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

抛出异常

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

删除指定的变更侦听器。

参数

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

抛出异常

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

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

删除指定的变更侦听器。

参数

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

抛出异常

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

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

将列表中指定位置的元素替换为指定对象。

1. 非托管 RealmList ：可以同时添加托管和非托管对象。 如果将托管对象添加到非托管 RealmList，之后使用Realm.copyToRealm(RealmModel, ImportFlag...)，则它们不会再次复制到 Realm。

2. 托管 RealmList ：可以将非托管对象添加到已托管的 RealmList 中。 在这种情况下，如果对象具有主键，则使用Realm.copyToRealm(RealmModel, ImportFlag...)或Realm.copyToRealmOrUpdate(RealmModel, ImportFlag...)以透明方式将对象复制到 Realm。

参数

• location — 放置指定对象的索引。

• object - 要添加的对象。

返回：

索引处的前一个元素。

抛出异常

• IllegalStateException - 如果Realm 实例已关闭或父对象已删除。

• IndexOutOfBoundsException - 如果location < 0 || location >= size() 。

覆盖

set 在 AbstractList 类中

返回此List中的元素数量。

返回：

此List中的元素数量。

抛出异常

• IllegalStateException - 如果Realm 实例已关闭或父对象已删除。

覆盖

size 在 AbstractCollection 类中

根据提供的字段和排序顺序对collection进行排序。

返回：

将创建并返回新的排序RealmResults 。 原始collection保持不变。

根据提供的字段和排序顺序对collection进行排序。

返回：

将创建并返回新的排序RealmResults 。 原始collection保持不变。

根据提供的字段和排序顺序对collection进行排序。

返回：

将创建并返回新的排序RealmResults 。 原始collection保持不变。

根据提供的字段以升序对collection进行排序。

返回：

将创建并返回新的排序RealmResults 。 原始collection保持不变。

计算给定字段的总和。

返回：

总和。 如果对象不存在，或者给定字段的值为null ，则返回0 。计算总和时，具有null值的对象将被忽略。

覆盖

toString 在 AbstractCollection 类中

返回一个 RealmQuery，可用于查询该类的特定对象。

返回：

RealmQuery 对象。

抛出异常

• IllegalStateException - 如果Realm 实例已关闭或父对象已删除。