- java.lang.Object
-
- org.jline.utils.Log
-
public final class Log extends java.lang.ObjectInternal logging utility for JLine components.The Log class provides a simple logging facility for JLine components, using the
System.LoggerAPI under the hood. It offers methods for logging at various levels (trace, debug, info, warn, error) and supports both direct message logging and lazy evaluation through suppliers.Using
System.Loggerkeeps JLine free of any compile-time dependency on thejava.loggingmodule, which is desirable for consumers building trimmed runtime images withjlink. When thejava.loggingmodule is present at runtime, the defaultSystem.Loggerimplementation routes tojava.util.logging.This class uses a single logger named "org.jline" for all JLine components. The actual log level can be configured through whichever logging backend the running JVM provides a
System.LoggerFinderfor.Key features include:
- Simple static methods for different log levels
- Support for multiple message objects that are concatenated
- Lazy evaluation of log messages using Supplier interfaces
- Automatic exception handling with stack trace logging
- Performance optimization to avoid string concatenation when logging is disabled
Example usage:
// Simple logging Log.debug("Processing command: ", command); // Logging with lazy evaluation Log.trace(() -> "Expensive computation result: " + computeResult()); // Logging exceptions try { // Some operation } catch (Exception e) { Log.error("Failed to process: ", e); }- Since:
- 2.0
-
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static voiddebug(java.lang.Object... messages)static voiddebug(java.util.function.Supplier<java.lang.String> supplier)static voiderror(java.lang.Object... messages)static voidinfo(java.lang.Object... messages)static booleanisDebugEnabled()static voidtrace(java.lang.Object... messages)static voidtrace(java.util.function.Supplier<java.lang.String> supplier)static voidwarn(java.lang.Object... messages)
-
-
-
Method Detail
-
trace
public static void trace(java.lang.Object... messages)
-
trace
public static void trace(java.util.function.Supplier<java.lang.String> supplier)
-
debug
public static void debug(java.util.function.Supplier<java.lang.String> supplier)
-
debug
public static void debug(java.lang.Object... messages)
-
info
public static void info(java.lang.Object... messages)
-
warn
public static void warn(java.lang.Object... messages)
-
error
public static void error(java.lang.Object... messages)
-
isDebugEnabled
public static boolean isDebugEnabled()
-
-