AWS LambdaJava 中的 內容物件 - AWS Lambda

AWS LambdaJava 中的 內容物件

當 Lambda 執行您的函數時,它會將內容物件傳遞至處理常式。此物件提供的方法和各項屬性提供了有關叫用、函式以及執行環境的資訊。

內容方法

  • getRemainingTimeInMillis() - 傳回執行逾時前剩餘的毫秒數。

  • getFunctionName() – 傳回 Lambda 函數的名稱。

  • getFunctionVersion() - 傳回函數的版本

  • getInvokedFunctionArn() - 傳回用於叫用此函數的 Amazon 資源名稱 (ARN)。指出叫用者是否指定版本號或別名。

  • getMemoryLimitInMB() - 傳回分配給函數的記憶體數量。

  • getAwsRequestId() - 傳回叫用請求的識別符。

  • getLogGroupName() - 傳回函數的日誌群組。

  • getLogStreamName() - 傳回函數執行個體的記錄串流。

  • getIdentity() - (行動應用程式) 傳回已授權請求的 Amazon Cognito 身分的相關資訊。

  • getClientContext() - (行動應用程式) 傳回用戶端應用程式提供給 Lambda 的用戶端內容。

  • getLogger() - 傳回函數的 Logger 物件

下面的例子顯示使用內容物件存取 Lambda 記錄器的函數。

範例 Handler.java

package example; import com.amazonaws.services.lambda.runtime.Context import com.amazonaws.services.lambda.runtime.RequestHandler import com.amazonaws.services.lambda.runtime.LambdaLogger ... // Handler value: example.Handler public class Handler implements RequestHandler<Map<String,String>, String>{ Gson gson = new GsonBuilder().setPrettyPrinting().create(); @Override public String handleRequest(Map<String,String> event, Context context) { LambdaLogger logger = context.getLogger(); String response = new String("200 OK"); // log execution details logger.log("ENVIRONMENT VARIABLES: " + gson.toJson(System.getenv())); logger.log("CONTEXT: " + gson.toJson(context)); // process event logger.log("EVENT: " + gson.toJson(event)); logger.log("EVENT TYPE: " + event.getClass().toString()); return response; } }

該函數會將內容物件序列化為 JSON 並將其記錄在其日誌串流中。

範例 記錄輸出

START RequestId: 6bc28136-xmpl-4365-b021-0ce6b2e64ab0 Version: $LATEST ... CONTEXT: { "memoryLimit": 512, "awsRequestId": "6bc28136-xmpl-4365-b021-0ce6b2e64ab0", "functionName": "java-console", ... } ... END RequestId: 6bc28136-xmpl-4365-b021-0ce6b2e64ab0 REPORT RequestId: 6bc28136-xmpl-4365-b021-0ce6b2e64ab0 Duration: 198.50 ms Billed Duration: 200 ms Memory Size: 512 MB Max Memory Used: 90 MB Init Duration: 524.75 ms

內容物件的介面可在 aws-lambda-java-core 程式庫中使用。您可以實作此介面來建立測試的內容類別。下面的例子顯示針對大多數屬性和進行中測試記錄器傳回虛擬值的內容類別。

範例 src/test/java/example/TestContext.java

package example; import com.amazonaws.services.lambda.runtime.Context; import com.amazonaws.services.lambda.runtime.CognitoIdentity; import com.amazonaws.services.lambda.runtime.ClientContext; import com.amazonaws.services.lambda.runtime.LambdaLogger public class TestContext implements Context{ public TestContext() {} public String getAwsRequestId(){ return new String("495b12a8-xmpl-4eca-8168-160484189f99"); } public String getLogGroupName(){ return new String("/aws/lambda/my-function"); } ... public LambdaLogger getLogger(){ return new TestLogger(); } }

如需記錄日誌的詳細資訊,請參閱 Java 中的 AWS Lambda 函數記錄

範例應用程式中的內容

本指南的 GitHub 儲存庫包含示範內容物件使用方式的範例應用程式。每個範例應用程式都包含可輕鬆部署和清理的指令碼、AWS Serverless Application Model (AWS SAM) 範本和支援資源。

以 Java 編寫的範例 Lambda 應用程式

  • blank-java - 一種 Java 函數,它示範如何使用 Lambda 的 Java 程式庫、記錄、環境變數、層、AWS X-Ray 追蹤、單元測試和 AWS 開發套件。

  • java-basic - 具有單元測試和變數日誌記錄組態的最小 Java 函數。

  • java-events - 使用 aws-lambda-java-events 程式庫最新版本 (3.0.0 及更新版本) 的最小 Java 函數。這些範例不需要 AWS 開發套件做為相依項目。

  • s3-java - 一種 Java 函數,它處理來自 Amazon S3 的通知事件,並使用 Java Class Library (JCL) 以從上傳的映像檔案建立縮圖。

所有的範例應用程式都有單元測試的測試內容類別。java-basic 應用程式示範如何使用內容物件以取得記錄器。它會使用 SLF4J 和 Log4J 2 提供一個適用於本地單元測試的記錄器。