一文搞懂 EMAS Serverless 小程序开发｜电子书免费下载

>> 快来免费下载｜电子书《五天玩转 EMAS Serverless》 <<

点击免费下载

《五天玩转 EMAS Serverless》

EMAS Serverless 是什么

EMAS Serverless 是阿里云提供的基于 Serverless 技术的一站式后端开发平台，为开发者提供高可用、弹性伸缩的云开发服务，包含云函数、云数据库、云存储、静态网站托管等功能，帮助开发者及企业客户快速实现一云多端应用的搭建，您无需管理服务器等基础设施，便可以无缝对接丰富的云资源。

图 1 EMAS Serverless 产品架构

EMAS Serverless 应用场景

ES 支持云函数、云数据库、云存储等能力，具有弹性伸缩、按量付费、 免运维三大特点。弹性伸缩让您免于频繁运维扩缩机器，轻松应对各种流量突发事件，为您节省大量时间。按量付费做到用多少付多少，函数计费精确到毫秒，为您节省大量开支。免运维让开发者不用花费更多的精力在服务器等底层资源上，而是可以将精力放在更具价值的业务逻辑上。因此 ES 广泛适用于电商、咨询、旅游、企业展示、社区、餐厅等行业场景。

图 2 EMAS Serverless 应用场景

开通产品

首先打开 EMAS 阿里云控制台： https://emas.console.aliyun.com，新建并进入项目。然后选择平台服务并创建一个服务空间。如图 3 和图 4 所示：

图 3 EMAS 控制台首页 —— 项目管理

图 4 选中平台服务并创建服务空间

计费方式

支持按量付费和包年包月两种付费方式。

• 按量付费（后付费）：一种后付费模式，即先使用再付费。一般适用于有爆发业务量的应用或服务。

• 包年包月（预付费）：一种预付费模式，即先付费再使用。通过包年包月，您可以提前预留资源，同时享受更大的价格优惠，帮您更大程度节省支出。

按量付费

包年包月

具体的套餐资源量请参考 https://help.aliyun.com/document_detail/435837.html

安装 SDK

我们以开发支付宝小程序为例，演示如何快速借助 ES 能力快速开发部署。

1. 首先运行在小程序项目根目录执行以下命令。

npm install --save @alicloud/mpserverless-sdk

微信或者支付宝小程序还有一些特殊配置，具体请参考：https://help.aliyun.com/document_detail/444395.html

初始化 SDK

在小程序端开始使用 Serverless 服务前，需要先调用 mpserverless.init 方法完成服务的初始化，且仅能初始化一次。较为通用的做法是在 onLaunch 生命周期中进行初始化操作，并将实例对象 mpserverless 挂载到小程序的全局对象 App，以便后续在其他文件中调用。

这里演示使用的是匿名初始化，这种初始化方式无需在支付宝开放平台配置密钥，不过同时也无法获取小程序用户身份。更多细节请参考：https://help.aliyun.com/document_detail/444402.html

// app.jsimport MPServerless from '@alicloud/mpserverless-sdk'
const mpserverless = new MPServerless(my, {    appId: '小程序 AppID',    spaceId: '服务空间 SpaceId',    clientSecret: '服务空间 Secret',    endpoint: '服务空间 API Endpoint'});
App({    mpserverless: mpserverless,    onLaunch() {        mpserverless.init(          authorType: 'anonymous'        );    },});

云函数

云函数（FaaS）是一段运行在云端的、轻量的、无关联的并且可重用的代码。无需管理服务器，只需编写和上传代码，即可获得对应的数据结果。云函数的入参只有一个 ctx 对象，出参结构由开发者自行定义：

// 云函数入口定义在 index.js 中module.exports = async ctx => {  // do something  return result}

ctx 对象结构

• warn

• error

• debug || ctx.mpserverless | SDK | 在云函数中为您提供已经完成初始化的 mpserverless 对象，让您可以继续调用 Serverless 其他基础服务，API 使用方式和客户端基本一致。 || ctx.env | Object | 在云函数中通过 ctx.env 来获取环境参数，例如 SpaceId、调用来源、客户端源 IP 和客户端 UserAgent 等信息。- MP_SPACE_ID 服务空间 ID

• MP_SOURCE 调用来源- - server：服务端触发

• function：云函数触发

• client：客户端触发

• http：HTTP 触发

• timing：定时触发- MP_USER_AGENT 客户端标志，仅来自客户端的调用包含该字段

• MP_CLIENT_IP 客户端 IP，仅来自客户端的调用包含该字段

• MP_APP_ID 小程序 AppId，客户端非匿名授权后调用云函数包含该字段 || ctx.httpclient | HttpClient | 通过该对象可以请求任何 HTTP 和 HTTPS 协议的 Web 服务。例如：ctx.httpclient.request ('https://***') |

开发部署与调试

我们以开发一个两数四则运算的云函数 TwoNumOperation 为例：

// index.jsmodule.exports = async ctx => {    const { action, x, y } = ctx.args;
    let result = 0    switch (action) {        case '+': result = x + y; break;        case '-': result = x - y; break;        case '*': result = x * y; break;        case '/':            if (y === 0) {                throw new Error('cannot divide by 0')            }            result = x / y; break;        default:            throw new Error('not support action ' + action)    }
    return { result }}

新建文件夹 TwoNumOperation，然后在文件夹下面新建文件 index.js 并放入上述代码，然后整体打包该文件夹得到压缩文件 TwoNumOperation.zip 。如下图 5 所示：

图 5 云函数代码包

如下图 6 所示，首先我们在阿里云控制台新建一个云函数 TwoNumOperation，函数名称必须和文件夹名称一致。然后将压缩好的代码包上传、部署。部署成功后可以在控制台测试运行，点击代码执行，输入函数执行参数即可运行云函数。点击日志可以查看云函数的执行日志，方便开发者调试。

图 6 云函数部署、执行、日志查看

在小程序中调用云函数

如图 7 所示在小程序中调用云函数。 index.axml 布局文件简单写了一个表单包含三个 input，绑定表单提交函数 invokeFunction。 index.js 文件首先从全局导入 mpserverless 对象，然后在表单提交函数中获取参数 action、x、y，然后通过 mpserverless.function.invoke 调用云函数。

图 7 在小程序中调用云函数

云数据库

云数据库服务是基于 MongoDB 托管在云端的数据库，数据以 JSON 格式存储。作为开发者，您可以在客户端或者云函数中通过 mpserverless 对象读写数据。

mpserverless.db.collection('user').findOne( { name: '张三' } )

和 MySQL 对比

ES 云数据库服务底层使用的是 MongoDB，以 JSON 格式存储数据。数据库中的每条记录都是一个 JSON 格式的文档，一个数据库可以包含多个集合（相当于关系型数据库中的表），每个集合可看做一个 JSON 文档数组。MongoDB 数据库和关系型数据库 MySQL 的对比如下表所示。

数据结构设计策略

MongoDB 是一个基于分布式文件存储的 NoSQL 数据库，旨在为 WEB 应用提供可扩展的高性能数据存储解决方案。以电商平台为例，通常电商平台的核心数据包含产品、用户、购物车和订单。订单是由用户购买产品产生的，订单就可以认为是产品和用户之间的关联关系产生的。在订单产生之前，产品和用户之间的关联关系是通过购物车来维持的。针对上述案例，可以设计一个名称为 products 的产品表存储以下信息：

• 产品基础信息：包含展示信息、商品规格等；

• 属性信息：属性都归属于一个产品，属于 N 对 1 的关系。因此作为子文档存储在 products 集合中较合适；

• 库存及价格信息：库存不仅仅跟产品关联，更直接对应产品属性。因此也应该放在 products 集合中；

{  "id": 5573,  "name": "Egg T恤",  "desc": {    "short": "限量版 Egg T恤，穿上它你离极客也不远了",    "long": "这是一段非常长的描述",    "category": {      "_id": "48bf43a..29e90bc",      "name": "上衣"    }  },  "attributes": [    {      "id": 1151,      "name": "尺寸",      "values": [        {          "id": 3871,          "value": "S"        },        {          "id": 3874,          "value": "M"        },        {          "id": 3875,          "value": "L"        }      ]    },    {      "id": 1152,      "name": "性别",      "values": [        {          "id": 3872,          "value": "男"        },        {          "id": 3873,          "value": "女"        }      ]    }  ],  "sku": [    {      "id": 1153,      "stock": 30,      "attributeIds": [        3871,        3872      ],      "attributes": [        {          "key": "尺寸",          "value": "S"        },        {          "key": "性别",          "value": "女"        }      ]    }  ]}

创建数据表

在阿里云控制台上点击 “+” 新建数据表

图 8 在控制台新建数据表

添加数据记录

insertOne

插入用户张三

mpserverless.db.collection('users').insertOne( {     name: '张三',    age: 18} )

insertMany

mpserverless.db.collection('users').insertOne( [     { name: '张三', age: 18 },    { name: '李四', age: 17 }] )

删除数据记录

deleteOne

mpserverless.db.collection('users').deleteOne( {     name: '张三'} )

deleteMany

删除年龄小于 18 的用户

mpserverless.db.collection('users').deleteMany( {     age: { $lt: 18 }} )

查询数据记录

findOne

mpserverless.db.collection('users').findOne( {     age: { $gt: 18 }} )

find

查询所有大于 18 的用户 name，并将查询结果按年龄升序返回

mpserverless.db.collection('users').find( {    age: { $gt: 18 }}, {    projection: { name: 1 },    sort: { age: 1 }} )

findOneAndDelete

查询并删除小于且最接近 18 岁的一条数据

mpserverless.db.collection('users').findOneAndDelete( {    age: { $lt: 18 }}, {    sort: { age: -1 }} )

findOneAndReplace

查询并替换 name 为张三的一条数据

mpserverless.db.collection('users').findOneAndReplace( {    name: "张三"}, {    name: "张三三",    age: 20}, {    upsert: true // 如果不存在则插入} )

findOneAndUpdate

查询并更新 name 为张三的一条数据

mpserverless.db.collection('users').findOneAndUpdate( {    name: "张三"}, {    $set: {        name: "张三三",        age: 20    }}, {    upsert: true // 如果不存在则插入} )

更新数据记录

updateOne

更新第一个张三的年龄为 22 岁

mpserverless.db.collection('users').updateOne( {    name: "张三"}, {    $set: {        age: 22    }} )

updateMany

把所有的张三年龄都设置为 22 岁

mpserverless.db.collection('users').updateMany( {    name: "张三"}, {    $set: {        age: 22    }} )

replaceOne

把第一个张三姓名改为张阿三，年龄改为 22 岁

mpserverless.db.collection('users').replaceOne( {    name: "张三"}, {    $set: {        name: '张阿三',        age: 22    }}, {    upsert: true // 如果不存在则插入，为 flase 时代表不存在则不做任何操作} )

其他指令

distinct

返回 age 字段大于 18 的所有姓名（如果有相同的 name 只返回一个）

mpserverless.db.collection('users').distinct(    'name',     { age: { $gt: 18 })

count

查找集合 users 中所有 age 大于 18 的记录数量

mpserverless.db.collection('users').count( {    age: { $gt: 18 }} )

aggregate

聚合管道查询，该管道允许用户通过一系列基于阶段的操作来处理数据，详情请参考帮助文档 https://help.aliyun.com/document_detail/435909.html

云存储

mpserverless.file 对象提供 uploadFile 和 deleteFile 方法管理文件。上传的文件将通过 CDN 进行网络加速。单个文件要求小于 100 MB。

上传文件

支付宝小程序上传文件示例

my.chooseImage({    chooseImage: 1,    success: res => {
        const path = res.apFilePaths[0];        const options = {            filePath: path,        };
        mpserverless.file.uploadFile(options)        .then(res => {             console.log(res);          })        .catch(err => {              console.log(err);        });
    },});

返回示例：

{    "fileUrl": "https://mp-…storage/2e7acad6-2212-4863-aaa7-4e89d7d8df4c.png",     "filePath": "cloudstorage/2e7acad6-2212-4863-aaa7-4e89d7d8df4c.png"}

删除文件

根据文件地址从服务空间中删除该文件

const fileURL = 'https://mp...bspapp.com/xxx-xx/4b82ded0-0118-4de4-9f50-ab13110a1ffb.jpg';
mpserverless.file.deleteFile(fileURL)

总结

EMAS Serverless 依托阿里巴巴数字经济技术能力和业务能力提供云函数、云存储、云数据库等 Serverless 服务。大大提升了前端工程师的价值，让开发者快速落地小程序开发工作，按量付费和自动弹性伸缩省时省力。此外， ES 还支持静态网站托管以及面向支付宝生态的云调用模块，技术与商业联动为开发者提供一站式地小程序生态服务。

参考资料

EMAS 控制台：https://emas.console.aliyun.com

帮助文档：https://help.aliyun.com/document_detail/436030.html

开发指南：https://help.aliyun.com/document_detail/444395.html

>> 快来免费下载｜电子书《五天玩转 EMAS Serverless》 <<