title: DataSnapshot

title: DataSnapshot

DataSnapshot 是当前指定节点下的数据快照，DataSnapshot 不会随当前节点数据的变化而发生改变。 不应直接创建这个数据快照对象，而应当数据监听的回调函数中来获取它。

方法

child(path)

定义

DataSnapshot child(String path)

说明

根据相对路径 path，来获取当前节点下 path 子节点的数据快照。相对路径可以是一个子节点的 key 值（如：”Beijing”），也可以是更深层次的路径（如：”Beijing/pm25”）。 如果相对路径下没有数据，则返回 null 。

参数

返回值

DataSnapshot 实例。

exists()

定义

boolean exists()

说明

判断当前 DataSnapshot 实例中是否包含数据，相当于 snapshot.getValue() != null。 但使用 exists() 方法进行非空判断比 snapshot.getValue() != null 更高效。

返回值

boolean，当前实例中包含数据返回 true，否则返回 false。

hasChild(key)

定义

boolean hasChild(String key)

说明

判断是否存在某个指定的子节点的数据快照。如果指定节点快照的数据不为空返回 true。

参数

返回值

boolean 当前数据快照包含指定的子节点的数据快照返回 true，否则返回 false。

hasChildren()

定义

boolean hasChildren()

说明

判断当前 Datasnapshot 实例中是否存在子节点。 可以使用 hasChildren() 方法来确定当前的数据快照是否含有子节点，进而决定是否调用 getChildren() 方法获取迭代器遍历数据。

返回值

boolean 当前数据快照存在子节点返回true，否则返回 false。

getChildren()

定义

Iterable<DataSnapshot> getChildren()

说明

获取当前数据快照中所有子节点的迭代器。

返回值

Iterable<DataSnapshot> 数据快照子节点迭代器。

getChildrenCount()

定义

long getChildrenCount()

说明

获取子节点的数量。

返回值

long 子节点数量 。

getRef()

定义

SyncReference getRef()。

说明

从快照中，获得当前节点的引用。

返回值

SyncReference 节点引用。

getKey()

定义

String getKey()

说明

获取当前数据快照所属节点的 key。

返回值

String 数据快照节点的 key 值。

getValue()

定义

Object getValue()

说明

返回当前数据快照包含的数据。 返回的数据类型取决于节点下的数据内容。

返回值

Object 当前数据快照包含的数据。可能返回的数据类型包括：null、String、Number、Boolean、List、Map 或满足 JavaBean 规范的实体，null 表示该节点的数据快照为空。

getPriority()

定义

Object getPriority()

说明

获取当前数据快照所属节点的 priority 值。如果优先级不存在时返回 null。

返回值

Object 返回值类型根据节点优先级值的不同，可能为：String、Double 或 null。