AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

C# 中的 AWS Lambda 函数处理程序

创建 Lambda 函数时，需指定一个处理程序以供 AWS Lambda 服务在代表您执行函数时调用。

将 Lambda 函数处理程序定义为某个类中的实例或静态方法。如果您希望访问 Lambda context 对象，可通过定义类型为 ILambdaContext 的方法参数来实现，该参数是一个您可以用来访问有关当前执行的信息（例如，当前函数的名称、内存限制、剩余执行时间和日志记录）的接口。

returnType handler-name(inputType input, ILambdaContext context) {
   ...
}

在该语法中，需要注意以下方面：

处理流

仅 System.IO.Stream 类型在默认情况下可作为输入参数受支持。

例如，考虑以下 C# 示例代码。

using System.IO;

namespace Example
{            
  public class Hello
  {
    public Stream MyHandler(Stream stream)
    {
       //function logic
    }
  }
}

在此 C# 示例代码中，第一个处理程序参数是处理程序 (MyHandler) 的输入，它可以是事件数据（由 Amazon S3 之类的事件源发布），也可以是您提供的自定义输入（如本示例中的 Stream）或任何自定义数据对象。输出的类型为 Stream。

处理标准数据类型

其他所有类型（如下所列）均需要您指定串行器。

除非函数输入和输出参数的类型为 System.IO.Stream，否则您需要对这些参数执行序列化。AWS Lambda 提供了可在应用程序的程序集或方法级别应用的默认串行器，或者您也可以通过实施由 Amazon.Lambda.Core 库提供的 ILambdaSerializer 接口定义自己的串行器。有关更多信息，请参阅C# 中的 AWS Lambda 部署程序包。

要向某个方法添加默认的串行器属性，请先添加对 project.json 文件中 Amazon.Lambda.Serialization.Json 的依赖关系。

{
    "version": "1.0.0-*",
    "dependencies":{
        "Microsoft.NETCore.App": {
            "type": "platform",
            "version": "1.0.1"
        },
        "Amazon.Lambda.Serialization.Json": "1.3.0"
    },
    "frameworks": {
        "netcoreapp1.0": {
            "imports": "dnxcore50"
        }
    }
}

以下示例说明了您可以分别针对自己选择的各种方法灵活地指定默认 Json.NET 串行器：

public class ProductService{
    [LambdaSerializer(typeof(Amazon.Lambda.Serialization.Json.JsonSerializer))]
    public Product DescribeProduct(DescribeProductRequest request)
    {
      return catalogService.DescribeProduct(request.Id);
    }
   
   [LambdaSerializer(typeof(MyJsonSerializer))]
   public Customer DescribeCustomer(DescribeCustomerRequest request)
   {
      return customerService.DescribeCustomer(request.Id);
   }
}

处理程序签名

创建 Lambda 函数时，您必须提供一个处理程序字符串，告知 AWS Lambda 在何处查找要调用的代码。在 C# 中，格式如下：

ASSEMBLY::TYPE::METHOD，其中：

签名最终将是以下格式：Assembly::Namespace.ClassName::MethodName

请考虑以下示例：

using System.IO;

namespace Example
{            
  public class Hello
  {
    public Stream MyHandler(Stream stream)
    {
       //function logic
    }
  }
}

处理程序字符串为：HelloWorldApp::Example.Hello::MyHandler

序列化 Lambda 函数

对于任何使用 Stream 对象以外的输入或输出类型的 Lambda 函数，您都需要向应用程序中添加一个序列化库。您可以通过下列方式来执行此操作：

您可以使用任意一个串行器，方法是将其作为依赖项添加到您的 MyProject.csproj 文件中。

...
 <ItemGroup>
    <PackageReference Include="Amazon.Lambda.Core" Version="1.0.0" />
    <PackageReference Include="Amazon.Lambda.Serialization.Json" Version="1.3.0" />
  </ItemGroup>

然后将其添加到您的 AssemblyInfo.cs 文件中。例如，如果您使用的是默认 Json.NET 串行器，则需要添加以下项：

[assembly:LambdaSerializer(typeof(Amazon.Lambda.Serialization.Json.JsonSerializer))]

Lambda 函数处理程序限制

请注意，处理程序签名存在一些限制。

在使用 C# 编写的 AWS Lambda 函数中应用 Async

如果您知道自己的 Lambda 函数需要长时间的运行过程，例如上传大型文件到 Amazon S3 或者从 DynamoDB 中读取大量记录，则您可以利用 async/await 模式。当您使用此签名时，Lambda 会同步执行函数并等待该函数返回响应或执行超时。

public async Task<Response> ProcessS3ImageResizeAsync(SimpleS3Event input)
{
   var response = await client.DoAsyncWork(input);
   return response;
}

使用此模式时，您必须谨记以下几项注意事项：