云函数基础

{
  "name": "add-article",
  "version": "1.0.0",
  "description": "新增文章",
  "main": "index.js",
  "dependencies": {
    // 云函数的依赖，包括公共模块及自行安装的npm依赖
  },
  "extensions": {
    // 云函数使用的扩展库
  },
  "cloudfunction-config": {
    "concurrency": 10, // 单个云函数实例最大并发量，不配置的情况下默认是1
    "memorySize": 256, // 函数的最大可用内存，单位MB，可选值：128|256|512|1024|2048，默认值256
    "timeout": 5, // 函数的超时时间，单位秒，默认值5。最长为60秒，阿里云在定时触发时最长可以是600秒
    // triggers 字段是触发器数组，目前仅支持一个触发器，即数组只能填写一个，不可添加多个
    "triggers": [{ // 阿里云腾讯云均为此形式，请阅读下方说明
        // name: 触发器的名字，规则见https://uniapp.dcloud.net.cn/uniCloud/trigger，name不对阿里云生效
        "name": "myTrigger",
        // type: 触发器类型，目前仅支持 timer (即 定时触发器)，type不对阿里云生效
        "type": "timer",
        // config: 触发器配置，在定时触发器下，config 格式为 cron 表达式，规则见https://uniapp.dcloud.net.cn/uniCloud/trigger。使用阿里云时会自动忽略最后一位，即代表年份的一位在阿里云不生效
        "config": "0 0 2 1 * * *"
    }],
    // 云函数Url化path部分，阿里云需要以/http/开头
    "path": "",
    "runtime": "" // nodejs版本，可选Nodejs8、Nodejs12，默认：Nodejs8
  }
}

//在云函数中获取云数据库示例
const db = uniCloud.database();
//在云函数中获取云数据库users集合的数据
const dbRes = db.collection("users").get();

uniCloud.callFunction({
  name:"云函数名称",
  data:{//云函数传参
     a:1
     b:{
       c:2
     }
  },
  success:(res)=>{
    
  }
});

// 云函数index.js入口文件代码
'use strict';
exports.main = async (event, context) => {
  //event为客户端上传的参数
  return {
    sum:event.a + event.b.c
  } // 通过return返回结果给客户端
}

'use strict';
exports.main = async (event, context) => {
  //event为客户端上传的参数
  //...
  //context中可获取客户端调用的上下文
  let clientIP = context.CLIENTIP // 客户端ip信息
  let clientUA = context.CLIENTUA // 客户端user-agent
  let spaceInfo = context.SPACEINFO // 当前环境信息 {spaceId:'xxx',provider:'tencent'}
  // 以下四个属性只有使用uni-app以callFunction方式调用才能获取
  let os = context.OS //客户端操作系统，返回值：android、ios  等
  let platform = context.PLATFORM //运行平台，返回值为 mp-weixin、app-plus等。注意：vue3版本uni-app将app-plus修改为了app，此处为保证旧版本兼容性未进行统一，推荐后续在业务中都使用app作为客户端标识
  let appid = context.APPID // manifest.json中配置的appid
  let deviceId = context.DEVICEID // 客户端标识，新增于HBuilderX 3.1.0，同uni-app客户端getSystemInfo接口获取的deviceId
  //... //其它业务代码
}

//在云函数中调用云函数
let callFunctionResult = await uniCloud.callFunction({
    name: "test",
    data: { a: 1 }
})

const res = await uniCloud.httpclient.request(apiUrl, {
    method: 'POST',
    data: {
      test: 'testValue'
    },
    contentType: 'json', // 指定以application/json发送data内的数据
    dataType: 'json' // 指定返回值为json格式，自动进行parse
  })
console.log(res)

/*返回的数据结构
{
  "data": {"name": "DCloud"}, // 响应内容
  "status": 200, // 状态码
  "headers": { // 响应头，仅作示例，不同服务器返回的有差异
    "date": "Tue, 29 Dec 2020 08:10:30 GMT",
    "content-type": "application/json",
    "content-length": "276",
    "connection": "keep-alive",
    "server": "gunicorn/19.9.0",
    "access-control-allow-origin": "*",
    "access-control-allow-credentials": "true"
  }
}
*/

cloudfunctions
  ├─common // 云函数公用模块目录
  |  └─hello-common // 云函数公用模块
  |     ├─package.json
  |     └─index.js // 公用模块代码，可以不使用index.js，修改 package.json 内的 main 字段可以指定此文件名
  └─use-common // 使用公用模块的云函数
     ├─package.json // 在 use-common 目录执行 npm init -y 生成
     └─index.js // 云函数入口文件

// common/hello-common/index.js
function getVersion() {
  return '0.0.1'
}
module.exports = {
  getVersion,
  secret: 'your secret'
}

// use-common/index.js
'use strict';
const {
  secret,
  getVersion
} = require('hello-common')
exports.main = async (event, context) => {
  let version = getVersion()
  return {
    secret,
    version
  }
}

// common/hello-common/index.js
module.exports = function(e){
  return e
}
// use-common/index.js
'use strict';
const echo = require('hello-common')
exports.main = async (event, context) => {
  let eventEcho = echo(event)
  return {
    eventEcho
  }
}