在云函数中使用 qq-server-sdk

# 在云函数中使用 qq-server-sdk

小程序内提供了专门用于云函数调用的 API。开发者可以在云函数内使用 qq-server-sdk 提供的 getQQContext 方法获取到每次调用的上下文（appid、openid 等），无需维护复杂的鉴权机制，即可获取天然可信任的用户登录态（openid）。

云函数中使用 qq-server-sdk 需在对应云函数目录下安装 qq-server-sdk 依赖，在创建云函数时会在云函数目录下默认新建一个 package.json 。请注意云函数的运行环境是 Node.js，因此在本地安装依赖时务必保证已安装 Node.js，同时 node 和 npm 都在环境变量中。如不本地安装依赖，可以用命令行在该目录下运行：

npm install --save qq-server-sdk@latest

在云函数中调用其他 API 前，同小程序端一样，也需要执行一次初始化方法：

const cloud = require('qq-server-sdk')
// 给定字符串环境 ID：接下来的 API 调用都将请求到环境 some-env-id
cloud.init({
  env: 'some-env-id'
})

1
2
3
4
5

qq-server-sdk 与小程序端的云 API 以同样的风格提供了数据库、存储和云函数的 API。下面提供几个简单的操作数据库、存储和云函数的示例

# 云函数中调用数据库

假设在数据库中已有一个 todos 集合，我们可以如下方式取得 todos 集合的数据：

const cloud = require('qq-server-sdk')

cloud.init({
  env:cloud.DYNAMIC_CURRENT_ENV
})

exports.main = async (event, context) => {

  const db = cloud.database()
  
  // collection 上的 get 方法会返回一个 Promise，因此云函数会在数据库异步取完数据后返回结果
  return db.collection('todos').get()
}

1
2
3
4
5
6
7
8
9
10
11
12
13

# 云函数中调用存储

假设我们要上传在云函数目录中包含的一个图片文件（demo.jpg）：

const fs = require('fs')
const path = require('path')
const cloud = require('qq-server-sdk')

cloud.init({
  env:cloud.DYNAMIC_CURRENT_ENV
})

exports.main = async (event, context) => {

  
  const fileStream = fs.createReadStream(path.join(__dirname, 'demo.jpg'))
  return await cloud.uploadFile({
    cloudPath: 'demo.jpg',
    fileContent: fileStream,
  })
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

在云函数中，__dirname 的值是云端云函数代码所在目录

# 云函数中调用其他云函数

假设我们要在云函数中调用另一个云函数 sum 并返回 sum 所返回的结果：

const cloud = require('qq-server-sdk')
cloud.init({
  env:cloud.DYNAMIC_CURRENT_ENV
})


exports.main = async (event, context) => {

  return await cloud.callFunction({
    name: 'sum',
    data: {
      x: 1,
      y: 2,
    }
  })
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

更多的文档可参见API 文档。

← 使用 npm 使用 tcb-admin-node →