leadcloud數(shù)據(jù)存儲(chǔ)開發(fā)指南(三)-Js篇

AV.Object 是 LeanStorage 對(duì)復(fù)雜對(duì)象的封裝,每個(gè) AV.Object 包含若干屬性值對(duì),也稱鍵值對(duì)(key-value)。屬性的值是與 JSON 格式兼容的數(shù)據(jù)。通過 REST API 保存對(duì)象需要將對(duì)象的數(shù)據(jù)通過 JSON 來編碼。這個(gè)數(shù)據(jù)是無模式化的(Schema Free),這意味著你不需要提前標(biāo)注每個(gè)對(duì)象上有哪些 key,你只需要隨意設(shè)置 key-value 對(duì)就可以,云端會(huì)保存它。

數(shù)據(jù)類型:
AV.Object 支持以下類型:

 // 該語句應(yīng)該只聲明一次
  var TestObject = AV.Object.extend('DataTypeTest');

  var number = 2014;
  var string = 'famous film name is ' + number;
  var date = new Date();
  var array = [string, number];
  var object = { number: number, string: string };

  var testObject = new TestObject();
  testObject.set('testNumber', number);
  testObject.set('testString', string);
  testObject.set('testDate', date);
  testObject.set('testArray', array);
  testObject.set('testObject', object);
  testObject.set('testNull', null);
  testObject.save().then(function(testObject) {
    // 成功
  }, function(error) {
    // 失敗
  });

注:每個(gè) AV.Object 的大小都不應(yīng)超過 128 KB。如果需要儲(chǔ)存更多的數(shù)據(jù),建議使用 AV.File。

構(gòu)建對(duì)象:
構(gòu)建一個(gè)AV.Object對(duì)象可以使用以下方式:

 // AV.Object.extend('className') 所需的參數(shù) className 則表示對(duì)應(yīng)的表名
  // 聲明一個(gè)類型
  var Todo = AV.Object.extend('Todo');

注:每個(gè) id 必須有一個(gè) Class 類名稱,這樣云端才知道它的數(shù)據(jù)歸屬于哪張數(shù)據(jù)表。

保存對(duì)象:
現(xiàn)在我們保存一個(gè) TodoFolder,它可以包含多個(gè) Todo,類似于給行程按文件夾的方式分組。我們并不需要提前去后臺(tái)創(chuàng)建這個(gè)名為 TodoFolder 的 Class 類,而僅需要執(zhí)行如下代碼,云端就會(huì)自動(dòng)創(chuàng)建這個(gè)類:

  // 聲明類型
  var TodoFolder = AV.Object.extend('TodoFolder');
  // 新建對(duì)象
  var todoFolder = new TodoFolder();
  // 設(shè)置名稱
  todoFolder.set('name','工作');
  // 設(shè)置優(yōu)先級(jí)
  todoFolder.set('priority',1);
  todoFolder.save().then(function (todo) {
    console.log('objectId is ' + todo.id);
  }, function (error) {
    console.log(error);
  });

創(chuàng)建完成后,打開 控制臺(tái) > 存儲(chǔ),點(diǎn)開 TodoFolder 類,就可以看到剛才添加的數(shù)據(jù)。除了 name、priority(優(yōu)先級(jí))之外,其他字段都是數(shù)據(jù)表的內(nèi)置屬性。

內(nèi)置屬性 類型 描述
id String 該對(duì)象唯一的Id標(biāo)識(shí)
ACL ACL 該對(duì)象的權(quán)限控制,實(shí)際上是一個(gè) JSON 對(duì)象,控制臺(tái)做了展現(xiàn)優(yōu)化。
createdAt Date 該對(duì)象被創(chuàng)建的 UTC 時(shí)間,控制臺(tái)做了針對(duì)當(dāng)?shù)貢r(shí)間的展現(xiàn)優(yōu)化。
updatedAt Date 該對(duì)象最后一次被修改的時(shí)間

屬性名
也叫鍵或 key,必須是由字母、數(shù)字或下劃線組成的字符串;自定義的屬性名,不能以 __(雙下劃線)開頭。
屬性值
可以是字符串、數(shù)字、布爾值、數(shù)組或字典。

以下為系統(tǒng)保留字段,不能作為屬性名來使用。
acl             error            pendingKeys
ACL             fetchWhenSave    running
className       id               updatedAt
code            isDataReady      uuid
createdAt       keyValues
description     objectId

使用CQL語法保存對(duì)象

 // 執(zhí)行 CQL 語句實(shí)現(xiàn)新增一個(gè) TodoFolder 對(duì)象
  AV.Query.doCloudQuery('insert into TodoFolder(name, priority) values("工作", 1)').then(function (data) {
    // data 中的 results 是本次查詢返回的結(jié)果,AV.Object 實(shí)例列表
    var results = data.results;
  }, function (error) {
    //查詢失敗,查看 error
    console.log(error);
  });
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容