本文介绍Custom Container中事件请求处理程序的结构特点、使用示例和常见问题。

背景介绍

在Custom Container中，函数计算会将Common Headers、Body、POST方法以及/invoke、/initialize路径转发给容器中的HTTP Server。您可以选择实现类似官方支持的Runtime（例如Golang Runtime）的context和event函数签名。您也可以直接使用入参请求头（Headers）和请求体 （Body）来编写函数的业务逻辑。更多信息，请参见Custom Runtime事件函数调用。

函数调用说明

当函数是事件请求处理程序时，Http Server仅需实现Path为/invoke和Method为POST的对应逻辑即可。

Path 输入请求 预期响应
POST /invoke
  • 请求体：函数输入（InvokeFunction时指定的Payload）。
  • 请求头：Common Request Headers。具体信息，请参见函数计算公共请求头。
    注意 Content-Type为application/octet-stream。
响应体：函数Handler的返回值，包括响应码和响应头。
  • 响应码StatusCode
    • 200：成功状态。
    • 404：失败状态。
  • 响应头x-fc-status
    • 200：成功状态。
    • 404：失败状态。
通过Headers中的x-fc-status响应，向函数计算汇报本地函数是否执行成功。
  • 不设置x-fc-status：函数计算默认本次调用是成功执行的，但是您的函数可能有异常，没有向函数计算汇报，函数计算会认为这次函数执行没有报错，在业务逻辑上可能没有影响，但是在监控可观测性上会有影响。如下图所示：image8hanshujisuanruntime
  • 设置x-fc-status：当您的函数存在异常，通过x-fc-status响应向函数计算汇报本次函数执行失败，并将错误堆栈信息打印到日志中。如下图所示：image9runtimefc
说明 在返回的HTTP响应中，建议您同时设置StatusCode和x-fc-status。

代码示例

在以下Node.js Express示例中，POST方法和/initialize路径会在函数实例初始化时被函数计算调用，POST方法和/invoke路径为函数计算被调用时的Handler，通过req.headers以及req.body获取context和event并将函数返回结果通过HTTP Response结构体输出。 

'use strict';

const express = require('express');

// Constants
const PORT = 9000;
const HOST = '0.0.0.0';
const app = express();
// Parse request body as JSON
app.use(express.json())


// initialize example, need config Initializer in function meta
app.post('/initialize', (req, res) => {
  console.log(req.body)
  res.send('Hello FunctionCompute, /initialize\n');
});


// Event function invocation
app.post('/invoke', (req, res) => {
  console.log(req.body)
  res.send('Hello FunctionCompute, event function\n');
});

var server = app.listen(PORT, HOST);
console.log(`Running on http://${HOST}:${PORT}`);

server.timeout = 0; // never timeout
server.keepAliveTimeout = 0; // keepalive, never timeout

多语言使用示例

Python

C++

Node.js

常见问题