云函数开发
云函数(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 --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);
今日作业
编写一个云函数上传部署,在云函数里查询云数据库里产品表的所有数据。并在小程序页面端调用该云函数,并将返回的数据以列表形式显示在小程序页面。