4.4 云函数

云函数是开发者提前定义好的、保存在云端并且将在云端运行的JS函数。

开发者先定义好云函数，再使用微信开发工具将云函数上传到云空间，在云开发控制台中可看到已经上传的云函数。

云函数运行在云端Node.js环境中。

小程序端通过wx.cloud.callFunction方法调用云函数，让云函数在云端运行，云函数最终可以返回到小程序端。

云函数之间互相调用，需要使用服务端API的callFunction方法。

4.4.1 云函数简介

以一个将两个数字相加的函数作为第一个云函数作为示例。

首先，点击pages文件夹，点击右键，点击“在资源管理器中显示”，在打开页面新建文件夹“cloudFunctions”

然后在project.config.json文件新增一个字段，指定cloudFunctions目录为云函数在项目中的目录。代码如下：

{

  "cloudfunctionRoot": "cloudFunctions/"

}

保存以后，cloudFunctions目录图标发生变化，表明这是一个云函数的目录。

右击cloudFunctions目录，选择“新建Node.js云函数”，并将该函数命名为add，

微信开发工具自动创建出同名目录，以及目录中两个文件index.js和package.json。

index.js是add函数的入口文件。package.json是Node.js中的模块描述文件，其内容是一个JSON对象，指定了模块名字、版本、描述等信息。JSON对象的dependencies属性指定了该模块所依赖的其他模块的名字和版本。在云函数可以用npm引入第三方依赖来帮助更快开发。

所有云函数中会默认引入wx-server-sdk的依赖，版本后为latest。在index.js文件中，第一行表示在云函数中引入这个依赖模块的引用对象。其代码如下:

const cloud = require('wx-server-sdk') // cloud对象对应着小程序的wx.cloud对象

服务端API都封装在cloud对象。

在服务端可以通过cloud.init方法实现初始化。代码如下：

cloud.init() // 使用云能力前需要先执行初始化方法

接下来观察云函数的入口函数：

// 云函数入口函数

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

// cloud function body

}

这是箭头函数，async表示这是一个异步函数。event和context是函数的两个参数，大括号是函数的内容。在函数前面加上exports.main=，表示这个函数是这个模块的入口函数。

event指的是触发云函数的事件对象，其中包含小程序端调用云函数时传入的参数，而context对象则包含云函数的调用信息和运行状态，可以用它了解服运行情况。

现在修改云函数，将传入的a和b相加，并作为sum字段返回给调用端，代码如下：

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

const c = event.a + event.b

  return {

    sum: c

  }

}

保存后，需要将这个云函数部署到云端。在云函数魔力add上右击，在右键菜单中，选择“上传并部署：云端安装依赖 ( 不上传node_modules) ”，将云函数上传并部署到线上环境中。

这时，在云开发控制台中的云函数管理页面可以看到刚刚上传的云函数，如下图所示：

部署完成后在小程序使用wx.cloud.callFunction方法调用该云函数。代码如下：

 //  回调风格

 wx.cloud.callFunction({

      name: 'add', // 云函数名称

      data : {

        a: 1,

        b: 2

      },

      success: function(res){

        console.log(res.result) // sum: 3

      },

      fail: function(error){// handle error

      }

    })

// Promise风格

    wx.cloud.callFunction({

      name: 'add', // 云函数名称

      data : {

        a: 55,

        b: 2

      }

    }).then(res => {

      console.log(res.result) // sum: 

    }).catch(error => {// handle error

    })

(实践的时候发现，云函数的任何修改，都不是实时的，都需要点击add上传并部署，调用才能得到正确的结果)