高级能力 - 函数上下文 - 《Midway Serverless 使用文档》

Event 转换
FaaSContext
FaaSHTTPContext
FaaSHTTPRequest
FaaSHTTPResponse

Event 转换

midway faas 针对不同平台的情况，进行了入参包裹，同时，在函数使用了 apigw（API 网关）和 http （阿里云）触发器的情况下，对入参（event）做了特殊处理，为了简化和统一写法，将 event 统一规则化成了类似 koa 写法的代码。

普通触发器场景：

export class Index {
  @Inject()
  ctx: FaaSContext;
    async handler(event) {
        return 'hello world'
    }    
}

HTTP 、API 网关触发器场景：

export class Index {
  @Inject()
  ctx: FaaSContext;
    async handler() {
    // 下面两种写法相同
        // this.ctx.body = 'hello world';
    return 'hello world';
    }    
}

FaaSContext

每次函数调用，都会创建一个全新的 ctx（函数上下文）。针对 ctx 上的属性或者方法，我们提供 ts 定义。

ctx.logger

return FaaSLogger

运行时传递下来的每次请求的日志对象，默认为 console。

ctx.logger.info('hello');
ctx.logger.warn('hello');
ctx.logger.error('hello');

ctx.env

return string

当前启动的环境，即 NODE_ENV 或者 MIDWAY_SERVER_ENV 的值，默认为 prod。

ctx.env // 默认 prod

ctx.requestContext

return MidwayRequestContainer

midway faas 的 IoC 请求作用域容器，用于获取其他 IoC 容器中的对象实例。

const userService = await ctx.requestContext.getAsync('userService');

FaaSHTTPContext

FaaSContext 定义继承于 FaaSHTTPContext ，前者作为通用 ctx 定义，后者是在 apigw（API 网关）和 http （阿里云）触发器下才有的能力。

对于普通用户，直接使用 FaaSContext 定义即可。

import { FaaSContext } from '@midwayjs/faas';
@Inject()
ctx: FaaSContext;

在 ctx 对象中，我们提供了一些和编写传统 Koa Web 应用程序类似的 API。这样的好处是减少用户的认知成本，并且，在一定程度上，兼容原有传统代码，兼容社区 middleware 成为了可能。

我们提供了一些和传统类似的 API，支持常用的能力，在不同的平台可能不一定完全相同，我们会在特定 API 中指出。

ctx.request

return FaaSHTTPRequest

FaaS 模拟的 HTTP Request 对象。

ctx.response

return FaaSHTTPResponse

FaaS 模拟的 HTTP Response 对象。

ctx.params

代理自 request.pathParameters ，在 http 触发器（阿里云）和 API 网关触发器下可用。

// /api/user/[id]   /api/user/faas
ctx.params.id   // faas

ctx.set

设置响应头，此方法代理自 response.setHeader 。

ctx.set('X-FaaS-Duration', 2100);

ctx.status

设置返回状态码，此属性代理自 response.statusCode 。

ctx.status = 404;

Request aliases

以下列出的属性是从 Request 对象代理过来

ctx.headers
ctx.method
ctx.url
ctx.path
ctx.ip
ctx.query
ctx.get()
Response aliases

以下列出的属性是从 Response 对象代理过来

ctx.body=
ctx.status= alias to response.statusCode
ctx.type=
ctx.set() alias to response.setHeader

FaaSHTTPRequest

此对象是通过将函数的 event 和 context 入参进行转换得来。

request.headers

包含所有请求头的对象，键值对存储。

request.ip

获取客户端请求 ip。

request.url

客户端请求完整 url。

request.path

客户端请求 path。

request.method

请求的 method。

request.body

POST 请求的 body，已经解析为 JSON。

FaaSHTTPResponse