数据操作 编辑文档

本篇文档介绍如何进行数据操作,分为写入,更新和删除数据。

数据操作包含以下七种方法:

方法 说明
set() 向指定 节点 写入数据。若此节点已存在数据,会覆盖原有数据。
setPriority() 设置节点优先级。
setWithPriority() 向指定节点写入数据并且设置该节点优先级。
push() 向指定节点添加 子节点。子节点的 key 自动生成并保证唯一。
remove() 删除指定节点。
update() 更新指定子节点。
transaction() 并发操作时保证数据一致性。

写入数据

set() 方法用于向指定节点写入数据。此方法会先清空指定节点,再写入数据。

set() 方法可设置回调方法来获取操作的结果。

例如,向 Jobs 节点下写入 full_namegender

// 初始化
var config = {
authDomain: "<appId>.wilddog.com",
syncURL: "https://<appId>.wilddogio.com"
};
wilddog.initializeApp(config);
var ref = wilddog.sync().ref("/web/saving-data/wildblog/users");
// child() 用来定位到某个节点。
ref.child("Jobs").set({
"full_name": "Steve Jobs",
"gender": "male"
});

设置回调方法:

ref.child("Jobs").set({
"full_name": "Steve Jobs",
"gender": "male"
}, function(error) {
if (error == null){
// 数据同步到野狗云端成功完成
}
});

设置节点优先级

setPriority(priority) 方法用于设置节点的优先级。

Wilddog Sync 支持为每个节点设置优先级(priority),用于实现节点按 优先级排序。优先级是节点的隐藏属性,默认为 null。

例如,设置user节点的优先级为100:

wilddog.sync().ref('user').setPriority(100)
.then(function(){
console.info('set priority success.')
})
.catch(function(err){
console.info('set priority failed', err.code, err);
});

更多使用,请参考 setPriority()

写入数据并设置节点优先级

setWithPriority(value, priority)方法用于向指定节点写入数据并且设置该节点优先级。

例如,写入 jack 的姓名并且设置优先级为100:

wilddog.sync().ref('full_name').setWithPriority('jack',100)
.then(function(){
console.info('set data success.')
})
.catch(function(err){
console.info('set data failed', err.code, err);
});

更多使用,请参考 setWithPriority()

追加子节点

push() 方法用于向指定节点添加子节点。新增子节点的 key 由 Wilddog Sync 自动生成并保证唯一。 新增子节点的 key 基于时间戳和随机算法生成,并可以按照添加时间进行排序。

例如,追加子节点到 messages 节点:

var postsRef = ref.child("messages");
postsRef.push({
"full_name" : "Steve Jobs",
"message" : "Think difference"
});
postsRef.push({
"full_name" : "Bill Gates",
"message" : "Hello World"
});

产生的数据如下:

{
"messages": {
"-JRHTHaIs-jNPLXO": {
"full_name" : "Steve Jobs",
"message" : "Think difference"
},
"-JRHTHaKuITFIhnj": {
"full_name" : "Bill Gates",
"message" : "Hello World"
}
}
}

更新数据

update() 方法用于更新指定子节点。

update() 方法支持多路径更新。可以只调用一次方法更新多个路径的数据。

例如,更新 Jobs 的个人信息:

//原数据如下
{
"Jobs": {
"full_name" : "Steve Jobs",
"gender" : "male"
}
}
// 只更新 Jobs 的 full_name
var hopperRef = ref.child("Jobs");
hopperRef.update({
"full_name": "Tim Cook"
});

例如,同时更新 b 节点下的 d 和 x 节点下的 z:

//原数据如下
{
"a": {
"b": {
"c": "cc",
"d": "dd"
},
"x": {
"y": "yy",
"z": "zz"
}
}
}

正确示例:

ref.update({
"b/d": "updateD",
"x/z": "updateZ"
});

错误示例:

// 错误的多路径更新写法,会覆盖原有数据
ref.update({
"b": {
"d": "updateD"
},
"x": {
"z": "updateZ"
}
});

删除数据

remove() 方法用于删除指定节点。

例如,删除写入的数据:

ref.set({
"full_name" : "Steve Jobs",
"gender" : "male"
});
//删除上面写入的数据
ref.remove();

提示:


设置节点的 value 为 null 等同于 remove() 方法。

事务处理

transaction() 方法用于并发操作时保证数据一致性。

例如,在实现多人点赞功能时,多人同时写入评分会产生覆盖,导致最终结果不准确。使用 transaction()方法可以避免这种情况:

var config = {
authDomain: "docs-examples.wilddog.com",
syncURL: "https://docs-examples.wilddogio.com"
};
wilddog.initializeApp(config);
var upvotesRef = wilddog.sync().ref("/saving-data/wildblog/posts/-JRHTHaIs-jNPLXOQivY/upvotes");
upvotesRef.transaction(function (currentValue) {
return (currentValue || 0) + 1; // 判断计数器是否为空或者是自增加
});

注意:


回调方法的返回值可能为空,需要进行相应的处理。

更多使用,请参考 transaction()

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