前言

微信小程序的开发愈发火热，微信官方推出的云开发功能给中小型开发者提供了很大助力?？袅嗽瓶⒐δ艿男〕绦?，可以使用数据库，存储空间等一系列免费资源，给开发者提供了很大的便利，开发者可以聚焦核心功能，而不用分心部署自己并不熟悉的后端api服务。微信官方云开发文档对于小程序或者云函数中调用数据库的api解释的非常详细，但是对于非小程序或云函数环境（比如我们的node服务器）如何调用，就一笔带过，显得语焉不详。要注意，浏览器环境不能直接调用数据api,必须通过服务器中转。这里笔者将结合自己踩过的坑，展示一些特殊查询语句的调用方法。

准备工作

要在服务器环境中调用云开发的官方api,首先要根据你的小程序获取调用token:

const getAccessToken = async() => {
    const domain = 'https://api.weixin.qq.com/cgi-bin/token';
    return await ownTool.netModel.get(domain, {
        grant_type: 'client_credential',
        appid: '你的appId',
        secret: '你app的密码'
    });
}
//  返回的是一个对象，结构如下
//  { access_token, expires_in }
//  expriest_in表示还有多少时间这个token将过期，过期后要重新申请

ownTool.netModel就是任意具有http接口调用功能的第三方库, 这里使用get方法发起请求，请求参数中的appId和secret都可以在小程序的开发者后台中产看。

image

调用官方api

假设这里有如下格式的数据：

image

const queryApi = 'https://api.weixin.qq.com/tcb/databasequery?access_token=';
//  外围是笔者的业务代码，不用太在意
//  功能就是向官方api查询数据，再转给client,也就是服务器
app.post(apiPrefix + '/queryPeriod', async function(req,res){
    //  这里的token就是我们之前获取的token
    const wxToken = await getToken();
    const doamin = queryApi + wxToken;
    const { offset, size } = req.body;
    //  向微信官方api发起查询请求
    let a = await ownTool.netModel.post(doamin, {
        env: '你的环境id',
        query: 'db.collection("period").where({counselorId:"' + req.body.counselorId + '"}).' +
        'skip(' + offset +').limit(' + size + ').orderBy("date","desc").get()'
    })
    res.send(a);
});

这里的环境id就是你的小程序官方编辑器点击云开发摁钮，在云开发面板中查询的：

image

通过http api调用官方接口的核心点和易错点就在这个query语句上,如果要表示字符串值，一定要用""或''对字段包裹，如果要让官方api理解为一个变量，则一定不能用""或''包裹。这里是绝大多数初学者在通过http调用api时翻车的原因

这里笔者的查询语句功能是：在period集合中，查找counselorId为某个特定值的数据，跳过一开始的offset个数据，该次请求最多返回size个，返回数据根据data字段进行降序排序后返回。如果在小程序中，查询语句类似这样：

db.collection('period').where({
  counselorId: '匹配的id'
}).skip(offset).limit(size)
.get({
  success: function(res) {
    console.log(res.data)
  }
})

如果功能在复杂一点，比如说我们要求date字段要在某个区间内的数据才返回，在小程序或云函数中我们的请求这样写：

const _ = db.command
db.collection('period').where({
  data: _.gt('2020-03-20').and(_.lt('2020-04-20'))
})
.get({
  success: function(res) {
    console.log(res.data)
  }
})

在自己的服务器中我们的查询字符串需要这样写：

let a = await ownTool.netModel.post(doamin, {
    env: '你的环境id',
    query: 'db.collection("period").where({date: _.gt("2020-03-20").and(_.lt("2020-04-20"))}).get()'
})

在官方解析我们的query时，会自动把_理解为db.command的实例，我们直接在query字符串中使用即可。在真实的项目中，我们用手写查询语句显得比较笨重，可以通过对查询对象直接JSON.stringfy()的方法将其转化为字符串拼接到query字符串中。这里笔者贴下自己在项目中的示例代码给大家参考,细节就不解释了，大家主要可以参考下将查询对象转化为string的操作：

function getQueryString(pageNum: number) {
    const queryJsonString = JSON.stringify(
        Object.assign(
        {},
        queryObj.switchOn
            ? {
                'formData.date': `_.gt('${queryObj.period?.[0]?.format('YYYY-MM-DD',
                )}').and(_.lt('${queryObj.period?.[1]?.format('YYYY-MM-DD')}'))`,
            } : {},
        queryObj.counselorId ? { counselorId: `'${queryObj.counselorId}'` } : {},
        ),
    )
    //  这里要替换下，否则后台会理解为字符串而不是查询条件
    .replace(/"/g, '')
    //  嵌套对象必须要套引号，否则无法解析
    .replace('formData.date', '"formData.date"');
    return `db.collection('interviewee').where(${queryJsonString}).skip(${(pageNum - 1) *
        SINGLE_PAGE_SIZE}).limit(${SINGLE_PAGE_SIZE}).orderBy('date','desc').get()`;
}

参考文献

微信小程序云开发http api调用官方文档