函数实例生命周期回调方法
本文介绍C#运行时实现函数实例生命周期回调的方法。
背景信息
当您实现并配置函数实例生命周期回调后，函数计算将在相关实例生命周期事件发生时调用对应的回调程序。C#运行时支持Initializer和PreStop回调。更多信息，请参见函数实例生命周期。
函数实例生命周期回调程序与正常调用请求计费规则一致，但其执行日志只能在函数日志、实例日志或高级日志中查询，调用请求列表不会展示回调程序日志。具体操作，请参见查询回调函数相关日志。
回调方法签名
初始化回调程序（Initializer回调）
在函数实例启动成功之后，运行请求处理程序（Handler）之前执行。函数计算保证在一个实例生命周期内，成功且只成功执行一次Initializer回调。如果您的Initializer回调第一次执行失败，那么此次函数调用直接返回失败，下次调用时，会再新建一个函数实例执行initializer回调。
预停止回调程序（PreStop回调）
在函数实例销毁前执行。
C#的Initializer回调和PreStop回调方法签名相同，均只有一个Context输入参数，没有返回参数。定义如下。
public void FunctionName(IFcContext context);您也可以将回调方法设置为静态方法，定义如下。
public static void FunctionName(IFcContext context);简单示例：流式事件请求处理程序
以下示例代码展示一个简单的包含Initializer回调和PreStop回调的程序。
using System;
using System.IO;
using System.Threading.Tasks;
using Aliyun.Serverless.Core;
using Microsoft.Extensions.Logging;
namespace Example
{
public class Hello
{
public void Initialize(IFcContext context)
{
IFcLogger logger = context.Logger;
logger.LogInformation("Initialize start");
logger.LogInformation("Handle initializer: {0}", context.RequestId);
logger.LogInformation("Initialize end");
}
public void PreStop(IFcContext context)
{
IFcLogger logger = context.Logger;
logger.LogInformation("PreStop start");
logger.LogInformation("Handle PreStop: {0}", context.RequestId);
logger.LogInformation("PreStop end");
}
public async Task<Stream> StreamHandler(Stream input, IFcContext context)
{
IFcLogger logger = context.Logger;
logger.LogInformation("Handle request: {0}", context.RequestId);
MemoryStream copy = new MemoryStream();
await input.CopyToAsync(copy);
copy.Seek(0, SeekOrigin.Begin);
return copy;
}
static void Main(string[] args){}
}
}配置生命周期回调函数
通过控制台配置
在函数计算控制台的函数配置中设置生命周期回调，具体操作，请参见函数实例生命周期。回调方法的格式和请求处理程序的格式相同，为程序集名称::命名空间.类名::方法名。更多信息，请参见请求处理程序（Handler）。
示例如下。
Initializer回调程序：
HelloFcApp::Example.Hello::InitializePreStop回调程序：
HelloFcApp::Example.Hello::PreStop
通过Serverless Devs配置
如果使用Serverless Devs工具，需要在s.yaml配置文件中添加Initializer回调程序、PreFreeze回调程序和PreStop回调程序。
Initializer回调配置
在function配置下添加instanceLifecycleConfig.initializer字段，包括handler和timeout两个字段。
PreStop回调配置
在function配置下添加instanceLifecycleConfig.preStop字段，包括handler和timeout两个字段。
具体示例如下所示。
# ------------------------------------
# 官方手册: https://manual.serverless-devs.com/user-guide/aliyun/#fc3
# 常见小贴士: https://manual.serverless-devs.com/user-guide/tips/
# 有问题快来钉钉群问一下吧：33947367
# ------------------------------------
edition: 3.0.0
name: hello-world-app
access: "default"
vars: # 全局变量
region: "cn-hangzhou"
resources:
hello_world:
component: fc3
actions:
pre-${regex('deploy|local')}:
- run: dotnet publish -c Release -o ./target
path: ./HelloWorldApp
props:
region: ${vars.region}
functionName: "start-dotnetcore-p6jp"
description: 'hello world by serverless devs'
runtime: "dotnetcore3.1"
code: ./HelloWorldApp/target/
handler: HelloWorldApp::Example.Hello::StreamHandler
memorySize: 128
timeout: 10
instanceLifecycleConfig: # 扩展函数
initializer: # initializer函数
handler: HelloFcApp::Example.Hello::Initialize
timeout: 60
preStop: # PreStop函数
handler: HelloFcApp::Example.Hello::PreStop # 函数入口
timeout: 60 # 超时时间
# triggers:
# - triggerName: httpTrigger # 触发器名称
# triggerType: http # 触发器类型
# description: 'xxxx'
# qualifier: LATEST # 触发服务的版本
# triggerConfig:
# authType: anonymous # 鉴权类型，可选值：anonymous、function
# disableURLInternet: false # 是否禁用公网访问 URL
# methods: # HTTP 触发器支持的访问方法，可选值：GET、POST、PUT、DELETE、HEAD
# - GET
# - POST关于Serverless Devs的YAML配置规范，请参见Serverless Devs常用命令。
查看实例生命周期回调函数日志
您可以通过函数日志功能查看回调函数日志。
登录函数计算控制台，在左侧导航栏，单击函数。
在顶部菜单栏，选择地域，然后在函数页面，单击目标函数。
在函数详情页面，选择测试页签，单击测试函数，然后选择。
在函数日志页签，您可以查看函数的调用日志和Initializer回调日志，示例如下。
2023-09-06 11:18:10FC Initialize Start RequestId: 1-64f7ef72-64caf1ff0046194d9a26bbd7 2023-09-06 11:18:10load code for handler:index.initialize 2023-09-06 11:18:102023-09-06 11:18:10 1-64f7ef72-64caf1ff0046194d9a26bbd7 [verbose] initializer 2023-09-06 11:18:10FC Initialize End RequestId: 1-64f7ef72-64caf1ff0046194d9a26bbd7 2023-09-06 11:18:10FC Invoke Start RequestId: 1-64f7ef72-64caf1ff0046194d9a26bbd7 2023-09-06 11:18:10load code for handler:index.handler 2023-09-06 11:18:10FC Invoke End RequestId: 1-64f7ef72-64caf1ff0046194d9a26bbd7因为每个函数实例会缓存一段时间，不会马上销毁，因此不能立即查看PreStop回调日志。如需快速触发PreStop回调，可更新函数配置或者函数代码。更新完成后，再次查看函数日志，您可以查看PreStop回调日志。示例如下。
2023-09-06 11:08:10FC PreStop Start RequestId: 944bca62-b209-47a1-9e48-2723647bce0a 2023-09-06 11:08:10load code for handler:index.preStop 2023-09-06 11:08:102023-09-06 11:08:10 944bca62-b209-47a1-9e48-2723647bce0a [verbose] preStop 2023-09-06 11:08:10FC PreStop End RequestId: 944bca62-b209-47a1-9e48-2723647bce0a
- 本页导读 （1）