[alc] Interface changes in the core package (#434)

Co-authored-by: Daniel Torok <[email protected]>

Author: dtorok

aws-lambda-java-core/src/main/java/com/amazonaws/services/lambda/runtime/LambdaLogger.java

@@ -2,6 +2,8 @@
 
 package com.amazonaws.services.lambda.runtime;
 
+import com.amazonaws.services.lambda.runtime.logging.LogLevel;
+
 /**
  * A low level Lambda runtime logger
  *
@@ -10,7 +12,7 @@ public interface LambdaLogger {
 
     /**
     * Logs a string to AWS CloudWatch Logs
-    * 
+    *
     * <p>
     * Logging will not be done:
     * <ul>
@@ -22,7 +24,7 @@ public interface LambdaLogger {
     * </li>
     * </ul>
     * </p>
-    * 
+    *
     * @param message A string containing the event to log.
     */
     void log(String message);
@@ -32,5 +34,27 @@ public interface LambdaLogger {
      * @param message byte array containing logs
      */
     void log(byte[] message);
+
+    /**
+     * LogLevel aware logging backend function.
+     *
+     * @param message in String format
+     * @param logLevel
+     */
+    default void log(String message, LogLevel logLevel) {
+        log(message);
+    }
+
+    /**
+     * LogLevel aware logging backend function.
+     *
+     * @param message in byte[] format
+     * @param logLevel
+     */
+    default void log(byte[] message, LogLevel logLevel) {
+        log(message);
+    }
+
+
 }
 

aws-lambda-java-core/src/main/java/com/amazonaws/services/lambda/runtime/logging/LogFormat.java

@@ -0,0 +1,17 @@
+/* Copyright 2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. */
+
+package com.amazonaws.services.lambda.runtime.logging;
+
+
+public enum LogFormat {
+    JSON,
+    TEXT;
+
+    public static LogFormat fromString(String logFormat) {
+        try {
+            return LogFormat.valueOf(logFormat.toUpperCase());
+        } catch (Exception e) {
+            throw new IllegalArgumentException("Invalid log format: '" + logFormat + "' expected one of [JSON, TEXT]");
+        }
+    }
+}

aws-lambda-java-core/src/main/java/com/amazonaws/services/lambda/runtime/logging/LogLevel.java

@@ -0,0 +1,25 @@
+/* Copyright 2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. */
+
+package com.amazonaws.services.lambda.runtime.logging;
+
+
+public enum LogLevel {
+    // UNDEFINED log level is used when the legacy LambdaLogger::log(String) function is called
+    // where the loglevel is not defined. In this case we're not filtering the message in the runtime
+    UNDEFINED,
+    TRACE,
+    DEBUG,
+    INFO,
+    WARN,
+    ERROR,
+    FATAL;
+
+    public static LogLevel fromString(String logLevel) {
+        try {
+            return LogLevel.valueOf(logLevel.toUpperCase());
+        } catch (Exception e) {
+            throw new IllegalArgumentException(
+                    "Invalid log level: '" + logLevel + "' expected one of [TRACE, DEBUG, INFO, WARN, ERROR, FATAL]");
+        }
+    }
+}