使用 Java Lambda 函数的层

Lambda 层是包含补充代码或数据的 .zip 文件存档。层通常包含库依赖项、自定义运行时系统或配置文件。创建层涉及三个常见步骤：

本主题包含有关如何正确打包并创建具有外部库依赖项的 Java Lambda 层的步骤和指南。

先决条件

要完成本部分中的步骤，您必须满足以下条件：

Apache Maven 3.8.6
...
Java version: 21.0.2, vendor: Oracle Corporation, runtime: /Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home
...

在整个主题中，我们会引用 awsdocs GitHub 存储库中的 layer-java 示例应用程序。该应用程序包含用于下载依赖项并生成层的脚本。该应用程序还包含相应的函数，函数使用来自层的依赖项。创建层后，即可部署并调用相应的函数来验证一切是否正常运行。由于使用 Java 21 运行时系统来运行这些函数，因此这些层还必须与 Java 21 兼容。

layer-java 示例应用程序在两个子目录中包含一个示例。layer 目录包含用于定义层依赖项的 pom.xml 文件，以及用于生成层的脚本。function 目录包含示例函数，用于帮助测试该层是否正常工作。本教程将演示如何创建并打包该层。

Java 层与 Amazon Linux 的兼容性

创建层的第一步是将所有层内容捆绑到.zip 文件存档中。由于 Lambda 函数在 Amazon Linux 上运行，因此层内容必须能够在 Linux 环境中编译和构建。

Java 代码采用独立于平台的设计，即便本地计算机不使用 Linux 环境，您也可以在本地计算机上打包层。将 Java 层上传到 Lambda 后，Java 层仍将与 Amazon Linux 兼容。

Java 运行时系统的层路径

当您向函数添加层时，Lambda 会将层内容加载到该执行环境的 /opt 目录中。对于每个 Lambda 运行时系统，PATH 变量都包括 /opt 目录中的特定文件夹路径。为确保 PATH 变量能够获取层内容，层 .zip 文件应在以下文件夹路径中具有依赖项：

例如，您在本教程中创建生成的层.zip 文件具有以下目录结构：

layer_content.zip
└ java
    └ lib
        └ layer-java-layer-1.0-SNAPSHOT.jar

layer-java-layer-1.0-SNAPSHOT.jar JAR 文件（包含所有必需依赖项的 uber-jar）位于 java/lib 目录中，位置正确。这可确保 Lambda 在函数调用期间可以找到该库。

打包层内容

本示例将以下两个 Java 库打包到单个 JAR 文件中：

完成以下步骤，安装并打包层内容。

创建层

在本部分，您会获取在上一部分中生成的 layer_content.zip 文件，将其作为 Lambda 层上传。您可以使用 AWS Management Console 上传层，也可以通过 AWS Command Line Interface（AWS CLI）使用 Lambda API 上传层。上传层 .zip 文件时，在以下 PublishLayerVersion AWS CLI 命令中，将 java21 指定为兼容的运行时系统，并将 arm64 指定为兼容的架构。

aws lambda publish-layer-version --layer-name java-jackson-layer \
    --zip-file fileb://layer_content.zip \
    --compatible-runtimes java21 \
    --compatible-architectures "arm64"

注意响应中的 LayerVersionArn，与 arn:aws:lambda:us-east-1:123456789012:layer:java-jackson-layer:1 类似。在本教程的下一步中，在将层添加到函数时，您要用到此 Amazon 资源名称（ARN）。

将层添加到函数

在本部分，您要部署在函数代码中使用 Jackson 库的示例 Lambda 函数，然后附加该层。要部署该函数，您需要一个 使用执行角色定义 Lambda 函数权限。如果目前没有执行角色，则按照可折叠部分中的步骤操作。

Lambda 函数代码接受 Map<String, String> 作为输入，并使用 Jackson 将输入写为 JSON 字符串，然后再将其转换为预定义的 F1Car Java 对象。最后，函数使用 F1Car 对象中的字段来构造函数返回的字符串。

package example;

import com.amazonaws.services.lambda.runtime.Context;
import com.fasterxml.jackson.databind.ObjectMapper;

import java.io.IOException;
import java.util.Map;

public class Handler {

    public String handleRequest(Map<String, String> input, Context context) throws IOException {
        // Parse the input JSON
        ObjectMapper objectMapper = new ObjectMapper();
        F1Car f1Car = objectMapper.readValue(objectMapper.writeValueAsString(input), F1Car.class);

        StringBuilder finalString = new StringBuilder();
        finalString.append(f1Car.getDriver());
        finalString.append(" is a driver for team ");
        finalString.append(f1Car.getTeam());
        return finalString.toString();
    }
}