Docs 菜单
Docs 主页
/ /
Atlas Device SDKs
/ / /

接口 RealmCollection

在此页面上

  • io.realm
  • 方法摘要
  • 继承方法
  • 方法详细信息
  • 平均值
  • contains
  • deleteAllFromRealm
  • isLoaded
  • isManaged
  • isValid
  • 负载
  • Max
  • maxDate
  • min
  • minDate
  • 总和
  • WHERE

实现的接口:

  • java.util.Collection

  • java.lang.Iterable

RealmCollection 是 Realm 支持的集合层次结构的根。 它定义了对数据collection的操作以及这些操作在RealmCollection的所有实现中的行为。

Realm 集合是底层数据的“实时”视图。 这意味着它们将自动保持最新。 因此,使用 Collections.unmodifierCollection(Collection) 等方法不会阻止修改集合。

修饰符和类型
方法和说明
公共双精度
String fieldName
)

返回给定字段的平均值。

公共布尔值
Object object
)

测试此Collection是否包含指定对象。

公共布尔值

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

公共布尔值

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

公共布尔值

检查collection是否由Realm托管。

公共布尔值

检查collection是否仍可有效使用,即Realm实例尚未关闭。

公共布尔值
load ()

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

公众
max (
String fieldName
)

查找字段的最大值。

公共 日期
String fieldName
)

查找最大日期。

公众
min (
String fieldName
)

查找字段的最小值。

公共 日期
String fieldName
)

查找最小日期。

公众
sum (
String fieldName
)

计算给定字段的总和。

返回一个RealmQuery ,可用于从此collection中查询特定objects。

public double average (
String fieldName
)

返回给定字段的平均值。

参数

  • fieldName - 计算平均值的字段。 仅支持数字字段。

返回:

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

抛出异常

public boolean contains (
Object object
)

测试此Collection是否包含指定对象。 true当且仅当此 中的至少一个元素elem Collection满足以下要求时,才返回 :(object==null ? elem==null : object.equals(elem))

参数

  • object - 要搜索的对象。

返回:

true 如果对象是此Collection的元素,则为false ,否则。

抛出异常

  • NullPointerException - 如果要查找的对象是null ,并且此Collection 不支持null 元素。

public boolean deleteAllFromRealm ()

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

返回:

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

抛出异常

public boolean isLoaded ()

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

返回:

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

public boolean isManaged ()

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

返回:

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

public boolean isValid ()

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

返回:

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

public boolean load ()

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

返回:

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

public Number max (
String fieldName
)

查找字段的最大值。

参数

  • fieldName - 要查找最大值的字段。 仅支持数字字段。

返回:

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

抛出异常

public Date maxDate (
String fieldName
)

查找最大日期。

参数

  • fieldName - 查找最大日期的字段。 如果 fieldName 不是 Date 类型,则会抛出异常。

返回:

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

抛出异常

public Number min (
String fieldName
)

查找字段的最小值。

参数

  • fieldName - 查找最小值的字段。 仅支持数字字段。

返回:

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

抛出异常

public Date minDate (
String fieldName
)

查找最小日期。

参数

  • fieldName - 查找最小日期的字段。如果 fieldName 不是 Date 类型,则会抛出异常。

返回:

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

抛出异常

public Number sum (
String fieldName
)

计算给定字段的总和。

参数

  • fieldName - 要求和的字段。 仅支持数字字段。

返回:

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

抛出异常

public RealmQuery where ()

返回一个RealmQuery ,可用于从此collection中查询特定objects。

返回:

RealmQuery 对象。

抛出异常

提示

另请参阅:

后退

RealmChangeListener