Amazon.Lambda.Serialization.SystemTextJson 2.4.3

Amazon.Lambda.Serialization.SystemTextJson

此包包含一个定制的 Amazon.Lambda.Core.ILambdaSerializer 实现，该实现使用 System.Text.Json 排序处理 Lambda 函数中 .NET 类型。此排序器针对 .NET Core 3.1，因此不能与 .NET Core 2.1 Lambda 运行时一起使用。

如果要针对 .NET Core 3.1，则强烈建议使用 Amazon.Lambda.Serialization.Json，这可以显著降低 Lambda 的冷启动性能。

此排序器可以存在于程序集或处理程序方法中。如果同时指定，则方法属性具有优先级。

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

[assembly: Amazon.Lambda.Core.LambdaSerializer(typeof(Amazon.Lambda.Serialization.SystemTextJson.DefaultLambdaJsonSerializer))]

这就是如何将该方法应用于处理器方法。

[Amazon.Lambda.Core.LambdaSerializer(typeof(Amazon.Lambda.Serialization.SystemTextJson.DefaultLambdaJsonSerializer))]
public Response CustomSerializerMethod(Request input)
{
    ...
}

使用 C# 源生成器进行序列化

C# 9 提供了源生成器，允许在编译时进行代码生成。这可以减少对反射 API 的使用，并提高应用程序启动时间。.NET 6 更新了本机 JSON 库 System.Text.Json 使用源生成器，允许在不使用反射 API 的情况下进行 JSON 解析。

要使用 Lambda 中的 JSON 序列化源生成器，您必须在项目中定义一个新的空类，使其从 System.Text.Json.Serialization.JsonSerializerContext 继承。此类必须是部分类，因为源生成器会向此类添加代码以处理序列化。在空的部分类上，为源生成器必须为其生成序列化代码的每个 .NET 类型添加 JsonSerializable 属性。

以下是一个名为 HttpApiJsonSerializerContext 的示例，它注册了亚马逊 API 网关 HTTP API 事件和响应类型，以便生成序列化代码

[JsonSerializable(typeof(APIGatewayHttpApiV2ProxyRequest))]
[JsonSerializable(typeof(APIGatewayHttpApiV2ProxyResponse))]
public partial class HttpApiJsonSerializerContext : JsonSerializerContext
{
}

要注册序列化源生成器，请使用 LambdaSerializer 属性，传入 SourceGeneratorLambdaJsonSerializer 类型，并将自定义上下文类型（例如 HttpApiJsonSerializerContext）作为泛型参数。

[assembly: LambdaSerializer(
        typeof(SourceGeneratorLambdaJsonSerializer
                    <APIGatewayExampleImage.HttpApiJsonSerializerContext>))]

自定义序列化选项

Both DefaultLambdaJsonSerializer 和 SourceGeneratorLambdaJsonSerializer 会构造一个 JsonSerializerOptions 实例，用于自定义 Lambda JSON 事件的序列化和反序列化。例如，添加特殊转换器和命名策略。

为了进一步自定义 JsonSerializerOptions，创建一个新的类型，从扩展 DefaultLambdaJsonSerializer 或 SourceGeneratorLambdaJsonSerializer 继承，并将一个 Action 自定义器传递给基构造函数。然后，使用 LambdaSerializer 属性将新类型注册为序列化器。以下是一个自定义序列化器的示例。

public class CustomLambdaSerializer : DefaultLambdaJsonSerializer
{
    public CustomLambdaSerializer()
        : base(CreateCustomizer())
    { }

    private static Action<JsonSerializerOptions> CreateCustomizer()
    {
        return (JsonSerializerOptions options) =>
        {
            // Customize options
        };
    }
}