MutableData 编辑文档

是当前指定节点下的数据快照,与 DataSnapshot 不同,MutableData 当前节点数据可以改变。
用于在事务中对节点数据进行线程安全的数据修改。
MutableData 实例修改数据时会检查当前节点数据是否被修改过,如果数据已经被修改,则获取新值后再次进行检查,直至通过检查后,更新指定节点数据。

方法

child(node)

定义
MutableData child(String node)
说明

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

参数
参数名 说明
node String 子节点名称。
返回值

MutableData 实例。


hasChild(key)

定义
boolean hasChild(String key)
说明

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

参数
参数名 说明
key String 子节点名称。
返回值

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


hasChildren()

定义
boolean hasChildren()
说明

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

返回值

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


getChildren()

定义
Iterator<MutableData> getChildren()
说明

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

返回值

Iterator<MutableData> 数据快照子节点迭代器。


getChildrenCount()

定义
long getChildrenCount()
说明

获取子节点的数量。

返回值

long 子节点数量 。


getParent()

定义
MutableData getParent()
说明

获取一个节点的父节点数据,如果本身就是根节点,返回 null。
已过时,不建议使用此方法。

返回值

MutableData 实例 。


getKey()

定义
String getKey()
说明

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

返回值

String 数据快照所属节点的 key 值。


getValue()

定义
Object getValue()
说明

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

返回值

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


setValue(value)

定义
void setValue(Object value)
说明

给当前节点赋值。
该函数是线程安全的,将阻塞其他的本地数据操作。

参数
参数名 说明
value value 的类型可以为 null、String、Number、Boolean、List、Map 或满足 JavaBean 规范的实体。当 value 为 null 时,会删除当前节点。



setPriority(priority)

定义
void setPriority(Object priority)
说明

设置当前数据快照所属节点的 priority 值。
该函数是线程安全的,将阻塞其他的本地数据操作。

参数
参数名 说明
priority Object 类型,指定节点的优先级,类型可以为 Number、String 或 null。


野狗新手?
立即注册,为你提供安全可靠的实时通信云服务。
没找到需要的文档?
你可以提交工单反馈 或 阅读常见问题
期待收到你的反馈,帮助我们改进文档。
参与调研