简介

Bmob平台为您的移动应用提供了一个完整的后端解决方案，我们提供轻量级的SDK开发包，让开发者以最小的配置和最简单的方式使用Bmob平台提供的服务，进而完全消除开发者编写服务器代码以及维护服务器的操作。

典型案例

Bmob示例包含常用接口（学习示例）：https://github.com/magic007/wechatAppDemo （采用实时数据同步SDK开发，里面几乎包含了小程序开发常见功能示例代码，右击可直接查看源码）
扫描二维码查看

心邮（官方线上项目）：https://github.com/bmob/Bmob-wechatapp-xinyou （采用实时数据同步SDK开发，右击可直接查看源码）

• 1.生日工具 ———-工具类
• 2.足迹地图
• 3.接力喵视频 ———-视频类
• 4.像素涂鸦
• 5.地道美食地图 ———-LBS
• 6.胖熊圈
• 7.有货Hk
• 8.厦漳泉生活通 ———-本地生活
• 9.极简笔记
• 10.衣在线 ———-商城
• 11.活动报名表 ———-工具类
• 12.味蕾点餐 ———-点餐
• 13.烟台微拼 ———-本地生活
• 14.顺德便利贴
• 15.同城生活广告
• 16.点点英语学堂
• 17.朝露时刻 ———-音频类
• 18.青岛一起秀科学俱乐部
• 19.纸塘 ———-17年6月最热门的小程序
• 20.雷湖古琴艺术
• 21.皋城文明随手拍 ——-政府
• 22.阅后即焚图片分享
• 23.猎位共享停车
• 24.听写宝
• 25.嘿车出行
• 26.喵星人宠物社区
• 27.标签生成器
• 28.视频看房
• 29.海南黎家特产
• 30.轩宇工具
• 31.在旅途看世界
• 32.寻遍美食地图
• 33.Bmob示例
• 34.鲁山拼车
• 33.莲馨图书室 图书馆-扫描借书
• 34.灵动云课堂
• 35.9cam 视频类
• 36.恋爱迹
• 37.融信品质生活服务
• 38.全民摄影秀
• 39.农电微服务 国家电网公司
• 40.壁纸印象
• 41.跟妆师
• 42.高能名片
• 43.婚纱lite
• 44.张阿姨打扫
• 45.吃决策
• 46.比心比价
• 47.蜂鸟作业 教育
• 48.美味面包lite
• 51.幸福的5班
• 52.大武汉公交 交通
• 53.Buy优选 淘客
• 54.码赚
• 55.附近的圈子
• 56.吴忠意大利冰淇淋 实体店点餐
• 57.摩西讲单词 教育
• 58.贝莱福居
• 59.花间集鲜花
• 60.柏亚阅读书吧
• 61.找我跑腿服务
• 62.橙色工地圈
• 63.大学城活动报名
• 64.聚合助手
• 65.圆桌绿色版
• 66.我的王者名片
• 67.趣猫
• 68.管图智能选座 大学图书馆
• 69.呼伦贝尔二手车平台
• 70.我的王者名片
• 71.万能服 答题应用

  官方交流QQ群：118541934 。欢迎提交给我们

应用程序

在Bmob平台注册后，每个账户可创建多个应用程序，创建的每个应用程序都有其独自的应用程序ID，此后所有的应用程序将凭其ID进行Bmob SDK的使用。即使只有一个应用程序，也可以以不同的版本进行测试和生产。

对象

数据对象

Bmob数据存储是建立在Bmob.Object基础上的。如写日记的Bmob.Object示例如下：

title: "I am title", content: "I am content"

这里需要注意的是：anchor

• 键必须是字母或者数字的字符串，值可以是字符串、数字、布尔值或者数组和字典。
• 每一个Bmob.Object都是一个特定子类的实例，子类名可以来区分各种数据，如我们可以把写日记的类称之为diary。

创建对象

你可以使用Bmob.Object.extend方法来创建新的Bmob.Object子类，示例代码如下：

    // 创建Bmob.Object子类
    var Diary = Bmob.Object.extend("diary");
    // 创建该类的一个实例
    var diary = new Diary();

如果你想为Bmob.Object的子类添加一些实例方法和类方法，示例代码如下：

    // 为Bmob.Object的子类添加实例方法和类方法
    var Diary = Bmob.Object.extend("diary", {
      //实例方法
      gleaterThanOneHundred: function() {
        return this.get("title");
      }
    }, {
      //类方法
      spawn: function(title) {
        var diary = new Diary();
        diary.set("title", title);
        return diary;
      }
    });
    var diary = Diary.spawn("hello world");
    console.log(diary.gleaterThanOneHundred());

小程序使用图文素材

图文素材，类似微信的图文素材，经常被用在活动、广告、详细说明等情况。
使用图文素材系统会生成一个_Article 的数据表。如需取出图文素材的数据，只需跟普通表一样操作即可。

增加一篇图文

   var Diary = Bmob.Object.extend("_Article");
      var diary = new Diary();
      diary.set("title","hello");
      diary.set("content","hello world");
      //添加数据，第一个入口参数是null
      diary.save(null, {
        success: function(result) {
          // 添加成功，返回成功之后的objectId（注意：返回的属性名字是id，不是objectId），你还可以在Bmob的Web管理后台看到对应的数据
            console.log("创建成功, objectId:"+result.id);
        },
        error: function(result, error) {
          // 添加失败
          console.log('创建失败');
        }
      });

静态文件

为了满足应用各类需求，保存的内容会生成一个HTML文件，存在您的文件中，如应用支持显示HTML，可直接显示，或者url内容转发到朋友圈。

ps:最近小程序也推出了显示H5页面，如果需要使用，可开通FTP功能自己管理应用的文件空间。

下载域名

由于最近微信封了*.upaiyun.com 域名，如果你没做文件下载功能，只是显示图片，可以不填写。如果你需要做下载功能，在应用设置里面，可以开启独立域名， 开启后，填写到微信平台就好了，当然有时候你想用自己的域名，也是可以的，可以工单联系我们。

客服消息

对一些应用有嵌入微信客服消息，需要主动实时收到用户反馈，并希望手机可以回复消息的，可以基于云逻辑开发此功能，如果完全不想写代码实现也可以联系我们,出一定费用整套客服系统帮上线。

简介地址：http://www.jianshu.com/p/540a8db78fbf

WebSocket

一个微信小程序同时只能有一个 WebSocket 连接，如果当前已存在一个 WebSocket 连接，会创建失败。WebSocket可以做一些实时数据功能，比如聊天室，你画我猜之类的游戏。具体文档参考JavaScript->实时数据平台

微信主人通知接口

微信主动推送通知，业务场景：比如你有APP，有人下单了，或者有人留言了。你可以收到微信推送通知。

支持2种调用方法
1.小程序
2.restful

1.小程序Bmob.sendMasterMessage调用主人通知接口

成功后发送主人模板消息，这个只需把openid改正确即可接收到， Bmob后端云公众号回复openid
          var temp = {
            "touser": "oUxY3w_jURG89H5wCIvJDPjJ5s2o",
            "template_id": "-ERkPwp0ntimqH39bggQc_Pj55a18CYLpj-Ert8-c8Y",
            "url": "https://www.bmob.cn/",
            "data": {
              "first": {
                "value": "您好，Restful 失效，请登录控制台查看。",
                "color": "#c00"
              },
              "keyword1": {
                "value": "Restful 失效"
              },
              "keyword2": {
                "value": "2017-07-03 16:13:01"
              },
              "keyword3": {
                "value": "高"
              },
              "remark": {
                "value": "如果您十分钟内再次收到此信息，请及时处理。"
              }
            }
          }
          console.log(temp);
          Bmob.sendMasterMessage(temp).then(function (obj) {
            console.log('发送成功');
          }, function (err) {
            common.showTip('失败' + err);
          });

2.restful调用方式

curl --request POST \
  --url http://api.bmob.cn/1/wechatApp/notifyMsg \
  --header 'content-type: application/json' \
  --header 'x-bmob-application-id: ' \
  --header 'x-bmob-rest-api-key: ' \
  --data '{\n    "touser": "oUxY3w_jURG89H5wCIvJDPjJ5s2o",\n    "template_id":"-ERkPwp0ntimqH39bggQc_Pj55a18CYLpj-Ert8-c8Y",\n    "url": "http://www.bmob.cn/",\n    "data": {\n        "first": {\n            "value": "您好，Restful 失效，请登录控制台查看。",\n            "color": "#c00"\n        },\n        "keyword1": {\n            "value": "Restful 失效"\n        },\n        "keyword2": {\n            "value": "2017-07-03 16:13:01"\n        },\n        "keyword3": {\n            "value": "高"\n        },\n        "remark": {\n            "value": "如果您十分钟内再次收到此信息，请及时处理。"\n        }\n    }\n}'

PS:openid 关注Bmob后端云公众平台回复openid

开放3个模板：
1.新订单通知（template_id：K9-6_Ayj4MLC2yvwY60-cq18tngJHAlqDfsOvv3D7a8
）

{{first.DATA}}
提交时间：{{tradeDateTime.DATA}}
订单类型：{{orderType.DATA}}
客户信息：{{customerInfo.DATA}}
{{orderItemName.DATA}}：{{orderItemData.DATA}}
{{remark.DATA}}

2.系统报警通知（template_id：-ERkPwp0ntimqH39bggQc_Pj55a18CYLpj-Ert8-c8Y
）

{{first.DATA}}
系统名称：{{keyword1.DATA}}
报警时间：{{keyword2.DATA}}
报警级别：{{keyword3.DATA}}
{{remark.DATA}}

3.购买成功通知（template_id：Mbk3kYqRGkL98ch6Lie4XSXtOsxXj2SC0SRQXd89G1Y
）

您好，您已购买成功。
商品信息：{{name.DATA}}
{{remark.DATA}}

4.审核结果通知（template_id：aNNNmi7WK4kohleWhCkDRKJiHOZnIpkrhXx5XPx4dx0
）

{{first.DATA}}
账号名称：{{keyword1.DATA}}
审核状态：{{keyword2.DATA}}
审核时间：{{keyword3.DATA}}
{{remark.DATA}}

ps：目前每个应用，每天有100条的免费额度，如需更多，可以工单联系我们

生成小程序二维码

生成推广二维码非常简单，比如你是传统企业，你可以为你店里每件衣服生成一个二维码，用户扫描直接可以付款定位到那件衣服，如果你是餐厅老板，客户在桌子上扫描二维码可以定位那张桌子。如果你是互联网企业，你可以发布二维码到朋友圈，可以定位到是谁推荐了这个用户，这个用户上级是谁，等等。Bmob封装了生成二维码函数，以下示例代码。

Bmob.generateCode 参数列表

更多微信官方小程序码介绍 微信官方小程序码介绍

formSubmit: function (event) {
        var path = event.detail.value.path; //路径
        var width = event.detail.value.width; //宽度
        var that = this;
        Bmob.generateCode({ "path": path, "width": width }).then(function (obj) {
            console.log(obj);
            that.setData({
                imageBytes: obj.imageBytes  //二维码示例
            })
        }, function (err) {
            //失败
        });
    }

小程序分享群Id

有些时候，我们小程序需要把内容分享到微信群，统计每个微信群有多少用户来查看了此信息。可以使用此接口，下面是微信官方的2个说法

当用户成功地将小程序页面分享到微信群的时候，小程序的回调中可以获取分享目标的微信群 ID。
当用户从微信群进入小程序页面的时候，小程序启动时可以获取用户进入小程序的渠道群聊 ID。

Page({
  onLoad () {
    wx.showShareMenu({
      withShareTicket: true //要求小程序返回分享目标信息
    })
  },
  // 其他的页面函数、生命周期函数等
  onShareAppMessage() {
    return {
      title: '页面分享标题',
      path: '/pages/path/to/target',
      success(res){
        console.log(res.shareTickets);
                wx.getShareInfo({
          shareTicket: res.shareTickets,
          complete(res) {
            //内部调用云函数
            var currentUser = Bmob.User.current();
            var data = { "objectId": currentUser.id, "encryptedData": res.encryptedData, "iv": res.iv};
            console.log(data);
            // console.log(data);
            Bmob.Cloud.run('getOpenGId', data).then(function (obj) {
              // var res = JSON.parse(obj)
              console.log(obj)
            }, function (err) {
              console.log(err)
            });
          }
        })
      }
    }
  }
}

页面只要加上这2个函数，即可实现转发到群功能，这里主要讲下解密群ID。

解密群ID主要是通过云逻辑来实现，这里添加一个getOpenGId 逻辑。你也可以复制腾讯官方提供的nodejs里面的代码

function onRequest(request, response, modules) {
    var objectId = request.body.objectId;
    var db = modules.oData;
    var crypto = modules.crypto;
    db.findOne({
        "table": "_User",
        //表名
        "objectId": objectId //记录的objectId
    },
    function(err, data) {
        //回调函数
        var data = JSON.parse(data);
        var sessionkey = data.authData.weapp.session_key;   //微信最新版本改版，此id是由前端发送过来
        var encryptedData = request.body.encryptedData;
        var iv = request.body.iv
        var groupid = groupIdParse(modules, sessionkey, encryptedData, iv) response.end(groupid);
    });
    function groupIdParse(modules, sessionKey, encryptedData, iv) {
        var crypto = modules.oCrypto;
        var sessionKey = new Buffer(sessionKey, 'base64'); //new Base64().decode(sessionKey);
        encryptedData = new Buffer(encryptedData, 'base64'); //new Base64().decode(encryptedData);
        iv = new Buffer(iv, 'base64'); //new Base64().decode(iv)
        var result = '';
        try {
            // 解密
            var decipher = crypto.createDecipheriv('aes-128-cbc', sessionKey, iv)
            // 设置自动 padding 为 true，删除填充补位
            decipher.setAutoPadding(true) var decoded = decipher.update(encryptedData, 'binary', 'utf8') decoded += decipher.final('utf8') result = decoded;
            // decoded = JSON.parse(decoded)
        } catch(err) {
            throw new Error('Illegal Buffer123' + err)
        }
        //  if (decoded.watermark.appid !== this.appId) {
        //     //  throw new Error('Illegal Buffer')
        // }
        return result;
    }
}

解密返回数据：{"openGId":"GLfcX0ber2CAPtXng-ac4g8zyNmk","watermark":{"timestamp":1496720764,"appid":"wx77d6b7031c1e4763"}}

如果你的应用功能出现解密报错，你可以写死传过来的三个变量，示例：

var sessionKey="xTlW5jfSUP3Kx0vC5PJbmw==";
    var encryptedData="SLvbzyuyck7384tlGjXwI5Meb2LydIhUGvwerwsvJhws1EJb7LnFPX1MfRcTyF8Bfj0ZRP8wu8XR+7hmTqgdQx11nOlJA0RawSoTJNYmy9kfYQsdqTq5EX0rRH8VozPURnTrjM9EGbfqaN6EetI/aQ==";
    var iv="7/TqHciNjSi3cdFFxr97ww==";
    var groupid=groupIdParse(modules,sessionKey,encryptedData,iv)
    var jsongid=JSON.parse(groupid);
    response.end(groupid);
    return;

小程序模板消息

小程序模板消息首先是通过获取access_token来发送。access_token有效期2小时。

模板消息支持2种方式调用。

• 1.Restful
• 2.小程序

Restful

curl -X POST \
  http://api.bmob.cn/1/wechatApp/SendWeAppMessage \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/json' \
  -H 'x-bmob-application-id: XXX' \
  -H 'x-bmob-rest-api-key: XXX' \
  -d '{
     "touser": "osr4I0WBS4kZuD_5P-_-bxbSobTg",
        "template_id": "omTTRD3pAMiAGKmyKo15Ifc2U_wLr6oWRZOifnTngvQ",
        "page": "index",
        "form_id":"3a8c5659469c9a582c8fd65054ea5307",
        "data": {
          "keyword1": {
            "value": "SDK测试内容",
            "color": "#173177"
          },
      "keyword2": {
          "value": "2015年01月05日 12:30"
      },
      "keyword3": {
          "value": "Bmob科技"
      }
    }
    ,"emphasis_keyword": ""
}'

Restful主要用在一些特殊情况，例如审核后给用户发送一个通知，定时发通知等这种要配合云逻辑或自己服务端来使用。

小程序内部调用比较常用，使用门槛低

var currentUser = Bmob.User.current();
var temp = {
    "touser": currentUser.get("openid"),
    "template_id": "B-2GcobfYnptevxY8G3SdA72YLYGZpOoJO_FEHlouWg",
    "page": "",
    "form_id": formId,
    "data": {
        "keyword1": {
            "value": "SDK测试内容",
            "color": "#173177"
        },
        "keyword2": {
            "value": "199.00"
        },
        "keyword3": {
            "value": "123456789"
        },
        "keyword4": {
            "value": "2015年01月05日 12:30"
        },
        "keyword5": {
            "value": "恭喜您支付成功，如有疑问请反馈与我"
        }
    },
    "emphasis_keyword": "keyword1.DATA"
}
Bmob.sendMessage(temp).then(function(obj) {
    console.log('发送成功')
},
function(err) {
    common.showTip('失败' + err)
});

小程序短信验证码

方法调用与JavaScript一致，查看JavaScript 短信文档 请求短信验证码

小程序支付

小程序支付只需发起请求获取微信需要的字段，这里用Bmob.Pay.wechatPay获取nonceStr,packages,orderId等相关信息。然后 wx.requestPayment弹窗支付页面，里面处理成功失败。 （Bmob的接口都是独立的，任何平台小程序都可以使用，自需要小程序微信开通都支持。目前小程序支付跟其他有APP区别Bmob平台不收取任何手续费，只要是Bmob平台付费会员都可使用。）

//传参数金额，名称，描述,openid
    Bmob.Pay.wechatPay(0.01, '名称1', '描述', openId).then(function (resp) {
      console.log('resp');
      console.log(resp);
      that.setData({
        loading: true,
        dataInfo: resp
      })
      //服务端返回成功
      var timeStamp = resp.timestamp,
        nonceStr = resp.noncestr,
        packages = resp.package,
        orderId = resp.out_trade_no,//订单号，如需保存请建表保存。
        sign = resp.sign;
      //打印订单号
      console.log(orderId);
      //发起支付
      wx.requestPayment({
        'timeStamp': timeStamp,
        'nonceStr': nonceStr,
        'package': packages,
        'signType': 'MD5',
        'paySign': sign,
        'success': function (res) {
          //付款成功,这里可以写你的业务代码
          console.log(res);
        },
        'fail': function (res) {
          //付款失败
          console.log('付款失败');
          console.log(res);
        }
      })
    }, function (err) {
      console.log('服务端返回失败');
      common.showTip(err.message, 'loading',{},6000);
      console.log(err);
    });

添加数据

添加数据非常简单，任何Bmob.Object子类都有save方法可以用于将当前对象的内容保存到服务端。示例代码如下：

    //创建类和实例
    var Diary = Bmob.Object.extend("diary");
    var diary = new Diary();
    diary.set("title","hello");
    diary.set("content","hello world");
    //添加数据，第一个入口参数是null
    diary.save(null, {
        success: function(result) {
          // 添加成功，返回成功之后的objectId（注意：返回的属性名字是id，不是objectId），你还可以在Bmob的Web管理后台看到对应的数据
            console.log("日记创建成功, objectId:"+result.id);
        },
        error: function(result, error) {
          // 添加失败
          console.log('创建日记失败');
        }
    });

你也可以用如下的示例代码添加数据：

    var Diary = Bmob.Object.extend("diary");
    var diary = new Diary();
    // 添加数据，第一个入口参数是Json数据
    diary.save({
      title: "hello",
      content: "hello world"
    }, {
      success: function(result) {
        // 添加成功
      },
      error: function(result, error) {
        // 添加失败
      }
    });

这里有几点需要注意的是:

1. 如果云端数据库中不存在diary表，Bmob会自动地在你第一次使用它的时候创建。
2. 每个Bmob.Object对象都有几个默认的字段是自动创建的：objectId是一个对于每一个保存的对象为一个标志；createdAt和updatedAt表示对象在Bmob中创建和最后一次更改的时间。这些字段的创建和内容是由服务器端自动完成的，在保存Bmob.Object之前不会存在。
3. 添加成功后，可以通过result.createdAt获取对象的创建时间，通过result.updatedAt获取对象的更新时间；可以通过result.id获取对象的objectId。

查询数据

数据的查询是每个应用都会频繁使用到的，Bmob提供了Bmob.Object类，方便大家实现不同条件的查询。

查询所有数据

查询某个数据表中的所有数据是非常简单的，只需要使用Bmob.Query的find方法就可以了，示例代码如下：

var Diary = Bmob.Object.extend("diary");
var query = new Bmob.Query(Diary);
// 查询所有数据
query.find({
  success: function(results) {
    console.log("共查询到 " + results.length + " 条记录");
    // 循环处理查询到的数据
    for (var i = 0; i < results.length; i++) {
      var object = results[i];
      console.log(object.id + ' - ' + object.get('title'));
    }
  },
  error: function(error) {
    console.log("查询失败: " + error.code + " " + error.message);
  }
});

如果你只想要一个结果，一个更加方便的方法是使用first，而不是find方法，示例代码如下：

var Diary = Bmob.Object.extend("diary");
var query = new Bmob.Query(Diary);
query.first({
  success: function(object) {
    // 查询成功
  },
  error: function(error) {
    console.log("查询失败: " + error.code + " " + error.message);
  }
});

这里需要注意一点的是：
默认情况下，系统实际上并不会返回所有的数据，而是默认返回10条数据记录，你可以通过setLimit方法设置返回的记录数量。更多细节可点击查看分页查询一节。

获取对象的特殊属性

注意，在对象中获取objectId，createdAt，updatedAt的方法分别如下：
obj.id
obj.createdAt
obj.updatedAt

查询单条数据

当我们知道某条数据的objectId时，就可以根据objectId值直接获取单条数据对象，示例代码如下：

var Diary = Bmob.Object.extend("diary");
//创建查询对象，入口参数是对象类的实例
var query = new Bmob.Query(Diary);
//查询单条数据，第一个参数是这条数据的objectId值
query.get("82c3e62d2c", {
  success: function(result) {
    // 查询成功，调用get方法获取对应属性的值
    var title = result.get("title");
    var content = result.get("content");
  },
  error: function(object, error) {
    // 查询失败
  }
});

条件查询

如果要查询某个属性等于某个值，示例代码如下：

query.equalTo("title", "bmob");

如果要查询某个属性不等于某个值，示例代码如下：

query.notEqualTo("title", "bmob sdk");

如果要模糊查询某个值，示例代码如下（模糊查询目前只提供给付费套餐会员使用）：

query.equalTo("title", { "$regex": "" + k + ".*" });

查询大于某个日期的数据，示例代码如下
query.equalTo(“dateTime”, {“$gte”:{“__type”:”Date”,”iso”:”2011-08-21 18:02:52”}});

对查询的属性值进行大小比较的示例代码如下：

// score < 50
query.lessThan(列名称, 50);
// score <= 50
query.lessThanOrEqualTo(列名称, 50);
// score > 50
query.greaterThan(列名称, 50);
// score >= 50
query.greaterThanOrEqualTo(列名称, 50);

两条查询语句一起写，就相当于AND查询，如下示例代码，查询同时满足"playerName"="bmob" and "score">100的数据：

query.notEqualTo("title", "bmob");
query.greaterThan(列名称, 100);

一个完整的例子：

var Diary = Bmob.Object.extend("diary");
var query = new Bmob.Query(Diary);
query.equalTo("title", "hello");
// 查询所有数据
query.find({
    success: function(results) {
        console.log("共查询到 " + results.length + " 条记录");
        // 循环处理查询到的数据
        for (var i = 0; i < results.length; i++) {
        var object = results[i];
        console.log(object.id + ' - ' + object.get('title'));
        }
    },
    error: function(error) {
        console.log("查询失败: " + error.code + " " + error.message);
    }
});

分页查询

有时，在数据比较多的情况下，你希望查询出的符合要求的所有数据能按照多少条为一页来显示，这时可以使用limit方法来限制查询结果的数据条数来进行分页。默认情况下，Limit的值为10，最大有效设置值1000（设置的数值超过1000还是视为1000）。

// 返回最多10条数据
query.limit(10);

在数据较多的情况下，在limit的基础上分页显示数据是比较合理的解决办法，skip方法可以做到跳过查询的前多少条数据来实现分页查询的功能。默认情况下skip的值为10。

query.skip(10); // skip the first 10 results

结果排序

我们可以对返回的结果进行排序（只支持number，date，string类型的排序），示例代码如下：

// 对score字段升序排列
query.ascending(列名称);
// 对score字段降序排列
query.descending(列名称);

统计记录数量

如果你只是想统计满足query的结果集到底有多条记录，你可以使用count方法。如为了获得diary表的记录数量，示例代码如下：

var Diary = Bmob.Object.extend("diary");
var query = new Bmob.Query(Diary);
query.count({
  success: function(count) {
    // 查询成功，返回记录数量
    console.log("共有 " + count + " 条记录");
  },
  error: function(error) {
    // 查询失败
  }
});

复杂查询

如果你想查询某一字段值在某一集合中的记录的话，可以使用containedIn方法，如获取"Bmob"、"hello"、"sure"三条标题为这的记录信息，那么示例代码如下：

// 第一个参数是字段名称，第二个参数是数组
query.containedIn("title", ["Bmob", "hello", "sure"]);

相反地，你可以使用notContainedIn方法来查询在集合外的目标对象。

如果想要查询含有某一特定属性的对象，可以使用exists。相对地，如果你想获取没有这一特定属性的对象，你可以使用doesNotExist，示例代码如下：

// 查询含有title属性的对象
query.exists("title");
// 查询不含有title属性的对象
query.doesNotExist("title");

你可以使用matchesKeyInQuery方法来进行嵌套的子查询。举例说，如果你有一个类包含了用户心情， 而你在用户类中存储了用户的详细信息，你可以构造一个查询来查找被点赞次数超过5次的用户信息，示例代码如下：

var Diary = Bmob.Object.extend("diary");
var DiaryQuery = new Bmob.Query(Diary);
DiaryQuery.greaterThan("isLike",5);
var userQuery = new Bmob.Query(Bmob.User);
userQuery.matchesKeyInQuery("phone", "nickname", DiaryQuery);
userQuery.find({
  success: function(results) {
    // results has the list of users with all user with record
  }
});

相对地，可以使用doesNotMatchKeyInQuery来获取属性不在子查询结果中的对象。比如为了获得用户的日记被点赞不超过5次的情况：

var Diary = Bmob.Object.extend("diary");
var DiaryQuery = new Bmob.Query(Diary);
DiaryQuery.greaterThan("isLike",5);
var userQuery = new Bmob.Query(Bmob.User);
userQuery.doesNotMatchKeyInQuery("phone", "nickname", DiaryQuery);
userQuery.find({
  success: function(results) {
  }
});

查询指定列

有时候你不想返回所有的字段信息，那么就可以用select方法来限定返回的字段。示例代码如下：

var Diary = Bmob.Object.extend("diary");
var query = new Bmob.Query(Diary);
// 只返回score和playerName字段值
query.select("title");
query.find().then(function(results) {
  // 返回成功
});

注意：系统默认的字段objectId、createdAt、updatedAt、ACL也会返回。

对字符串类型做查询

如果想要查询以某一个特定字符串开头的记录，可以使用startWith方法，示例代码如下：

// 查询在title字段中以he开头的记录
var query = new Bmob.Query(Diary);
query.startsWith("title", "he");

或查询

你可以使用Bmob.Query.or方法操作或查询，示例代码如下：

var query1 = new Bmob.Query(Diary);
query1.greaterThan("isLike", 150);
var query2 = new Bmob.Query(Diary);
query2.lessThan("isLike", 5);
var mainQuery = Bmob.Query.or(query1, query2);
mainQuery.find({
  success: function(results) {
     // 返回 isLike > 150 or isLike < 5 的值
  },
  error: function(error) {
    // 返回失败
  }
});

注意：我们不会在组合查询的子查询中支持非过滤型的条件 (比如:limit,skip,ascending/descending,include)

修改数据

修改数据非常简单，首先需要获取到要更新的Bmob.Object对象，修改值后保存数据就可以了，示例代码如下：

var Diary = Bmob.Object.extend("diary");
var query = new Bmob.Query(Diary);
// 这个 id 是要修改条目的 id，你在
 这个存储并成功时可以获取到，请看前面的文档
query.get('3453453453fdsdf', {
    success: function(result) {
      // 回调中可以取得这个 GameScore 对象的一个实例，然后就可以修改它了
      result.set('title', 'test!');
      result.save();
      // The object was retrieved successfully.
    },
    error: function(object, error) {
    }
});

或者

var Diary = Bmob.Object.extend("diary");
var Diary = new Diary();
Diary.set("title", "111");
Diary.set("content", "222");
//添加数据
Diary.save(null, {
  success: function(result) {
    // 修改数据
    result.set("title", "111");
    result.set("content", "222");
    result.save();
  }
})

如果想更新成功后获取更新后的对象属性，请设置fetchWhenSave：

 //假设result是已经存在的对象
    result.fetchWhenSave(true);
    result.set("title", "111");
    result.set("content", "222");
    result.save();

删除数据

删除数据可以使用Bmob.Object的destroy方法，示例代码如下：

myObject.destroy({
  success: function(myObject) {
    // 删除成功
  },
  error: function(myObject, error) {
    // 删除失败
  }
});

批量删除对象的示例代码如下：

//单个请求每次最多删除50条。
 var query = new Bmob.Query('diary');
 query.equalTo("title", "后端云");
          query.find().then(function (todos) {
            return Bmob.Object.destroyAll(todos);
          }).then(function (todos) {
            console.log(todos);
            // 删除成功
          }, function (error) {
            // 异常处理
          });

如果你想将查询出来的对象都删除，或者删除符合查询条件的所有对象，可以调用destroyAll方法，示例代码如下：

query.destroyAll({
   success: function(){
      //删除成功
   },
   error: function(err){
      // 删除失败
   }
   });

删除字段

你可以使用unset方法在删除一个字段：

// 删除playerName字段
myObject.unset("title");
myObject.save();

常见数据类型的操作

var number = 42;
var string = "the number is " + number;
var date = new Date();
var array = [string, number];
var object = { number: number, string: string };
var bigObject = new BigObject();
bigObject.set("myNumber", number);
bigObject.set("myString", string);
bigObject.set("myDate", date);
bigObject.set("myArray", array);
bigObject.set("myObject", object);
bigObject.set("myNull", null);
bigObject.save();

数组操作

添加及更新数组

为了帮你存储数组类数据，有三种操作你可以原子性地改动一个数组，这需要一个给定的 key：

• add在一个数组的末尾加入一个给定的对象。
• addUnique只会把原本不存在的对象加入数组，所以加入的位置没有保证。

比如, 我们想在数组”DiaryType”中加入日记类型：

Diary.addUnique("DiaryType", "public");
Diary.addUnique("DiaryType", "secret");
Diary.save();

数组查询

对于value是数组的情况，你可以这样查询数组中的值有2的情况的对象：

// Find objects where the array in DiaryType contains public.
query.equalTo("DiaryType","public");

你同样可以用下面的方式找到同时包含元素2、3、4的数组：

// Find objects where the array in DiaryType contains all of the elements public,secret.
query.containsAll("DiaryType", ["public","secret"]);

删除数组

remove在一个数组中删除所有指定的所有实例：

var Diary = Bmob.Object.extend("diary");
var query = new Bmob.Query(Diary);
query.get("bc5da708dc",{
  success: function(result) {
    result.remove("DiaryType","public");
    result.save();
  },
  error: function(error) {
    console.log("Error: " + error.code + " " + error.message);
  }
});

批量操作

批量更新示例

把Todo表title所有为Bmob的更新为Bmob后端云
var query = new bmob.Query('Todo');
query.equalTo("title", "bmob");
query.find().then(function(todos) {
    todos.forEach(function(todo) {
        todo.set('title', "Bmob后端云");
    });
    return bmob.Object.saveAll(todos);
}).then(function(todos) {
    // 更新成功
},
function(error) {
    // 异常处理
});

批量增删改

var objects = []; // 构建一个本地的 bmob.Object 对象数组
// 批量创建（更新）
bmob.Object.saveAll(objects).then(function(objects) {
    // 成功
},
function(error) {
    // 异常处理
});
// 批量删除
bmob.Object.destroyAll(objects).then(function() {
    // 成功
},
function(error) {
    // 异常处理
});
// 批量获取
bmob.Object.fetchAll(objects).then(function(objects) {
    // 成功
},
function(error) {
    // 异常处理
});

数据关联

添加及修改关联关系

一对一关系和一对多关系

一对一关系和一对多关系都可以通过在一个Bmob.Object内保存另一个对象来实现。比如，每一个 Comment都对应了一个Post，创建一个有一个Comment的Post，你可以这样写：

// Declare the types.
var Post = Bmob.Object.extend("Post");
var Comment = Bmob.Object.extend("Comment");
// Create the post
var myPost = new Post();
myPost.set("title", "I'm Hungry");
myPost.set("content", "Where should we go for lunch?");
// Create the comment
var myComment = new Comment();
myComment.set("content", "Let's do Sushirrito.");
// Add the post as a value in the comment
myComment.set("parent", myPost);
// This will save both myPost and myComment
myComment.save();

Bmob内部会自动处理，调用Comment的save方法就可以同时保存两个新对象。

如果是现有对象想要关联到新对象，你同样可以通过只用它们的objectId来连接彼此。请注意，不能直接像上面的例子那样将现有对象设置进去，而是必须new一个新对象并只设置id属性：

var post = Bmob.Object.createWithoutData("Post", "320b0395f3");
myComment.set("parent", post);

或者：

var post = new Post();
post.id = '520c7e1ae4b0a3ac9ebe326a';
myComment.set("parent", post);

如果希望查询结果中包含多个相关联的其他数据类型。你可以使用 include 方 法。例如有个comments，你可能想同时获取它们相关的 post 数据:

var query = new Bmob.Query(Comment);
query.include("post");

可以这样获取include对象的属性:

obj.get("inloudeObj").field

查出用户发表的日志示例

     var objectId,that=this;
    var currentUser = Bmob.User.current();
    objectId = currentUser.id;
    var Diary = Bmob.Object.extend("diary");
    var query = new Bmob.Query(Diary);
    var isme = new Bmob.User();
    isme.id = objectId;        //当前用户的objectId
    query.equalTo("own", isme);
    query.descending('createdAt');    //排序
    query.include("own");  //own 字段名称，类型 Pointer
    // 查询所有数据
    query.limit(that.data.limit);
    query.find({
      success: function (results) {
        that.setData({
          diaryList: results
        })
      },
      error: function (error) {
        console.log("查询失败: " + error.code + " " + error.message);
      }
    });

wxml文件调用

<view class="weui-media-box weui-media-box_text" wx:for="{{diaryList}}" wx:key="diaryItem">
日志标题：
{{item.title}}
用户表的日志作者：
{{item.own.nickName}}
</view>

原子计数器

许多应用都需要维持一些计数器数据，譬如用来跟踪心情被点赞数目等等。Bmob提供了便捷的方式来对任何数字字段进行原子性的增加或者减少：

Diary.increment("isLike");
Diary.save();

你可以同样传入第二个参数到increment方法来指定增加多少，1是默认值。

文件上传

文件上传

文件上传，例如，我们从本地上传一张图片到服务器，名称为”1.jpg”，可用以下代码：

在js中添加以下代码：

wx.chooseImage({
  count: 1, // 默认9
  sizeType: [ 'compressed'], // 可以指定是原图还是压缩图，默认二者都有
  sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机，默认二者都有
  success: function (res) {
      var tempFilePaths = res.tempFilePaths;
      if(tempFilePaths.length>0){
          var name="1.jpg";//上传的图片的别名，建议可以用日期命名
          var file=new Bmob.File(name,tempFilePaths);
          file.save().then(function(res){
            console.log(res.url());
          },function(error){
            console.log(error);
          })
      }
  }
})
#### PS： 特别注意的是 `tempFilePaths` 是微信返回的数组。

图片批量上传

图片批量上传，我们只需要for循环一下上面的就好，一下示例代码。

upImg: function () {
    var that = this;
    wx.chooseImage({
      count: 9, // 默认9
      sizeType: ['compressed'], // 可以指定是原图还是压缩图，默认二者都有
      sourceType: ['album', 'camera'], // 可以指定来源是相册还是相机，默认二者都有
      success: function (res) {
        wx.showNavigationBarLoading()
        that.setData({
          loading: false
        })
        var urlArr = new Array();
        // var urlArr={};
        var tempFilePaths = res.tempFilePaths;
        console.log(tempFilePaths)
        var imgLength = tempFilePaths.length;
        if (imgLength > 0) {
          var newDate = new Date();
          var newDateStr = newDate.toLocaleDateString();
          var j = 0;
          //如果想顺序变更，可以for (var i = imgLength; i > 0; i--)
          for (var i = 0; i < imgLength; i++) {
            var tempFilePath = [tempFilePaths[i]];
            var extension = /\.([^.]*)$/.exec(tempFilePath[0]);
            if (extension) {
              extension = extension[1].toLowerCase();
            }
            var name = newDateStr + "." + extension;//上传的图片的别名
            var file = new Bmob.File(name, tempFilePath);
            file.save().then(function (res) {
              wx.hideNavigationBarLoading()
              var url = res.url();
              console.log("第" + i + "张Url" + url);
              urlArr.push({ "url": url });
              j++;
              console.log(j, imgLength);
              // if (imgLength == j) {
              //   console.log(imgLength, urlArr);
              //如果担心网络延时问题，可以去掉这几行注释，就是全部上传完成后显示。
                showPic(urlArr, that)
              // }
            }, function (error) {
              console.log(error)
            });
          }
        }
      }
    })
  }
})
//上传完成后显示图片
function showPic(urlArr, t) {
  t.setData({
    loading: true,
    urlArr: urlArr
  })
}

文件删除

var path;
path = "http://bmob-cdn-9200.b0.upaiyun.com/2017/04/25/f24b9ef540f1aeb680ebe01ba8543d9f.png";
var s = new Bmob.Files.del(path).then(function(res) {
    if (res.msg == "ok") {
        console.log('删除成功');
    }
},
function(error) {
    console.log(error)
});

图片处理

新版文件服务由第三方厂商又拍云提供，只需要在文件上传成功返回的url后面拼接特定参数即可实现缩放，缩略图，加水印等效果，如图，具体可参考这里 。

Promise

除了回调函数之外，每一个在Bmob JavaScript SDK中的异步方法都会返回一个 Promise. 使用 Promise，你的代码可以比原来的嵌套 callback 的方法看起来优雅得多.

then 方法

每一个Promise都有一个叫then的方法, 这个方法接受一对callback。第一个callback在promise被解决的时候调用，第二个会在promise被拒绝的时候调用。

obj.save().then(function(obj) {
  // the object was saved successfully.
}, function(error) {
  // the save failed.
});

将Promise 组织在一起

Promise比较神奇，可以代替多层嵌套方式来解决发送异步请求代码的调用顺序问题。 如果一个Promise的回调会返回一个Promise，那么第二个then里的callback在第一个then的callback没有解决前是不会解决的。

var query = new Bmob.Query("Student");
query.descending("gpa");
query.find().then(function(students) {
  students[0].set("valedictorian", true);
  return students[0].save();
}).then(function(valedictorian) {
  return query.find();
}).then(function(students) {
  students[1].set("salutatorian", true);
  return students[1].save();
}).then(function(salutatorian) {
  // Everything is done!
});

错误处理

如果任意一个在链中的Promise返回一个错误的话，所有的成功的callback在接下来都会被跳过直到遇到一个处理错误的callback。处理error的callback可以转换error或者可以通过返回一个新的Promise的方式来处理它。你可以想象成拒绝的promise有点像异常，而error callback则像是一个catch来处理这个异常或者抛出异常。

var query = new Bmob.Query("Student");
query.descending("gpa");
query.find().then(function(students) {
  students[0].set("valedictorian", true);
  // Force this callback to fail.
  return Bmob.Promise.error("There was an error.");
}).then(function(valedictorian) {
  // Now this will be skipped.
  return query.find();
}).then(function(students) {
  // This will also be skipped.
  students[1].set("salutatorian", true);
  return students[1].save();
}, function(error) {
  // This error handler WILL be called. error will be "There was an error.".
  // Let's handle the error by returning a new promise.
  return Bmob.Promise.as("Hello!");
}).then(function(hello) {
  // Everything is done!
}, function(error) {
  // This isn't called because the error was already handled.
});

通常来说，在正常情况的回调函数链的末尾，加一个错误处理的回调函数会是很方便的做法.

创建 Promise

在开始阶段，你可以只用系统（譬如find和save方法等）返回的promise。但在更高级的场景下，你可能需要创建自己的promise。在创建了Promise之后，你需要调用resolve或者reject来触发它的callback。

var successful = new Bmob.Promise();
successful.resolve("The good result.");
var failed = new Bmob.Promise();
failed.reject("An error message.");

如果你在创建promise的时候就知道它的结果，下面有两个很方便的方法可以使用：

var successful = Bmob.Promise.as("The good result.");
var failed = Bmob.Promise.error("An error message.");

顺序的Promise

var query = new Bmob.Query("Comments");
query.equalTo("post", 123);
query.find().then(function(results) {
  // Create a trivial resolved promise as a base case.
  var promise = Bmob.Promise.as();
  _.each(results, function(result) {
    // For each item, extend the promise with a function to delete it.
    promise = promise.then(function() {
      // Return a promise that will be resolved when the delete is finished.
      return result.destroy();
    });
  });
  return promise;
}).then(function() {
  // Every comment was deleted.
});

并行的Promise

你也可以用Promise来并行的进行多个任务，这时需要使用when方法。你可以一次同时开始几个操作，使用Bmob.Promise.when来创建一个新的promise，它会在所有输入的Promise被解决之后才被解决。即便一些输入的promise失败了，新的Promise也会被成功执行。你可以在 callback的参数部分检查每一个promise的结果，并行地进行操作会比顺序进行更快，但是也会消耗更多的系统资源和带宽。

var query = new Bmob.Query("Comments");
query.equalTo("post", 123);
query.find().then(function(results) {
  // Collect one promise for each delete into an array.
  var promises = [];
  _.each(results, function(result) {
    // Start this delete immediately and add its promise to the list.
    promises.push(result.destroy());
  });
  // Return a new promise that is resolved when all of the deletes are finished.
  return Bmob.Promise.when(promises);
}).then(function() {
  // Every comment was deleted.
});

创建异步方法

有了上面这些工具以后, 就很容易创建你自己的异步方法来返回promise了。举例说，你可以创建一个有promise版本的setTimeout。

var delay = function(millis) {
  var promise = new Bmob.Promise();
  setTimeout(function() {
    promise.resolve();
  }, millis);
  return promise;
};
delay(100).then(function() {
  // This ran after 100ms!
});

Collection

一个Bmob.Collection就是一个Bmob.Objects的有序集合，它和Backbone.Collection是兼容的，有相同的特性和功能，你可以通过用一个模型类或者一个特定的Bmob.Query来创建一个新的子类。

// A Collection containing all instances of TestObject.
var TestCollection = Bmob.Collection.extend({
  model: TestObject
});
var collection = new TestCollection();
// A Collection of TestObjects whose temperature is "hot".
var HotCollection = Bmob.Collection.extend({
  model: TestObject,
  query: (new Bmob.Query(TestObject)).equalTo("temperature", "hot")
});
var collection = new HotCollection();
// The Collection of TestObjects that match a complex query.
var query = new Bmob.Query(TestObject);
query.equalTo("temperature", "hot");
query.greaterThan("degreesF", 100);
var collection = query.collection();

获取Collection

使用fetch方法来获取一个collection里的所有元素:

var collection = new TestCollection();
collection.fetch({
  success: function(collection) {
    collection.each(function(object) {
      console.warn(object);
    });
  },
  error: function(collection, error) {
    // The collection could not be retrieved.
  }
});

Collection 排序

你可以设定一个comparator来对collection中的元素进行排序:

var collection = new TestCollection();
collection.comparator = function(object) {
  return object.get("temperature");
};

修改一个 Collection

Collection是可变的，你可以访问所有元素，增加或者删除元素：

var collection = new TestCollection();
collection.add([
  {"name": "Duke"},
  {"name": "Scarlett"}
]);
// Get the "Duke" Bmob.Object by its sorted position.
var model = collection.at(0);
// Or you can get it by Bmob objectId.
var modelAgain = collection.get(model.id);
// Remove "Duke" from the collection.
collection.remove(model);
// Completely replace all items in the collection.
collection.reset([
  {"name": "Hawk"},
  {"name": "Jane"}
]);