使用 Java Lambda 函數的層

使用 Lambda 層來封裝您要在多個函數之間重複使用的程式碼和相依性。層通常具備程式庫相依性、自訂執行期或組態檔案。建立層包含三個一般步驟：

本主題包含步驟和指導，說明如何正確封裝和建立具有外部程式庫相依項的 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 執行時期的層路徑

將層新增至函數時，Lambda 會將層內容載入該執行環境的 /opt 目錄。在每一次 Lambda 執行期中，PATH 變數已包含 /opt 目錄中的特定資料夾路徑。為了確保 Lambda 取得您的 layer 內容，您的 layer .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 或 Lambda API 透過 AWS Command Line Interface () 上傳圖層AWS CLI。當您上傳 layer .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 Resource Name (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();
    }
}