Skip to main content

开发函数

初始化代码#

让我们来开发第一个纯 HTTP 函数，来尝试将它部署到云环境（不用担心，函数现在都有免费额度，一般情况下不花钱）。

$ npm -v
# 如果是 npm v6$ npm init midway --type=faas my_midway_app
# 如果是 npm v7$ npm init midway -- --type=faas my_midway_app

也可以执行 npm init midway ，选择 faas  脚手架。

目录结构#

以下就是一个函数的最精简的结构，核心会包括一个 f.yml 标准化函数文件，以及 TypeScript 的项目结构。

.├── f.yml               # 标准化 spec 文件├── package.json        # 项目依赖├── src│   └── function│       └── hello.ts    ## 函数文件└── tsconfig.json

我们来简单了解一下文件内容。

  • f.yml   函数定义文件
  • tsconfig.json TypeScript 配置文件
  • src 函数源码目录
  • src/function/hello.ts 示例函数文件

我们将函数放在 function目录下，是为了更好的和其他类型的代码分开。

函数文件#

我们首先来看看函数文件，传统的函数是一个 function ，为了更符合 midway 体系，以及使用我们的依赖注入，这里将它变成了 Class。

通过 @ServerlessTrigger  装饰器，我们将方法标注为一个 HTTP 接口，并且标示 path  和 method  属性。

import { Provide, Inject, ServerlessTrigger, ServerlessTriggerType, Query } from '@midwayjs/decorator';import { Context } from '@midwayjs/faas';
@Provide()export class HelloHTTPService {  @Inject()  ctx: Context;
  @ServerlessTrigger(ServerlessTriggerType.HTTP, {    path: '/',    method: 'get',  })  async handleHTTPEvent(@Query() name = 'midway') {    return `hello ${name}`;  }}

除了触发器外，我们还可以使用 @ServerlessFunction 装饰器描述函数层面的元信息，比如函数名，并发度等等。 ​

这样，当我们在一个函数上，使用多个触发器时，就可以这样设置。

import { Provide, Inject, ServerlessTrigger, ServerlessTriggerType, Query } from '@midwayjs/decorator';import { Context } from '@midwayjs/faas';
@Provide()export class HelloServerlessService {  @Inject()  ctx: Context;
  // 一个函数多个触发器  @ServerlessFunction({    functionName: 'abcde',  })  @ServerlessTrigger(ServerlessTriggerType.TIMER, {    type: 'every',    value: '5m',  })  @ServerlessTrigger(ServerlessTriggerType.TIMER, {    type: 'every',    value: '10m',  })  async handleTimerEvent() {    // TODO  }}
caution

注意，有些平台无法将不同类型的触发器放在同一个函数中，比如阿里云规定，HTTP 触发器和其他触发器不能同时在一个函数生效。

函数定义文件#

f.yml 是函数的定义文件，通过这个文件，在构建时生成不同平台所能认识的文件，示例中的文件内容如下。

service:  name: midway-faas-examples ## 函数组名，可以理解为应用名
provider:  name: aliyun ## 发布的平台，这里是阿里云
custom:  customDomain:    domainName: auto ## 由于发布 HTTP 服务，域名这里使用自动生成，后续可以单独绑定

触发器装饰器参数#

@ServerlessTrigger 装饰器用于定义不同的触发器，它的参数为每个触发器信息，以及通用触发器参数。 ​

触发器和 f.yml 的定义保持一致，当前的定义请参考每个触发器的 interface。

比如触发器的名称修改为 abc。

  @ServerlessTrigger(ServerlessTriggerType.TIMER, {    name: 'abc'    type: 'every',    value: '5m',  })

函数装饰器参数#

@ServerlessFunction 装饰器用于定义函数，通过它可以修改函数名。 ​

函数触发器和 f.yml 的定义 保持一致，当前的定义请参考每个触发器的 interface。 ​

比如：

@ServerlessFunction({  functionName: 'abcde',  initTimeout: 3,       // 初始化超时，只对阿里云 fc 有效，默认 3s  timeout: 3                // 函数执行超时时间，默认 3s})

本地开发#

HTTP 函数本地开发和传统 Web 相同，输入以下命令。

$ npm run dev$ open http://localhost:7001

Midway 会启动 HTTP 服务器，打开浏览器，访问 http://127.0.0.1:7001 ，浏览器会打印出 Hello midwayjs   的信息。

部署函数#

部署函数，直接使用发布命令即可打包并部署函数：

$ npm run deploy
info

如果输错了信息，可以重新执行 npx midway-bin deploy --resetConfig 修改。

这里我们用阿里云 FC 平台来演示，如需部署到腾讯云，请参考 腾讯云部署。

阿里云部署首次需要配置 accountId、accountKey、accountSecret

相关配置获取，可参照下方图片：

点击此处跳转阿里云安全设置页。

点击跳转阿里云个人 AccessKey 页面。

整个部署效果如下：

发布完后，从控制台获取当前的 url 即可访问。

由于开启了自动域名，阿里云会免费增送一个临时域名用开发和调试，后续也可以自己绑定新域名。