云函数使用
云函数开发
云函数（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.在小程序项目的根目录执行以下命令安装 SDK。
npm install @alicloud/mpserverless-sdk --save2.在 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);课程作业
支付宝扫码登陆官方小程序【小程序云开发助手】，在 学习 > 训练营打卡作业 > 云函数使用 中提交作业。
