Package wt.log4j

Interface Logger

public interface Logger
This is the central interface in the log4j package. Most logging operations are done through this interface.

The canonical way to obtain a Logger for a class is through LogManager.getLogger(). Typically, each class gets its own Logger named after its fully qualified class name (the default Logger name when obtained through the LogManager.getLogger() method). Thus, the simplest way to use this would be like so: 

 public class MyClass {
     private static final Logger LOGGER = LogManager.getLogger();
     // ...
 }


Supported API: true
Extendable: false

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    debug(Object message)
    Logs a message object with the DEBUG level.
    void
    debug(Object message, Throwable throwable)
    Logs a message at the DEBUG level including the stack trace of the Throwable throwable passed as parameter.
    void
    debug(String message)
    Logs a message object with the DEBUG level.
    void
    debug(String message, Object... params)
    Logs a message with parameters at the DEBUG level.
    void
    debug(String message, Throwable throwable)
    Logs a message at the DEBUG level including the stack trace of the Throwable throwable passed as parameter.
    void
    error(Object message)
    Logs a message object with the ERROR level.
    void
    error(Object message, Throwable throwable)
    Logs a message at the ERROR level including the stack trace of the Throwable throwable passed as parameter.
    void
    error(String message)
    Logs a message object with the ERROR level.
    void
    error(String message, Object... params)
    Logs a message with parameters at the ERROR level.
    void
    error(String message, Throwable throwable)
    Logs a message at the ERROR level including the stack trace of the Throwable throwable passed as parameter.
    void
    fatal(Object message)
    Logs a message object with the FATAL level.
    void
    fatal(Object message, Throwable throwable)
    Logs a message at the FATAL level including the stack trace of the Throwable throwable passed as parameter.
    void
    fatal(String message)
    Logs a message object with the FATAL level.
    void
    fatal(String message, Object... params)
    Logs a message with parameters at the FATAL level.
    void
    fatal(String message, Throwable throwable)
    Logs a message at the FATAL level including the stack trace of the Throwable throwable passed as parameter.
    void
    info(Object message)
    Logs a message object with the INFO level.
    void
    info(Object message, Throwable throwable)
    Logs a message at the INFO level including the stack trace of the Throwable throwable passed as parameter.
    void
    info(String message)
    Logs a message object with the INFO level.
    void
    info(String message, Object... params)
    Logs a message with parameters at the INFO level.
    void
    info(String message, Throwable throwable)
    Logs a message at the INFO level including the stack trace of the Throwable throwable passed as parameter.
    boolean
    isDebugEnabled()
    Checks whether this Logger is enabled for the DEBUG Level.
    boolean
    isErrorEnabled()
    Checks whether this Logger is enabled for the ERROR Level.
    boolean
    isFatalEnabled()
    Checks whether this Logger is enabled for the FATAL Level.
    boolean
    isInfoEnabled()
    Checks whether this Logger is enabled for the INFO Level.
    boolean
    isTraceEnabled()
    Checks whether this Logger is enabled for the TRACE level.
    boolean
    isWarnEnabled()
    Checks whether this Logger is enabled for the WARN Level.
    void
    trace(Object message)
    Logs a message object with the TRACE level.
    void
    trace(Object message, Throwable throwable)
    Logs a message at the TRACE level including the stack trace of the Throwable throwable passed as parameter.
    void
    trace(String message)
    Logs a message object with the TRACE level.
    void
    trace(String message, Object... params)
    Logs a message with parameters at the TRACE level.
    void
    trace(String message, Throwable throwable)
    Logs a message at the TRACE level including the stack trace of the Throwable throwable passed as parameter.
    void
    warn(Object message)
    Logs a message object with the WARN level.
    void
    warn(Object message, Throwable throwable)
    Logs a message at the WARN level including the stack trace of the Throwable throwable passed as parameter.
    void
    warn(String message)
    Logs a message object with the WARN level.
    void
    warn(String message, Object... params)
    Logs a message with parameters at the WARN level.
    void
    warn(String message, Throwable throwable)
    Logs a message at the WARN level including the stack trace of the Throwable throwable passed as parameter.

  • Method Details

    • isInfoEnabled

      boolean isInfoEnabled()
      Checks whether this Logger is enabled for the INFO Level.

      Supported API: true
      Extendable: false
      Returns:
      boolean - true if this Logger is enabled for level INFO, false otherwise.

    • info

      void info(Object message)
      Logs a message object with the INFO level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.

    • info

      void info(Object message, Throwable throwable)
      Logs a message at the INFO level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.

    • info

      void info(String message)
      Logs a message object with the INFO level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message string to log.

    • info

      void info(String message, Throwable throwable)
      Logs a message at the INFO level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.

    • info

      void info(String message, Object... params)
      Logs a message with parameters at the INFO level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
      • #getMessageFactory()

    • isDebugEnabled

      boolean isDebugEnabled()
      Checks whether this Logger is enabled for the DEBUG Level.

      Supported API: true
      Extendable: false
      Returns:
      boolean - true if this Logger is enabled for level DEBUG, false otherwise.

    • debug

      void debug(Object message)
      Logs a message object with the DEBUG level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.

    • debug

      void debug(Object message, Throwable throwable)
      Logs a message at the DEBUG level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message to log.
      throwable - the Throwable to log, including its stack trace.

    • debug

      void debug(String message)
      Logs a message object with the DEBUG level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message string to log.

    • debug

      void debug(String message, Throwable throwable)
      Logs a message at the DEBUG level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message to log.
      throwable - the Throwable to log, including its stack trace.

    • debug

      void debug(String message, Object... params)
      Logs a message with parameters at the DEBUG level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
      • #getMessageFactory()

    • isErrorEnabled

      boolean isErrorEnabled()
      Checks whether this Logger is enabled for the ERROR Level.

      Supported API: true
      Extendable: false
      Returns:
      boolean - true if this Logger is enabled for level ERROR, false otherwise.

    • error

      void error(Object message)
      Logs a message object with the ERROR level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.

    • error

      void error(Object message, Throwable throwable)
      Logs a message at the ERROR level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.

    • error

      void error(String message)
      Logs a message object with the ERROR level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message string to log.

    • error

      void error(String message, Throwable throwable)
      Logs a message at the ERROR level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.

    • error

      void error(String message, Object... params)
      Logs a message with parameters at the ERROR level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
      • #getMessageFactory()

    • isFatalEnabled

      boolean isFatalEnabled()
      Checks whether this Logger is enabled for the FATAL Level.

      Supported API: true
      Extendable: false
      Returns:
      boolean - true if this Logger is enabled for level FATAL, false otherwise.

    • fatal

      void fatal(Object message)
      Logs a message object with the FATAL level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.

    • fatal

      void fatal(Object message, Throwable throwable)
      Logs a message at the FATAL level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.

    • fatal

      void fatal(String message)
      Logs a message object with the FATAL level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message string to log.

    • fatal

      void fatal(String message, Throwable throwable)
      Logs a message at the FATAL level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.

    • fatal

      void fatal(String message, Object... params)
      Logs a message with parameters at the FATAL level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
      • #getMessageFactory()

    • isTraceEnabled

      boolean isTraceEnabled()
      Checks whether this Logger is enabled for the TRACE level.

      Supported API: true
      Extendable: false
      Returns:
      boolean - true if this Logger is enabled for level TRACE, false otherwise.

    • trace

      void trace(Object message)
      Logs a message object with the TRACE level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.

    • trace

      void trace(Object message, Throwable throwable)
      Logs a message at the TRACE level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
      See Also:

    • trace

      void trace(String message)
      Logs a message object with the TRACE level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message string to log.

    • trace

      void trace(String message, Throwable throwable)
      Logs a message at the TRACE level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
      See Also:

    • trace

      void trace(String message, Object... params)
      Logs a message with parameters at the TRACE level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
      • #getMessageFactory()

    • isWarnEnabled

      boolean isWarnEnabled()
      Checks whether this Logger is enabled for the WARN Level.

      Supported API: true
      Extendable: false
      Returns:
      boolean - true if this Logger is enabled for level WARN, false otherwise.

    • warn

      void warn(Object message)
      Logs a message object with the WARN level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.

    • warn

      void warn(Object message, Throwable throwable)
      Logs a message at the WARN level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.

    • warn

      void warn(String message)
      Logs a message object with the WARN level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message string to log.

    • warn

      void warn(String message, Throwable throwable)
      Logs a message at the WARN level including the stack trace of the Throwable throwable passed as parameter.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.

    • warn

      void warn(String message, Object... params)
      Logs a message with parameters at the WARN level.

      Supported API: true
      Extendable: false
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
      • #getMessageFactory()