在微信小程序中使用LeanCloud(1)

之前学习了微信小程序前端,使用到LeanCloud线上数据库作为一个前端开发人员,了解后端及数据库是学习工作的需要。

LeanCloud直接登录,未注册直接创建账户。它是一款免费的线上数据库(开发版免费)。适用于一些想自己写微信小程序前端但不太会后端的开发者学习用。本篇文章涉及数据存储服务(增删查改)。

首先,下载一个JavaScript-sdk :av-weapp-min.js,它是在微信小程序中使用此数据库的关键文件。下载之后,保存至项目路径,这里以/libs/av-weapp-min.js为例。在 app.js 中app({})函数之前使用 const AV = require('./libs/av-weapp-min.js'); 获得 AV 的引用。在其他文件中使用时请将路径替换成对应的相对路径。

//app.js
const AV = require('./libs/av-weapp-min.js');

在leanCloud里创建一个微信小程序应用(这里以蜗牛阅读为例子),然后在应用【存储】里创建一个表Class(这里以 ‘Books’ 为例),也可以直接通过设置数据的代码后台直接生成Class。

然后,初始化,在app.js 文件里app({})函数之前添加此代码。其中 APP_ID 和 APP_KEY 可以在此应用里的【设置】-【应用 key】里查看。

//文件 app.js
var APP_ID = 'xTM1XXfTJrTqRpbzcSI30HFj-gzGzoHsa';
var APP_KEY = 'Pb3PLtbjqWRP5aXKHvGfD6kB';
AV.init({
 appId: APP_ID,
 appKey: APP_KEY
});

接下里就可以实现数据存储了,是不是很轻松。它就像一个黑匣子,对前端开发人员来说,并不需要知道它是怎么实现增删查改的,只需要使用它的方法即可

保存对象

构建一个 AV.object 可以使用如下方法:

// AV.Object.extend('className') 所需的参数 className 则表示对应的表名
 // 声明一个类型
 var Todo = AV.Object.extend('Books');
 如果Books这个Class没有创建,下面代码将会既实现创建操作又实现添加数据操作:

// 声明类型
 var books= AV.Object.extend('Books');
 // 新建对象
 var book= new books();
 // 设置名称
 book.set('name','工作');
 // 设置优先级
 book.set('priority',1);
 book.save().then(function (todo) {
   console.log('objectId is ' + todo.id);
 }, function (error) {
   console.error(error);
 });

获取对象

每个被成功保存在云端的对象会有一个唯一的 Id 标识 id,因此获取对象的最基本的方法就是根据 id 来查询:

var query = new AV.Query('Books');
 query.get('57328ca079bc44005c2472d0').then(function (todo) {
   // 成功获得实例
   // todo 就是 id 为 57328ca079bc44005c2472d0 的 Books 对象实例
 }, function (error) {
   // 异常处理
 });
 访问对象的属性:

var query = new AV.Query('Books');
 query.get('558e20cbe4b060308e3eb36c').then(function (todo) {
   // 成功获得实例
   // todo 就是 id 为 558e20cbe4b060308e3eb36c 的 Books 对象实例
   var priority = todo.get('priority');
   var location = todo.get('location');
   var title = todo.get('title');
   var content = todo.get('content');

   // 获取三个默认属性   每个对象数据都有默认属性
   var objectId = todo.id;
   var updatedAt = todo.updatedAt;
   var createdAt = todo.createdAt;

   //Wed May 11 2016 09:36:32 GMT+0800 (CST)
   console.log(createdAt);
 }, function (error) {
   // 异常处理
   console.error(error);
 });

如果需要一次性获取返回对象的所有属性(比如进行数据绑定)而非显式地调用 get(属性名),可以利用 AV.Object 实例的 toJSON() 方法(需要 leancloud-storage@^3.0.0 以上版本)来得到一个 plain object。

var query = new AV.Query('Books');
 query.get('558e20cbe4b060308e3eb36c').then(function (todo) {
   console.log(todo.toJSON())

   // ==== console 中的结果 ====
   // content: "每周工程师会议,周一下午2点"
   // createdAt: "2017-03-08T11:25:07.804Z"
   // location: "会议室"
   // objectId: "558e20cbe4b060308e3eb36c"
   // priority: 1
   // title: "工程师周会"
   // updatedAt: "2017-03-08T11:25:07.804Z"

 }).catch(function (error) {
   // 异常处理
   console.error(error);
 });

数据更新

LeanStorage 上的更新对象都是针对单个对象,云端会根据有没有 objectId 来决定是新增还是更新一个对象。更新操作是覆盖式的,云端会根据最后一次提交到服务器的有效请求来更新数据。

假如 id 已知,则可以通过如下接口从本地构建一个 AV.Object 来更新这个对象:

// 第一个参数是 className,第二个参数是 objectId
  var book= AV.Object.createWithoutData('Books', '5745557f71cfe40068c6abe0');
  // 修改属性
  book.set('content', '每周工程师会议,本周改为周三下午3点半。');
  // 保存到云端
  book.save();

通过使用 保存选项 query 可以按照指定条件去更新对象——当条件满足时,执行更新;条件不满足时,不执行更新。

引用它的例子: 用户的账务账户表 Account 有一个余额字段 balance,同时有多个请求要修改该字段值,为避免余额出现负值,只有满足 balance >= 当前请求的数值 这个条件才允许修改,否则提示「余额不足,操作失败!」。

var Account = AV.Object.extend('Account');
  new AV.Query(Account).first().then(function(account) {
    var amount = -100;
    account.increment('balance', amount);
    return account.save(null, {
      query: new AV.Query(Account).greaterThanOrEqualTo('balance', -amount),
      fetchWhenSave: true,
    });
  }).then(function(account) {
    // 保存成功
    console.log('当前余额为:', account.get('balance'));
  }).catch(function(error) {
    if (error.code === 305) {
    console.log('余额不足,操作失败!');
    }
  });

删除对象

假如某一个 book 完成了,用户想要删除这个 book 对象,可以如下操作:

 var book= AV.Object.createWithoutData('Books', '57328ca079bc44005c2472d0');
  book.destroy().then(function (success) {
    // 删除成功
  }, function (error) {
    // 删除失败
  });
  为了减少网络交互的次数太多带来的时间浪费,你可以在一个请求中对多个对象进行创建、更新、删除、获取。接口都在 AV.Object 这个类下面:

 var objects = []; // 构建一个本地的 AV.Object 对象数组

   // 批量创建(更新)
  AV.Object.saveAll(objects).then(function (objects) {
    // 成功
  }, function (error) {
    // 异常处理
  });
  // 批量删除
  AV.Object.destroyAll(objects).then(function () {
    // 成功
  }, function (error) {
    // 异常处理
  });
  // 批量获取
  AV.Object.fetchAll(objects).then(function (objects) {
    // 成功
  }, function (error) {
    // 异常处理
  });
//查询一些对象,统一更新
var query = new AV.Query('Todo');
  query.find().then(function (todos) {
    todos.forEach(function(todo) {
      todo.set('status', 1);
    });
    return AV.Object.saveAll(todos);
  }).then(function(todos) {
    // 更新成功
  }, function (error) {
    // 异常处理
  });

以上是本次微信小程序学习中使用到的一些leanCloud数据库操作。希望对各位看官有帮助。

有问题反馈加微信:mue233 私聊问我 微信公众号:焦虑自愈教程,分享过去走出来的经验
52软件资源库 » 在微信小程序中使用LeanCloud(1)