updateRecord(table, record, callback) 更新表数据

功能分类: Data Applab JavaScript 少儿编程

在 Applab 表数据存储里,在指定名称的 table 表里,更新与指定的 record 匹配的记录,并指定操作结束后异步调用的 callback 回调函数。 一个布尔类型的 success 返回结果将作为参数传递给回调函数。

为 APP 应用增加持久数据存储可以让你编写的程序成为一个真正的 APP 应用 - 像你平时使用的 APP 一样。我们使用的很多应用程序都是通过 “云端” 数据驱动的。通过使用这里的方法,你也可以开发一个 “云端” 数据驱动的应用。

第一次使用 Applab 表数据存储? 在这里 表数据存储 查看 Applab 表数据存储介绍以及使用方法。

传递的 record 参数必须是 javaScript object 对象变量或使用 {}: 定义的 javaScript object 对象。并且其中必须包含 id 属性(参考下面的代码示例)。一个 APP 应用只能访问在应用自己里面创建的数据。

要查看 APP 里的表数据,在 Applab 页面点击并打开 数据 页面,在页面里会显示 APP 相关的所有数据表信息,点击数据表即可查看或修改表数据。

示例代码



textInput("nameInput", "What is your name?");
textInput("ageInput", "What is your age?");
textInput("foodInput", "What is your favorite food?");
button("submitButton", "Submit");
button("updateButton", "Update Most Recent Record to Pizza");
var mostRecentID=1;

onEvent("submitButton", "click", function() {
  var favFoodData={};
  favFoodData.name = getText("nameInput");
  favFoodData.age = getNumber("ageInput");
  favFoodData.food = getText("foodInput");
  createRecord("fav_foods", favFoodData, function(record) {
    mostRecentID=record.id;
    console.log("Record created with id:" + record.id);
    console.log("Name:" + record.name + " Age:" + record.age + " Food:" + record.food);
  });
});

onEvent("updateButton", "click", function() {
  updateRecord("fav_foods", {id:mostRecentID,name:"Bobby",age:16,food:"pizza"}, function(record, success) {
    if (success) {
      console.log("Record updated with id:" + mostRecentID);
    }
    else {
      console.log("No record to update with id:" + mostRecentID);
    }      
  });
});


示例代码:内容替换 找到 sushi 并用 pineapples 替换。


// 找到 sushi 并用 pineapples 替换
var fruit = ["sushi", "apples", "oranges", "bananas"];
createRecord("fruitTable", {food:fruit[randomNumber(0,fruit.length-1)]}, function(record) {
  console.log("Created: Id:" + record.id + " food:" + record.food);
});
createRecord("fruitTable", {food:fruit[randomNumber(0,fruit.length-1)]}, function(record) {
  console.log("Created: Id:" + record.id + " food:" + record.food);
});
createRecord("fruitTable", {food:fruit[randomNumber(0,fruit.length-1)]}, function(record) {
  console.log("Created: Id:" + record.id + " food:" + record.food);
});
createRecord("fruitTable", {food:fruit[randomNumber(0,fruit.length-1)]}, function(record) {
  console.log("Created: Id:" + record.id + " food:" + record.food);
});
createRecord("fruitTable", {food:fruit[randomNumber(0,fruit.length-1)]}, function(record) {
  console.log("Created: Id:" + record.id + " food:" + record.food);
});

button("findReplace", "Find & Replace Sushi");
onEvent("findReplace", "click", function() {
  readRecords("fruitTable", {food:"sushi"}, function(records) {
    if (records.length>0) {    
      var updatedRecord = records[0];
      updatedRecord.food = "pineapples";
      updateRecord("fruitTable", updatedRecord, function(record, success) {
        if (success) write("Record updated with id:" +record.id);
        else write("Record NOT updated");
      });
    }
    else write("No sushi record found");
  });
});


语法规则


updateRecord(table, record, function(record, success){
    // 在这里编写回调函数代码
  });

参数说明

名称 类型 必需 参数描述
table string Yes 指定表存储中的表名称。
record object Yes 指定表数据更新记录并指定匹配 id。必须是 javaScript object 对象变量或使用 {}: 定义的 javaScript object 对象。(参考下面代码。)
callback function Yes updateRecord 调用完成后被异步调用执行的函数。一个包含新数据结果以及一个返回状态 success 参数将被传递给回调函数。

返回值

没有返回值。但在 updateRecord() 执行并更新数据后,一个代表操作是否成功的布尔类型 success 返回值将作为参数传递给 callback 回调函数,同时异步调用并执行回调函数。

提示说明

  • 传递的 JavaScript object 对象属性必须与 Applab 表数据存储里列名相一致。注意名称是大小写敏感的。
  • updateRecord() 有一个异步 callback 回调函数,是因为它需要访问远程数据存储,并不会立刻获得返回结果。通过使用异步回调函数,主代码无需等待。请求结果返回后在这个回调函数里异步处理。
  • callback 回调函数可以是一个内联函数,也可以是在应用程序中单独定义并被 updateRecord() 调用的函数。
  • 通常不要将包含异步调用的函数如:updateRecord() ,放在循环里执行。因为循环里不会等异步调用结束才继续执行。
  • 通常与这些方法:createRecord()readRecords() 以及 deleteRecord() 实现对表数据记录的查看、删除以及更新。

查看更多少儿编程教程、JavaScript 介绍

返回文档首页