Interface Logger

All Known Implementing Classes:
AsyncLogger
public interface Logger
Logger Interface - Core Logging Contract 日志记录器接口 - 核心日志契约

This interface defines the standard logging operations. Implementations delegate to underlying logging frameworks (SLF4J, Log4j2, JUL, etc.).

此接口定义标准日志操作。实现委托给底层日志框架（SLF4J、Log4j2、JUL 等）。

Features | 特性:

  • Standard log levels (TRACE, DEBUG, INFO, WARN, ERROR) - 标准日志级别
  • Parameterized logging with {} placeholders - 使用 {} 占位符的参数化日志
  • Lambda-based lazy evaluation - 基于 Lambda 的延迟求值
  • Marker support for log categorization - 标记支持用于日志分类
  • Exception logging with stack traces - 带堆栈跟踪的异常日志

Example | 示例:

Logger log = LoggerFactory.getLogger(MyService.class);

// Simple logging
log.info("Application started");

// Parameterized logging
log.info("User {} logged in from {}", userId, ipAddress);

// Lambda lazy evaluation
log.debug(() -> "Expensive computation: " + computeValue());

// Exception logging
log.error("Operation failed", exception);

Security | 安全性:

  • Thread-safe: Implementation-dependent - 线程安全: 取决于实现
  • Null-safe: No (message must not be null) - 空值安全: 否（消息不能为 null）
Since:
JDK 25, opencode-base-log V1.0.0
Author:
Leon Soo www.LeonSoo.com
See Also:

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    debug(Marker marker, String message)
    Logs a message at DEBUG level with a marker.
    void
    debug(Marker marker, String format, Object... args)
    Logs a message at DEBUG level with a marker and parameters.
    void
    debug(String message)
    Logs a message at DEBUG level.
    void
    debug(String format, Object... args)
    Logs a message at DEBUG level with parameters.
    void
    debug(String message, Throwable throwable)
    Logs a message at DEBUG level with an exception.
    void
    debug(Supplier<String> messageSupplier)
    Logs a message at DEBUG level using lazy evaluation.
    void
    error(Marker marker, String message)
    Logs a message at ERROR level with a marker.
    void
    error(Marker marker, String format, Object... args)
    Logs a message at ERROR level with a marker and parameters.
    void
    error(Marker marker, String message, Throwable throwable)
    Logs a message at ERROR level with a marker and exception.
    void
    error(String message)
    Logs a message at ERROR level.
    void
    error(String format, Object... args)
    Logs a message at ERROR level with parameters.
    void
    error(String message, Throwable throwable)
    Logs a message at ERROR level with an exception.
    void
    error(Throwable throwable)
    Logs an exception at ERROR level.
    void
    error(Supplier<String> messageSupplier)
    Logs a message at ERROR level using lazy evaluation.
    void
    error(Supplier<String> messageSupplier, Throwable throwable)
    Logs a message at ERROR level using lazy evaluation with exception.
    String
    getName()
    Returns the name of this logger.
    void
    info(Marker marker, String message)
    Logs a message at INFO level with a marker.
    void
    info(Marker marker, String format, Object... args)
    Logs a message at INFO level with a marker and parameters.
    void
    info(String message)
    Logs a message at INFO level.
    void
    info(String format, Object... args)
    Logs a message at INFO level with parameters.
    void
    info(String message, Throwable throwable)
    Logs a message at INFO level with an exception.
    void
    info(Supplier<String> messageSupplier)
    Logs a message at INFO level using lazy evaluation.
    boolean
    isDebugEnabled()
    Checks if DEBUG level is enabled.
    boolean
    isDebugEnabled(Marker marker)
    Checks if DEBUG level is enabled for the specified marker.
    boolean
    isEnabled(LogLevel level)
    Checks if the specified level is enabled.
    boolean
    isErrorEnabled()
    Checks if ERROR level is enabled.
    boolean
    isErrorEnabled(Marker marker)
    Checks if ERROR level is enabled for the specified marker.
    boolean
    isInfoEnabled()
    Checks if INFO level is enabled.
    boolean
    isInfoEnabled(Marker marker)
    Checks if INFO level is enabled for the specified marker.
    boolean
    isTraceEnabled()
    Checks if TRACE level is enabled.
    boolean
    isTraceEnabled(Marker marker)
    Checks if TRACE level is enabled for the specified marker.
    boolean
    isWarnEnabled()
    Checks if WARN level is enabled.
    boolean
    isWarnEnabled(Marker marker)
    Checks if WARN level is enabled for the specified marker.
    void
    log(LogLevel level, String message)
    Logs a message at the specified level.
    void
    log(LogLevel level, String format, Object... args)
    Logs a message at the specified level with parameters.
    void
    log(LogLevel level, String message, Throwable throwable)
    Logs a message at the specified level with an exception.
    void
    trace(Marker marker, String message)
    Logs a message at TRACE level with a marker.
    void
    trace(Marker marker, String format, Object... args)
    Logs a message at TRACE level with a marker and parameters.
    void
    trace(String message)
    Logs a message at TRACE level.
    void
    trace(String format, Object... args)
    Logs a message at TRACE level with parameters.
    void
    trace(String message, Throwable throwable)
    Logs a message at TRACE level with an exception.
    void
    trace(Supplier<String> messageSupplier)
    Logs a message at TRACE level using lazy evaluation.
    void
    warn(Marker marker, String message)
    Logs a message at WARN level with a marker.
    void
    warn(Marker marker, String format, Object... args)
    Logs a message at WARN level with a marker and parameters.
    void
    warn(Marker marker, String message, Throwable throwable)
    Logs a message at WARN level with a marker and exception.
    void
    warn(String message)
    Logs a message at WARN level.
    void
    warn(String format, Object... args)
    Logs a message at WARN level with parameters.
    void
    warn(String message, Throwable throwable)
    Logs a message at WARN level with an exception.
    void
    warn(Supplier<String> messageSupplier)
    Logs a message at WARN level using lazy evaluation.

  • Method Details

    • getName

      String getName()
      Returns the name of this logger. 返回此日志记录器的名称。
      Returns:
      the logger name - 日志记录器名称

    • isTraceEnabled

      boolean isTraceEnabled()
      Checks if TRACE level is enabled. 检查 TRACE 级别是否启用。
      Returns:
      true if enabled - 如果启用返回 true

    • isTraceEnabled

      boolean isTraceEnabled(Marker marker)
      Checks if TRACE level is enabled for the specified marker. 检查指定标记的 TRACE 级别是否启用。
      Parameters:
      marker - the marker - 标记
      Returns:
      true if enabled - 如果启用返回 true

    • trace

      void trace(String message)
      Logs a message at TRACE level. 在 TRACE 级别记录消息。
      Parameters:
      message - the message - 消息

    • trace

      void trace(String format, Object... args)
      Logs a message at TRACE level with parameters. 在 TRACE 级别记录带参数的消息。
      Parameters:
      format - the format string - 格式字符串
      args - the arguments - 参数

    • trace

      void trace(String message, Throwable throwable)
      Logs a message at TRACE level with an exception. 在 TRACE 级别记录带异常的消息。
      Parameters:
      message - the message - 消息
      throwable - the exception - 异常

    • trace

      void trace(Supplier<String> messageSupplier)
      Logs a message at TRACE level using lazy evaluation. 使用延迟求值在 TRACE 级别记录消息。
      Parameters:
      messageSupplier - the message supplier - 消息提供者

    • trace

      void trace(Marker marker, String message)
      Logs a message at TRACE level with a marker. 使用标记在 TRACE 级别记录消息。
      Parameters:
      marker - the marker - 标记
      message - the message - 消息

    • trace

      void trace(Marker marker, String format, Object... args)
      Logs a message at TRACE level with a marker and parameters. 使用标记和参数在 TRACE 级别记录消息。
      Parameters:
      marker - the marker - 标记
      format - the format string - 格式字符串
      args - the arguments - 参数

    • isDebugEnabled

      boolean isDebugEnabled()
      Checks if DEBUG level is enabled. 检查 DEBUG 级别是否启用。
      Returns:
      true if enabled - 如果启用返回 true

    • isDebugEnabled

      boolean isDebugEnabled(Marker marker)
      Checks if DEBUG level is enabled for the specified marker. 检查指定标记的 DEBUG 级别是否启用。
      Parameters:
      marker - the marker - 标记
      Returns:
      true if enabled - 如果启用返回 true

    • debug

      void debug(String message)
      Logs a message at DEBUG level. 在 DEBUG 级别记录消息。
      Parameters:
      message - the message - 消息

    • debug

      void debug(String format, Object... args)
      Logs a message at DEBUG level with parameters. 在 DEBUG 级别记录带参数的消息。
      Parameters:
      format - the format string - 格式字符串
      args - the arguments - 参数

    • debug

      void debug(String message, Throwable throwable)
      Logs a message at DEBUG level with an exception. 在 DEBUG 级别记录带异常的消息。
      Parameters:
      message - the message - 消息
      throwable - the exception - 异常

    • debug

      void debug(Supplier<String> messageSupplier)
      Logs a message at DEBUG level using lazy evaluation. 使用延迟求值在 DEBUG 级别记录消息。
      Parameters:
      messageSupplier - the message supplier - 消息提供者

    • debug

      void debug(Marker marker, String message)
      Logs a message at DEBUG level with a marker. 使用标记在 DEBUG 级别记录消息。
      Parameters:
      marker - the marker - 标记
      message - the message - 消息

    • debug

      void debug(Marker marker, String format, Object... args)
      Logs a message at DEBUG level with a marker and parameters. 使用标记和参数在 DEBUG 级别记录消息。
      Parameters:
      marker - the marker - 标记
      format - the format string - 格式字符串
      args - the arguments - 参数

    • isInfoEnabled

      boolean isInfoEnabled()
      Checks if INFO level is enabled. 检查 INFO 级别是否启用。
      Returns:
      true if enabled - 如果启用返回 true

    • isInfoEnabled

      boolean isInfoEnabled(Marker marker)
      Checks if INFO level is enabled for the specified marker. 检查指定标记的 INFO 级别是否启用。
      Parameters:
      marker - the marker - 标记
      Returns:
      true if enabled - 如果启用返回 true

    • info

      void info(String message)
      Logs a message at INFO level. 在 INFO 级别记录消息。
      Parameters:
      message - the message - 消息

    • info

      void info(String format, Object... args)
      Logs a message at INFO level with parameters. 在 INFO 级别记录带参数的消息。
      Parameters:
      format - the format string - 格式字符串
      args - the arguments - 参数

    • info

      void info(String message, Throwable throwable)
      Logs a message at INFO level with an exception. 在 INFO 级别记录带异常的消息。
      Parameters:
      message - the message - 消息
      throwable - the exception - 异常

    • info

      void info(Supplier<String> messageSupplier)
      Logs a message at INFO level using lazy evaluation. 使用延迟求值在 INFO 级别记录消息。
      Parameters:
      messageSupplier - the message supplier - 消息提供者

    • info

      void info(Marker marker, String message)
      Logs a message at INFO level with a marker. 使用标记在 INFO 级别记录消息。
      Parameters:
      marker - the marker - 标记
      message - the message - 消息

    • info

      void info(Marker marker, String format, Object... args)
      Logs a message at INFO level with a marker and parameters. 使用标记和参数在 INFO 级别记录消息。
      Parameters:
      marker - the marker - 标记
      format - the format string - 格式字符串
      args - the arguments - 参数

    • isWarnEnabled

      boolean isWarnEnabled()
      Checks if WARN level is enabled. 检查 WARN 级别是否启用。
      Returns:
      true if enabled - 如果启用返回 true

    • isWarnEnabled

      boolean isWarnEnabled(Marker marker)
      Checks if WARN level is enabled for the specified marker. 检查指定标记的 WARN 级别是否启用。
      Parameters:
      marker - the marker - 标记
      Returns:
      true if enabled - 如果启用返回 true

    • warn

      void warn(String message)
      Logs a message at WARN level. 在 WARN 级别记录消息。
      Parameters:
      message - the message - 消息

    • warn

      void warn(String format, Object... args)
      Logs a message at WARN level with parameters. 在 WARN 级别记录带参数的消息。
      Parameters:
      format - the format string - 格式字符串
      args - the arguments - 参数

    • warn

      void warn(String message, Throwable throwable)
      Logs a message at WARN level with an exception. 在 WARN 级别记录带异常的消息。
      Parameters:
      message - the message - 消息
      throwable - the exception - 异常

    • warn

      void warn(Supplier<String> messageSupplier)
      Logs a message at WARN level using lazy evaluation. 使用延迟求值在 WARN 级别记录消息。
      Parameters:
      messageSupplier - the message supplier - 消息提供者

    • warn

      void warn(Marker marker, String message)
      Logs a message at WARN level with a marker. 使用标记在 WARN 级别记录消息。
      Parameters:
      marker - the marker - 标记
      message - the message - 消息

    • warn

      void warn(Marker marker, String format, Object... args)
      Logs a message at WARN level with a marker and parameters. 使用标记和参数在 WARN 级别记录消息。
      Parameters:
      marker - the marker - 标记
      format - the format string - 格式字符串
      args - the arguments - 参数

    • warn

      void warn(Marker marker, String message, Throwable throwable)
      Logs a message at WARN level with a marker and exception. 使用标记和异常在 WARN 级别记录消息。
      Parameters:
      marker - the marker - 标记
      message - the message - 消息
      throwable - the exception - 异常

    • isErrorEnabled

      boolean isErrorEnabled()
      Checks if ERROR level is enabled. 检查 ERROR 级别是否启用。
      Returns:
      true if enabled - 如果启用返回 true

    • isErrorEnabled

      boolean isErrorEnabled(Marker marker)
      Checks if ERROR level is enabled for the specified marker. 检查指定标记的 ERROR 级别是否启用。
      Parameters:
      marker - the marker - 标记
      Returns:
      true if enabled - 如果启用返回 true

    • error

      void error(String message)
      Logs a message at ERROR level. 在 ERROR 级别记录消息。
      Parameters:
      message - the message - 消息

    • error

      void error(String format, Object... args)
      Logs a message at ERROR level with parameters. 在 ERROR 级别记录带参数的消息。
      Parameters:
      format - the format string - 格式字符串
      args - the arguments - 参数

    • error

      void error(String message, Throwable throwable)
      Logs a message at ERROR level with an exception. 在 ERROR 级别记录带异常的消息。
      Parameters:
      message - the message - 消息
      throwable - the exception - 异常

    • error

      void error(Throwable throwable)
      Logs an exception at ERROR level. 在 ERROR 级别记录异常。
      Parameters:
      throwable - the exception - 异常

    • error

      void error(Supplier<String> messageSupplier)
      Logs a message at ERROR level using lazy evaluation. 使用延迟求值在 ERROR 级别记录消息。
      Parameters:
      messageSupplier - the message supplier - 消息提供者

    • error

      void error(Supplier<String> messageSupplier, Throwable throwable)
      Logs a message at ERROR level using lazy evaluation with exception. 使用延迟求值和异常在 ERROR 级别记录消息。
      Parameters:
      messageSupplier - the message supplier - 消息提供者
      throwable - the exception - 异常

    • error

      void error(Marker marker, String message)
      Logs a message at ERROR level with a marker. 使用标记在 ERROR 级别记录消息。
      Parameters:
      marker - the marker - 标记
      message - the message - 消息

    • error

      void error(Marker marker, String format, Object... args)
      Logs a message at ERROR level with a marker and parameters. 使用标记和参数在 ERROR 级别记录消息。
      Parameters:
      marker - the marker - 标记
      format - the format string - 格式字符串
      args - the arguments - 参数

    • error

      void error(Marker marker, String message, Throwable throwable)
      Logs a message at ERROR level with a marker and exception. 使用标记和异常在 ERROR 级别记录消息。
      Parameters:
      marker - the marker - 标记
      message - the message - 消息
      throwable - the exception - 异常

    • isEnabled

      boolean isEnabled(LogLevel level)
      Checks if the specified level is enabled. 检查指定级别是否启用。
      Parameters:
      level - the log level - 日志级别
      Returns:
      true if enabled - 如果启用返回 true

    • log

      void log(LogLevel level, String message)
      Logs a message at the specified level. 在指定级别记录消息。
      Parameters:
      level - the log level - 日志级别
      message - the message - 消息

    • log

      void log(LogLevel level, String format, Object... args)
      Logs a message at the specified level with parameters. 在指定级别记录带参数的消息。
      Parameters:
      level - the log level - 日志级别
      format - the format string - 格式字符串
      args - the arguments - 参数

    • log

      void log(LogLevel level, String message, Throwable throwable)
      Logs a message at the specified level with an exception. 在指定级别记录带异常的消息。
      Parameters:
      level - the log level - 日志级别
      message - the message - 消息
      throwable - the exception - 异常