云函数使用

云函数使用

云函数开发

云函数（FaaS）是一段运行在云端的、轻量的、无关联的、并且可重用的代码。无需管理服务器，只需编写和上传代码，即可获得对应的数据结果。使用云函数可以使企业和开发者不需要担心服务器或底层运维设施，可以更专注代码和业务本身，也可以使代码进一步解耦，增加其重用性。

云函数示例

云函数目录结构
在Serverless小程序工程的server/functions目录下创建云函数目录，其中index.js是云函数getImageList的入口文件。

└── server/
    └── functions
           └── getImageList
                   └── index.js

云函数代码结构
以下代码示例展示了如何从数据库images里面查出特定用户上传的图片记录。云函数里可以直接通过API调用数据存储，文件存储的服务资源以及其他云函数。

• 当云函数被客户端或者其他云函数调用时，可以通过ctx.args获得调用传来的参数。
• 可以通过ctx.logger方法打印不同类型的日志信息，然后在云函数控制台中查看执行日志。
• 在云函数内通过ctx.env来获取环境参数，例如SpaceId、调用来源、客户端源IP和客户端UserAgent等信息。ctx.env是一个object，它包含MP_SPACE_ID（SpaceId），MP_SOURCE（调用来源），MP_USER_AGENT（客户端User-agent），MP_CLIENT_IP（客户端IP）。
• 在云函数中，您可以直接调用同一环境（空间）的数据存储和文件存储服务以及获取当前请求用户的基本信息。ctx.mpserverless在云函数封装了小程序的基础服务， API使用方式和客户端一致。

• 通过ctx.mpserverless.db调用云数据库能力，如ctx.mpserverless.db.collection('user').find({ uid: args.uid })。
• 通过ctx.mpserverless.file调用文件存储能力，如ctx.mpserverless.file.deleteFile(args.filePathUrl)。
• 通过ctx.mpserverless.user获取当前访问用户基本信息，如ctx.mpserverless.user.getInfo()。
• 通过ctx.mpserverless.function调用云函数能力，如mpserverless.function.invoke('dataAnalytics', {range: 30})调用其他云函数。
• 通过ctx.httpclient HTTP 请求方法，无需额外依赖，您就可以请求任何 HTTP 和 HTTPS 协议的 Web 服务。如ctx.httpclient.request('https://www.alipay.com/x/notFound.htm')。

module.exports = async (ctx) => {
  ctx.logger.info('%s %s', ctx.env.MP_SPACE_ID, ctx.args.username);
  const images = await ctx.mpserverless.db.collection('images').find({ owner: ctx.args.username });
  return { images };
};

创建云函数

在代码工程创建云函数
1.新建或打开小程序Serverless工程，点击server目录关联对应的云服务空间。

2.在functions目录上右键选择新建云函数。

在云控制台创建云函数
打开小程序云控制台，在云函数页面，点击新建云函数。在新建云函数框里输入云函数的函数名。

部署云函数

编写云函数代码后，您需要将云函数代码在代码工程里或者在云控制台上传。
在代码工程部署云函数
编写云函数代码后，右键点击已创建的云函数，选择部署云函数。

在云控制台部署云函数
1.打开小程序云控制台，在云函数页面，单击已创建的函数名称链接。
2.在发布管理页签，单击上传js包或更新js包，然后选择要上传的代码包。
上传的代码包必须满足以下要求：
• 代码包的名称必须和在控制台上创建的函数名称一致。
• 代码包必须是.zip文件。
• 上传的代码包必须包含index.js文件。
• 如果引用了第三方包，代码包里必须包含node_modules。

1. 上传成功后，单击代码部署。
   

调用云函数

1.在小程序项目的根目录执行以下命令安装 SDK。

npm install @alicloud/mpserverless-sdk --save

2.在 app.js 中初始化SDK（全局只需初始化一次）。

// 1. 引入必要的 sdk
import MPServerless from '@alicloud/mpserverless-sdk';
 
// 2. 在 app.js 中对 sdk 进行初始化
// 2.1 初始化 MPServerless
my.serverless = my.serverless || new MPServerless({
  uploadFile: my.uploadFile,
  request: my.request,
  getAuthCode: my.getAuthCode,
}, {
  // 2.2 参数能在小程序云服务空间详情中获取
  appId: '',
  spaceId: '',
  clientSecret: '',
  endpoint: ''
});

3.在小程序页面您可以使用mpserverless.function.invoke方法调用上述定义的云函数。

// 调用云函数getImageList
my.serverless.function.invoke('getImageList', {     
  username: 'Vincent',
}).then((res) => {
  if (res.success && res.result) {
    this.setData({ imageList: res.result.images });
  }
}).catch(console.error);

课程作业

支付宝扫码登陆官方小程序【小程序云开发助手】，在 学习 > 训练营打卡作业 > 云函数使用 中提交作业。