Amazon.Lambda.Core 2.2.0

Amazon.Lambda.Core

此包包含可在 AWS Lambda 平台上运行 .NET 代码时有用的接口和类。

ILambdaContext

可以使用 Amazon.Lambda.Core.ILambdaContext 接口在处理函数中使用，以访问关于当前执行的详细信息，例如当前函数的名称、内存限制、剩余执行时间以及日志。

以下是如何在处理函数中使用此接口的一个示例。函数执行一个简单的 ToUpper 内容转换，并将一些上下文数据写入到控制台。

public string ToUpper(string input, ILambdaContext context)
{
    Console.WriteLine("Function name: " + context.FunctionName);
    Console.WriteLine("Max mem allocated: " + context.MemoryLimitInMB);
    Console.WriteLine("Time remaining: " + context.RemainingTime);
    Console.WriteLine("CloudWatch log stream name: " + context.LogStreamName);
    Console.WriteLine("CloudWatch log group name: " + context.LogGroupName);

    return input?.ToUpper();
}

此接口的实例通过 Items 属性和键 "LAMBDA_CONTEXT / LambdaContext"附加到任何 ControllerBase.Request.HttpContext 实例。

下面是如何在控制器方法中使用此接口的一个示例。

[ApiController]
public class TestController : ControllerBase
{
    [HttpGet("/[controller]")]
    public IActionResult Get()
    {
        Response.Headers.Add("Access-Control-Allow-Origin", "*"); // NOTE: Should be configured via app.UseCors in Startup.cs

        var context = (ILambdaContext)Request.HttpContext.Items[APIGatewayProxyFunction.LAMBDA_CONTEXT];
        var tmp = new
        {
            context.AwsRequestId,
            context.FunctionName,
            context.MemoryLimitInMB,
            context.LogStreamName,
            context.LogGroupName
        };
        return new OkObjectResult(tmp);
    }
}

以下几节描述了通过 ILambdaContext 可以访问的各种其他接口。

IClientContext

Amazon.Lambda.Core.IClientContext 接口提供有关客户端应用程序和设备的信息，当 Lambda 函数通过 AWS Mobile SDK 被调用时。这包括环境信息，例如设备的品牌和型号、关于应用程序的信息，以及用户自定义的键值对，描述了此应用程序的安装。该接口位于 ILambdaContext.ClientContext 之下。

IClientApplication

Amazon.Lambda.Core.IClientApplication 接口提供有关客户端应用程序的信息，当 Lambda 函数通过 AWS Mobile SDK 被调用时。这包括应用标题、其版本等。该接口可以在 ILambdaContext.ClientContext.Client 下找到。

ICognitoIdentity

Amazon.Lambda.Core.ICognitoIdentity 接口提供通过 AWS Mobile SDK 被调用时的 Amazon Cognito 身份提供者的信息。这包括 Amazon Cognito IdentityId 和 IdentityPoolId。该接口可以在 ILambdaContext.Identity 下找到。

ILambdaLogger

Amazon.Lambda.Core.ILambdaLogger 接口允许您的函数将数据记录到 CloudWatch。该接口定义了 Log 和 LogLine 方法。这两个方法都接受一个字符串，并在事件大小在允许的范围内时，产生一个或没有行终止符的 CloudWatch Logs 事件。

以下是如何在处理函数中使用该接口的示例。该函数执行一个简单的 ToUpper 内容转换，同时记录上下文数据。

public string ToUpper(string input, ILambdaContext context)
{
    context.Logger.Log("Function name: " + context.FunctionName);
    context.Logger.Log("Max mem allocated: " + context.MemoryLimitInMB);
    context.Logger.Log("Time remaining: " + context.RemainingTime);

    return input?.ToUpper();
}

ILambdaSerializer

Amazon.Lambda.Core.ILambdaSerializer 接口允许您实现自己的序列化程序以在任意类型和 Lambda 流之间进行转换。

默认情况下，Lambda 函数只能使用 Stream 类型作为输入或输出。要使用其他类型，您可以编写自己的实现 ILambdaSerializer 的序列化程序，或者使用 Amazon.Lambda.Serialization.Json 包来序列化和反序列化 JSON 数据。

有关 ILambdaSerializer 的示例实现，请参阅 Amazon.Lambda.Serialization.Json.JsonSerializer 类。

LambdaSerializerAttribute

Amazon.Lambda.Core.LambdaSerializerAttribute 是一个属性，它用于指示当将 .NET 类型转换为 Lambda 支持的类型时，Lambda 容器应使用哪个序列化程序。此属性可以位于程序集或处理方法上。如果两者都指定，则方法属性具有优先级。

以下是设置该属性在程序集上的示例。

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

以下是方法如何应用于处理方法。

[LambdaSerializer(typeof(XmlSerializer))]
public Response CustomSerializerMethod(Request input)
{
    ...
}