LeanCloud数据存储

东哥笔记

2016-09-26

LeanCloud数据存储

数据存储（LeanStorage）是 LeanCloud 提供的核心功能之一，它的使用方法与传统的关系型数据库有诸多不同,下面我们将其与传统数据库的使用方法进行对比。

下面这条 SQL 语句在绝大数的关系型数据库都可以执行，其结果是在 Todo 表里增加一条新数据：

INSERT INTO Todo (title, content) VALUES ('工程师周会', '每周工程师会议，周一下午 2 点')

使用传统的关系型数据库作为应用的数据源几乎无法避免以下步骤：

插入数据之前一定要先创建一个表结构，并且随着之后需求的变化，开发者需要不停地修改数据库的表结构，维护表数据。
每次插入数据的时候，客户端都需要连接数据库来执行数据的增删改查（CRUD）操作。使用 LeanStorage，实现代码如下:

// 声明一个 Todo 类型
  var Todo = AV.Object.extend('Todo');
  // 新建一个 Todo 对象
  var todo = new Todo();
  todo.set('title', '工程师周会');
  todo.set('content', '每周工程师会议，周一下午2点');
  todo.save().then(function (todo) {
    // 成功保存之后，执行其他逻辑.
    console.log('New object created with objectId: ' + todo.id);
  }, function (error) {
    // 失败之后执行其他逻辑
    console.log('Failed to create new object, with error message: ' + error.message);
  });

使用 LeanStorage 的特点在于：

不需要单独维护表结构。例如，为上面的 Todo 表新增一个 location 字段，用来表示日程安排的地点，那么刚才的代码只需做如下变动：

var Todo = AV.Object.extend('Todo');
  var todo = new Todo();
  todo.set('title', '工程师周会');
  todo.set('content', '每周工程师会议，周一下午2点');
  // 只要添加这一行代码，服务端就会自动添加这个字段
  todo.set('location','会议室');
  todo.save().then(function (todo) {
    // 成功保存之后，执行其他逻辑.
  }, function (error) {
    // 失败之后执行其他逻辑
  });

数据可以随用随加，这是一种无模式化（Schema Free）的存储方式。
所有对数据的操作请求都通过 HTTPS 访问标准的 REST API 来实现。
我们为各个平台或者语言开发的 SDK 在底层都是调用统一的 REST API，并提供完整的接口对数据进行增删改查。

LeanStorage 在结构化数据存储方面，与 DB 的区别在于：

1.Schema Free／Not free 的差异

2.数据接口上，LeanStorage 是面向对象的（数据操作接口都是基于 Object 的），开放的（所有移动端都可以直接访问），DB 是面向结构的，封闭的（一般在 Server 内部访问）；

3.数据之间关联的方式，DB 是主键外键模型，LeanStorage 则有自己的关系模型（Pointer、Relation 等）；

LeanStorage 支持两种存储类型：对象和文件

下面主要说一下如何存储对象,代码如下:

// 该语句应该只声明一次
  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) {
    // 失败
  });

现在我们保存一个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（优先级）之外，其他字段都是数据表的内置属性。

注意:

属性名:

也叫键或 key，必须是由字母、数字或下划线组成的字符串；自定义的属性名，不能以双下划线开头。

属性值:

可以是字符串、数字、布尔值、数组或字典。

以下为系统保留字段，不能作为属性名来使用。
acl             error            pendingKeys
ACL             fetchWhenSave    running
className       id               updatedAt
code            isDataReady      uuid
createdAt       keyValues
description     objectId

提高代码的可读性和可维护性，建议使用驼峰式命名法（CamelCase）为类和属性来取名。类，采用大驼峰法，如CustomData. 属性，采用小驼峰法，如 imageUrl.

注意在测试之前要把下面这行代码加入到你的index.html页面中：

<script src="http://cdn1.lncld.net/static/js/av-min-1.2.1.js"></script>

下载到本地直接引用也可以,我是下载本地放到lib文件中按下面方式直接引用的:

<script src="../lib/av-min-1.2.1.js"></script>

进行代码初始化后加入这行代码，就可以创建 class 或任何其他操作了。创建应用后, 可以在控制台-应用设置里面找到应用对应的 appId 和 appKey。然后在路由文件中添加如下代码进行初始化:

app.run(function(){
//应用ID用来识别应用
    var APP_ID = 'RaXOd37qSYs8fKCN82nbC9zd-gzGzoHsz';
//应用Key,用来校验权限(Web端可以配置安全域名来保护数据安全)
    var APP_KEY = 'SMJDrjpJOmuyEuTXjm5lW2BM';
//初始化
    AV.init({
        appId: APP_ID,
        appKey: APP_KEY
    })});

数据存储大数据 leancloud line-height object