AV.Object 是 LeanStorage 对复杂对象的封装,每个 AV.Object 包含若干属性值对,也称键值对(key-value)。属性的值是与 JSON 格式兼容的数据。通过 REST API 保存对象需要将对象的数据通过 JSON 来编码。这个数据是无模式化的(Schema Free),这意味着你不需要提前标注每个对象上有哪些 key,你只需要随意设置 key-value 对就可以,云端会保存它。
数据类型:
AV.Object 支持以下类型:
// 该语句应该只声明一次
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) {
// 失败
});
注:每个 AV.Object 的大小都不应超过 128 KB。如果需要储存更多的数据,建议使用 AV.File。
构建对象:
构建一个AV.Object对象可以使用以下方式:
// AV.Object.extend('className') 所需的参数 className 则表示对应的表名
// 声明一个类型
var Todo = AV.Object.extend('Todo');
注:每个 id 必须有一个 Class 类名称,这样云端才知道它的数据归属于哪张数据表。
保存对象:
现在我们保存一个 TodoFolder,它可以包含多个 Todo,类似于给行程按文件夹的方式分组。我们并不需要提前去后台创建这个名为 TodoFolder 的 Class 类,而仅需要执行如下代码,云端就会自动创建这个类:
// 声明类型
var TodoFolder = AV.Object.extend('TodoFolder');
// 新建对象
var todoFolder = new TodoFolder();
// 设置名称
todoFolder.set('name','工作');
// 设置优先级
todoFolder.set('priority',1);
todoFolder.save().then(function (todo) {
console.log('objectId is ' + todo.id);
}, function (error) {
console.log(error);
});
创建完成后,打开 控制台 > 存储,点开 TodoFolder 类,就可以看到刚才添加的数据。除了 name、priority(优先级)之外,其他字段都是数据表的内置属性。
内置属性 | 类型 | 描述 |
---|---|---|
id | String | 该对象唯一的Id标识 |
ACL | ACL | 该对象的权限控制,实际上是一个 JSON 对象,控制台做了展现优化。 |
createdAt | Date | 该对象被创建的 UTC 时间,控制台做了针对当地时间的展现优化。 |
updatedAt | Date | 该对象最后一次被修改的时间 |
属性名
也叫键或 key,必须是由字母、数字或下划线组成的字符串;自定义的属性名,不能以 __(双下划线)开头。
属性值
可以是字符串、数字、布尔值、数组或字典。
以下为系统保留字段,不能作为属性名来使用。
acl error pendingKeys
ACL fetchWhenSave running
className id updatedAt
code isDataReady uuid
createdAt keyValues
description objectId
使用CQL语法保存对象
// 执行 CQL 语句实现新增一个 TodoFolder 对象
AV.Query.doCloudQuery('insert into TodoFolder(name, priority) values("工作", 1)').then(function (data) {
// data 中的 results 是本次查询返回的结果,AV.Object 实例列表
var results = data.results;
}, function (error) {
//查询失败,查看 error
console.log(error);
});