函数实例生命周期回调方法

C#的Initializer回调、PreFreeze回调和PreStop回调方法签名相同，均只有一个Context输入参数，没有返回参数。定义如下。

public void FunctionName(IFcContext context);

您也可以将回调方法设置为静态方法，定义如下。

public static void FunctionName(IFcContext context);

以下示例代码展示一个简单的包含Initializer回调、PreFreeze回调和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 void PreFreeze(IFcContext context)
        {
            IFcLogger logger = context.Logger;
            logger.LogInformation("PreFreeze start");
            logger.LogInformation("Handle PreFreeze: {0}", context.RequestId);
            logger.LogInformation("PreFreeze 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){}
    }
}

示例如下。

• Initializer回调程序：HelloFcApp::Example.Hello::Initialize

• PreFreeze回调程序：HelloFcApp::Example.Hello::PreFreeze

• PreStop回调程序：HelloFcApp::Example.Hello::PreStop

如果使用Serverless Devs工具，需要在s.yaml配置文件中添加Initializer回调程序、PreFreeze回调程序和PreStop回调程序。

• Initializer回调配置

  在function配置下添加initializer和initializationTimeout两个字段。

• PreFreeze回调配置

  在function配置下添加instanceLifecycleConfig.preFreeze字段，包括handler和timeout两个字段。

• PreStop回调配置

  在function配置下添加instanceLifecycleConfig.preStop字段，包括handler和timeout两个字段。

具体示例如下所示。

edition: 1.0.0
name: hello-world  #  项目名称
access: default    #  密钥别名

vars: # 全局变量
  region: cn-shanghai # 地域
  service:
    name: fc-example
    description: 'fc example by serverless devs'

services:
  helloworld: # 业务名称/模块名称
    component: fc
    actions: # 自定义执行逻辑
      pre-deploy: # 在deploy之前运行
        - run: mvn package # 要运行的命令行
          path: ./ # 命令行运行的路径
    props: #  组件的属性值
      region: ${vars.region}
      service: ${vars.service}
      function:
        name: dotnet-lifecycle-hook-demo
        description: 'fc example by serverless devs'
        runtime: dotnetcore3.1
        codeUri: ./target
        handler: example.App::handleRequest
        memorySize: 128
        timeout: 60
        initializer: HelloFcApp::Example.Hello::Initialize
        initializationTimeout: 30
        instanceLifecycleConfig:
          preStop:
            Handler: HelloFcApp::Example.Hello::PreStop
            Timeout: 30
          preFreeze:
            Handler: HelloFcApp::Example.Hello::PreFreeze
            Timeout: 30