Interface Logger

All Known Subinterfaces:
ExtendedLogger
All Known Implementing Classes:
AbstractLogger, ExtendedLoggerWrapper, SimpleLogger, StatusLogger

public interface Logger
This is the central interface in the log4j package. Most logging operations, except configuration, 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();
     // ...
 }
 

For ease of filtering, searching, sorting, etc., it is generally a good idea to create Loggers for each class rather than sharing Loggers. Instead, Markers should be used for shared, filterable identification.

For service provider implementations, it is recommended to extend the AbstractLogger class rather than implementing this interface directly.

Since 2.4, methods have been added to the Logger interface to support lambda expressions. The new methods allow client code to lazily log messages without explicitly checking if the requested log level is enabled. For example, previously one would write:
 // pre-Java 8 style optimization: explicitly check the log level
 // to make sure the expensiveOperation() method is only called if necessary
 if (logger.isTraceEnabled()) {
     logger.trace("Some long-running operation returned {}", expensiveOperation());
 }
 

With Java 8, the same effect can be achieved with a lambda expression:

 // Java-8 style optimization: no need to explicitly check the log level:
 // the lambda expression is not evaluated if the TRACE level is not enabled
 logger.trace("Some long-running operation returned {}", () -> expensiveOperation());
 

Note that although MessageSupplier is provided, using Supplier<Message> works just the same. MessageSupplier was deprecated in 2.6 and un-deprecated in 2.8.1. Anonymous class usage of these APIs should prefer using Supplier instead.

  • Method Details

    • catching

      void catching(Level level, Throwable throwable)
      Logs a Throwable that has been caught to a specific logging level.
      Parameters:
      level - The logging Level.
      throwable - the Throwable.
    • catching

      void catching(Throwable throwable)
      Logs a Throwable that has been caught at the ERROR level. Normally, one may wish to provide additional information with an exception while logging it; in these cases, one would not use this method. In other cases where simply logging the fact that an exception was swallowed somewhere (e.g., at the top of the stack trace in a main() method), this method is ideal for it.
      Parameters:
      throwable - the Throwable.
    • debug

      void debug(Marker marker, Message message)
      Logs a message with the specific Marker at the DEBUG level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
    • debug

      void debug(Marker marker, Message message, Throwable throwable)
      Logs a message with the specific Marker at the DEBUG level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
      throwable - A Throwable or null.
    • debug

      void debug(Marker marker, MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the DEBUG level with the specified Marker. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • debug

      void debug(Marker marker, MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the DEBUG level) with the specified Marker and including the stack trace of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - A Throwable or null.
      Since:
      2.4
    • debug

      void debug(Marker marker, CharSequence message)
      Logs a message CharSequence with the DEBUG level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message CharSequence to log.
    • debug

      void debug(Marker marker, CharSequence message, Throwable throwable)
      Logs a message CharSequence at the DEBUG level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • debug

      void debug(Marker marker, Object message)
      Logs a message object with the DEBUG level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
    • debug

      void debug(Marker marker, Object message, Throwable throwable)
      Logs a message at the DEBUG level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log.
      throwable - the Throwable to log, including its stack trace.
    • debug

      void debug(Marker marker, String message)
      Logs a message object with the DEBUG level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
    • debug

      void debug(Marker marker, String message, Object... params)
      Logs a message with parameters at the DEBUG level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • debug

      void debug(Marker marker, String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the DEBUG level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • debug

      void debug(Marker marker, String message, Throwable throwable)
      Logs a message at the DEBUG level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log.
      throwable - the Throwable to log, including its stack trace.
    • debug

      void debug(Marker marker, Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the DEBUG level with the specified Marker.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • debug

      void debug(Marker marker, Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the DEBUG level) with the specified Marker and including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - A Throwable or null.
      Since:
      2.4
    • debug

      void debug(Message message)
      Logs a message with the specific Marker at the DEBUG level.
      Parameters:
      message - the message string to be logged
    • debug

      void debug(Message message, Throwable throwable)
      Logs a message with the specific Marker at the DEBUG level.
      Parameters:
      message - the message string to be logged
      throwable - A Throwable or null.
    • debug

      void debug(MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the DEBUG level. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • debug

      void debug(MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the DEBUG level) including the stack trace of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - the Throwable to log, including its stack trace.
      Since:
      2.4
    • debug

      void debug(CharSequence message)
      Logs a message CharSequence with the DEBUG level.
      Parameters:
      message - the message object to log.
    • debug

      void debug(CharSequence message, Throwable throwable)
      Logs a CharSequence at the DEBUG level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • debug

      void debug(Object message)
      Logs a message object with the DEBUG level.
      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.
      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.
      Parameters:
      message - the message string to log.
    • debug

      void debug(String message, Object... params)
      Logs a message with parameters at the DEBUG level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • debug

      void debug(String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the DEBUG level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • 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.
      Parameters:
      message - the message to log.
      throwable - the Throwable to log, including its stack trace.
    • debug

      void debug(Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the DEBUG level.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • debug

      void debug(Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the DEBUG level) including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - the Throwable to log, including its stack trace.
      Since:
      2.4
    • debug

      void debug(Marker marker, String message, Object p0)
      Logs a message with parameters at debug level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • debug

      void debug(Marker marker, String message, Object p0, Object p1)
      Logs a message with parameters at debug level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • debug

      void debug(Marker marker, String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at debug level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • debug

      void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at debug level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • debug

      void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at debug level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • debug

      void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at debug level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • debug

      void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at debug level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • debug

      void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at debug level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • debug

      void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at debug level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • debug

      void debug(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at debug level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • debug

      void debug(String message, Object p0)
      Logs a message with parameters at debug level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • debug

      void debug(String message, Object p0, Object p1)
      Logs a message with parameters at debug level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • debug

      void debug(String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at debug level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • debug

      void debug(String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at debug level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • debug

      void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at debug level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • debug

      void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at debug level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • debug

      void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at debug level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • debug

      void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at debug level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • debug

      void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at debug level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • debug

      void debug(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at debug level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • entry

      @Deprecated void entry()
      Deprecated.
      Use traceEntry() instead which performs the same function.
      Logs entry to a method. Used when the method in question has no parameters or when the parameters should not be logged.
    • entry

      @Deprecated void entry(Object... params)
      Deprecated.
      Use traceEntry(String, Object...) instead which performs the same function.
      Logs entry to a method along with its parameters (consider using one of the traceEntry(...) methods instead.)

      For example:

       public void doSomething(String foo, int bar) {
           LOGGER.entry(foo, bar);
           // do something
       }
       

      The use of methods such as this are more effective when combined with aspect-oriented programming or other bytecode manipulation tools. It can be rather tedious (and messy) to use this type of method manually.

      Parameters:
      params - The parameters to the method.
    • error

      void error(Marker marker, Message message)
      Logs a message with the specific Marker at the ERROR level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
    • error

      void error(Marker marker, Message message, Throwable throwable)
      Logs a message with the specific Marker at the ERROR level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
      throwable - A Throwable or null.
    • error

      void error(Marker marker, MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the ERROR level with the specified Marker. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • error

      void error(Marker marker, MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the ERROR level) with the specified Marker and including the stack trace of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - A Throwable or null.
      Since:
      2.4
    • error

      void error(Marker marker, CharSequence message)
      Logs a message CharSequence with the ERROR level.
      Parameters:
      marker - the marker data specific to this log statement.
      message - the message CharSequence to log.
    • error

      void error(Marker marker, CharSequence message, Throwable throwable)
      Logs a CharSequence at the ERROR level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement.
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • error

      void error(Marker marker, Object message)
      Logs a message object with the ERROR level.
      Parameters:
      marker - the marker data specific to this log statement.
      message - the message object to log.
    • error

      void error(Marker marker, Object message, Throwable throwable)
      Logs a message at the ERROR level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement.
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • error

      void error(Marker marker, String message)
      Logs a message object with the ERROR level.
      Parameters:
      marker - the marker data specific to this log statement.
      message - the message object to log.
    • error

      void error(Marker marker, String message, Object... params)
      Logs a message with parameters at the ERROR level.
      Parameters:
      marker - the marker data specific to this log statement.
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • error

      void error(Marker marker, String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the ERROR level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • error

      void error(Marker marker, String message, Throwable throwable)
      Logs a message at the ERROR level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement.
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • error

      void error(Marker marker, Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the ERROR level with the specified Marker.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • error

      void error(Marker marker, Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the ERROR level) with the specified Marker and including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - A Throwable or null.
      Since:
      2.4
    • error

      void error(Message message)
      Logs a message with the specific Marker at the ERROR level.
      Parameters:
      message - the message string to be logged
    • error

      void error(Message message, Throwable throwable)
      Logs a message with the specific Marker at the ERROR level.
      Parameters:
      message - the message string to be logged
      throwable - A Throwable or null.
    • error

      void error(MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the ERROR level. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • error

      void error(MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the ERROR level) including the stack trace of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - the Throwable to log, including its stack trace.
      Since:
      2.4
    • error

      void error(CharSequence message)
      Logs a message CharSequence with the ERROR level.
      Parameters:
      message - the message CharSequence to log.
    • error

      void error(CharSequence message, Throwable throwable)
      Logs a CharSequence at the ERROR level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • error

      void error(Object message)
      Logs a message object with the ERROR level.
      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.
      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.
      Parameters:
      message - the message string to log.
    • error

      void error(String message, Object... params)
      Logs a message with parameters at the ERROR level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • error

      void error(String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the ERROR level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • 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.
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • error

      void error(Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the ERROR level.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • error

      void error(Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the ERROR level) including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - the Throwable to log, including its stack trace.
      Since:
      2.4
    • error

      void error(Marker marker, String message, Object p0)
      Logs a message with parameters at error level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • error

      void error(Marker marker, String message, Object p0, Object p1)
      Logs a message with parameters at error level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • error

      void error(Marker marker, String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at error level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • error

      void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at error level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • error

      void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at error level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • error

      void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at error level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • error

      void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at error level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • error

      void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at error level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • error

      void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at error level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • error

      void error(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at error level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • error

      void error(String message, Object p0)
      Logs a message with parameters at error level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • error

      void error(String message, Object p0, Object p1)
      Logs a message with parameters at error level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • error

      void error(String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at error level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • error

      void error(String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at error level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • error

      void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at error level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • error

      void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at error level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • error

      void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at error level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • error

      void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at error level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • error

      void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at error level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • error

      void error(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at error level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • exit

      @Deprecated void exit()
      Deprecated.
      Use traceExit() instead which performs the same function.
      Logs exit from a method. Used for methods that do not return anything.
    • exit

      @Deprecated <R> R exit(R result)
      Deprecated.
      Use traceExit(Object) instead which performs the same function.
      Logs exiting from a method with the result. This may be coded as:
       return LOGGER.exit(myResult);
       
      Type Parameters:
      R - The type of the parameter and object being returned.
      Parameters:
      result - The result being returned from the method call.
      Returns:
      the result.
    • fatal

      void fatal(Marker marker, Message message)
      Logs a message with the specific Marker at the FATAL level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
    • fatal

      void fatal(Marker marker, Message message, Throwable throwable)
      Logs a message with the specific Marker at the FATAL level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
      throwable - A Throwable or null.
    • fatal

      void fatal(Marker marker, MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the FATAL level with the specified Marker. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • fatal

      void fatal(Marker marker, MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the FATAL level) with the specified Marker and including the stack trace of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - A Throwable or null.
      Since:
      2.4
    • fatal

      void fatal(Marker marker, CharSequence message)
      Logs a message CharSequence with the FATAL level.
      Parameters:
      marker - The marker data specific to this log statement.
      message - the message CharSequence to log.
    • fatal

      void fatal(Marker marker, CharSequence message, Throwable throwable)
      Logs a CharSequence at the FATAL level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - The marker data specific to this log statement.
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • fatal

      void fatal(Marker marker, Object message)
      Logs a message object with the FATAL level.
      Parameters:
      marker - The marker data specific to this log statement.
      message - the message object to log.
    • fatal

      void fatal(Marker marker, Object message, Throwable throwable)
      Logs a message at the FATAL level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - The marker data specific to this log statement.
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • fatal

      void fatal(Marker marker, String message)
      Logs a message object with the FATAL level.
      Parameters:
      marker - The marker data specific to this log statement.
      message - the message object to log.
    • fatal

      void fatal(Marker marker, String message, Object... params)
      Logs a message with parameters at the FATAL level.
      Parameters:
      marker - The marker data specific to this log statement.
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • fatal

      void fatal(Marker marker, String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the FATAL level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • fatal

      void fatal(Marker marker, String message, Throwable throwable)
      Logs a message at the FATAL level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - The marker data specific to this log statement.
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • fatal

      void fatal(Marker marker, Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the FATAL level with the specified Marker.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • fatal

      void fatal(Marker marker, Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the FATAL level) with the specified Marker and including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - A Throwable or null.
      Since:
      2.4
    • fatal

      void fatal(Message message)
      Logs a message with the specific Marker at the FATAL level.
      Parameters:
      message - the message string to be logged
    • fatal

      void fatal(Message message, Throwable throwable)
      Logs a message with the specific Marker at the FATAL level.
      Parameters:
      message - the message string to be logged
      throwable - A Throwable or null.
    • fatal

      void fatal(MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the FATAL level. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • fatal

      void fatal(MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the FATAL level) including the stack trace of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - the Throwable to log, including its stack trace.
      Since:
      2.4
    • fatal

      void fatal(CharSequence message)
      Logs a message CharSequence with the FATAL level.
      Parameters:
      message - the message CharSequence to log.
    • fatal

      void fatal(CharSequence message, Throwable throwable)
      Logs a CharSequence at the FATAL level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • fatal

      void fatal(Object message)
      Logs a message object with the FATAL level.
      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.
      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.
      Parameters:
      message - the message string to log.
    • fatal

      void fatal(String message, Object... params)
      Logs a message with parameters at the FATAL level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • fatal

      void fatal(String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the FATAL level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • 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.
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • fatal

      void fatal(Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the FATAL level.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • fatal

      void fatal(Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the FATAL level) including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - the Throwable to log, including its stack trace.
      Since:
      2.4
    • fatal

      void fatal(Marker marker, String message, Object p0)
      Logs a message with parameters at fatal level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • fatal

      void fatal(Marker marker, String message, Object p0, Object p1)
      Logs a message with parameters at fatal level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • fatal

      void fatal(Marker marker, String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at fatal level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • fatal

      void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at fatal level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • fatal

      void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at fatal level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • fatal

      void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at fatal level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • fatal

      void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at fatal level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • fatal

      void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at fatal level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • fatal

      void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at fatal level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • fatal

      void fatal(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at fatal level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • fatal

      void fatal(String message, Object p0)
      Logs a message with parameters at fatal level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • fatal

      void fatal(String message, Object p0, Object p1)
      Logs a message with parameters at fatal level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • fatal

      void fatal(String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at fatal level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • fatal

      void fatal(String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at fatal level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • fatal

      void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at fatal level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • fatal

      void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at fatal level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • fatal

      void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at fatal level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • fatal

      void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at fatal level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • fatal

      void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at fatal level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • fatal

      void fatal(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at fatal level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • getLevel

      Level getLevel()
      Gets the Level associated with the Logger.
      Returns:
      the Level associate with the Logger.
    • getMessageFactory

      <MF extends MessageFactory> MF getMessageFactory()
      Gets the message factory used to convert message Objects and Strings/CharSequences into actual log Messages.

      Since version 2.6, Log4j internally uses message factories that implement the MessageFactory2 interface. From version 2.6.2, the return type of this method was changed from MessageFactory to <MF extends MessageFactory> MF. The returned factory will always implement MessageFactory2, but the return type of this method could not be changed to MessageFactory2 without breaking binary compatibility.

      Returns:
      the message factory, as an instance of MessageFactory2
    • getFlowMessageFactory

      FlowMessageFactory getFlowMessageFactory()
      Gets the flow message factory used to convert messages into flow messages.
      Returns:
      the flow message factory, as an instance of FlowMessageFactory.
      Since:
      2.20
    • getName

      String getName()
      Gets the logger name.
      Returns:
      the logger name.
    • info

      void info(Marker marker, Message message)
      Logs a message with the specific Marker at the INFO level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
    • info

      void info(Marker marker, Message message, Throwable throwable)
      Logs a message with the specific Marker at the INFO level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
      throwable - A Throwable or null.
    • info

      void info(Marker marker, MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the INFO level with the specified Marker. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • info

      void info(Marker marker, MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the INFO level) with the specified Marker and including the stack trace of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - A Throwable or null.
      Since:
      2.4
    • info

      void info(Marker marker, CharSequence message)
      Logs a message CharSequence with the INFO level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message CharSequence to log.
    • info

      void info(Marker marker, CharSequence message, Throwable throwable)
      Logs a CharSequence at the INFO level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • info

      void info(Marker marker, Object message)
      Logs a message object with the INFO level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
    • info

      void info(Marker marker, Object message, Throwable throwable)
      Logs a message at the INFO level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • info

      void info(Marker marker, String message)
      Logs a message object with the INFO level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
    • info

      void info(Marker marker, String message, Object... params)
      Logs a message with parameters at the INFO level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • info

      void info(Marker marker, String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the INFO level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • info

      void info(Marker marker, String message, Throwable throwable)
      Logs a message at the INFO level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • info

      void info(Marker marker, Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the INFO level with the specified Marker.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • info

      void info(Marker marker, Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the INFO level) with the specified Marker and including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - A Throwable or null.
      Since:
      2.4
    • info

      void info(Message message)
      Logs a message with the specific Marker at the INFO level.
      Parameters:
      message - the message string to be logged
    • info

      void info(Message message, Throwable throwable)
      Logs a message with the specific Marker at the INFO level.
      Parameters:
      message - the message string to be logged
      throwable - A Throwable or null.
    • info

      void info(MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the INFO level. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • info

      void info(MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the INFO level) including the stack trace of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - the Throwable to log, including its stack trace.
      Since:
      2.4
    • info

      void info(CharSequence message)
      Logs a message CharSequence with the INFO level.
      Parameters:
      message - the message CharSequence to log.
    • info

      void info(CharSequence message, Throwable throwable)
      Logs a CharSequence at the INFO level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • info

      void info(Object message)
      Logs a message object with the INFO level.
      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.
      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.
      Parameters:
      message - the message string to log.
    • info

      void info(String message, Object... params)
      Logs a message with parameters at the INFO level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • info

      void info(String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the INFO level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • 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.
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • info

      void info(Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the INFO level.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • info

      void info(Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the INFO level) including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - the Throwable to log, including its stack trace.
      Since:
      2.4
    • info

      void info(Marker marker, String message, Object p0)
      Logs a message with parameters at info level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • info

      void info(Marker marker, String message, Object p0, Object p1)
      Logs a message with parameters at info level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • info

      void info(Marker marker, String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at info level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • info

      void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at info level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • info

      void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at info level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • info

      void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at info level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • info

      void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at info level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • info

      void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at info level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • info

      void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at info level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • info

      void info(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at info level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • info

      void info(String message, Object p0)
      Logs a message with parameters at info level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • info

      void info(String message, Object p0, Object p1)
      Logs a message with parameters at info level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • info

      void info(String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at info level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • info

      void info(String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at info level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • info

      void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at info level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • info

      void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at info level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • info

      void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at info level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • info

      void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at info level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • info

      void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at info level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • info

      void info(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at info level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • isDebugEnabled

      boolean isDebugEnabled()
      Checks whether this Logger is enabled for the DEBUG Level.
      Returns:
      boolean - true if this Logger is enabled for level DEBUG, false otherwise.
    • isDebugEnabled

      boolean isDebugEnabled(Marker marker)
      Checks whether this Logger is enabled for the DEBUG Level.
      Parameters:
      marker - The Marker to check
      Returns:
      boolean - true if this Logger is enabled for level DEBUG, false otherwise.
    • isEnabled

      boolean isEnabled(Level level)
      Checks whether this Logger is enabled for the given Level.

      Note that passing in OFF always returns true.

      Parameters:
      level - the Level to check
      Returns:
      boolean - true if this Logger is enabled for level, false otherwise.
    • isEnabled

      boolean isEnabled(Level level, Marker marker)
      Checks whether this Logger is enabled for the given Level and Marker.
      Parameters:
      level - The Level to check
      marker - The Marker to check
      Returns:
      boolean - true if this Logger is enabled for level and marker, false otherwise.
    • isErrorEnabled

      boolean isErrorEnabled()
      Checks whether this Logger is enabled for the ERROR Level.
      Returns:
      boolean - true if this Logger is enabled for level ERROR, false otherwise.
    • isErrorEnabled

      boolean isErrorEnabled(Marker marker)
      Checks whether this Logger is enabled for the ERROR Level.
      Parameters:
      marker - The Marker to check
      Returns:
      boolean - true if this Logger is enabled for level ERROR, false otherwise.
    • isFatalEnabled

      boolean isFatalEnabled()
      Checks whether this Logger is enabled for the FATAL Level.
      Returns:
      boolean - true if this Logger is enabled for level FATAL, false otherwise.
    • isFatalEnabled

      boolean isFatalEnabled(Marker marker)
      Checks whether this Logger is enabled for the FATAL Level.
      Parameters:
      marker - The Marker to check
      Returns:
      boolean - true if this Logger is enabled for level FATAL, false otherwise.
    • isInfoEnabled

      boolean isInfoEnabled()
      Checks whether this Logger is enabled for the INFO Level.
      Returns:
      boolean - true if this Logger is enabled for level INFO, false otherwise.
    • isInfoEnabled

      boolean isInfoEnabled(Marker marker)
      Checks whether this Logger is enabled for the INFO Level.
      Parameters:
      marker - The Marker to check
      Returns:
      boolean - true if this Logger is enabled for level INFO, false otherwise.
    • isTraceEnabled

      boolean isTraceEnabled()
      Checks whether this Logger is enabled for the TRACE level.
      Returns:
      boolean - true if this Logger is enabled for level TRACE, false otherwise.
    • isTraceEnabled

      boolean isTraceEnabled(Marker marker)
      Checks whether this Logger is enabled for the TRACE level.
      Parameters:
      marker - The Marker to check
      Returns:
      boolean - true if this Logger is enabled for level TRACE, false otherwise.
    • isWarnEnabled

      boolean isWarnEnabled()
      Checks whether this Logger is enabled for the WARN Level.
      Returns:
      boolean - true if this Logger is enabled for level WARN, false otherwise.
    • isWarnEnabled

      boolean isWarnEnabled(Marker marker)
      Checks whether this Logger is enabled for the WARN Level.
      Parameters:
      marker - The Marker to check
      Returns:
      boolean - true if this Logger is enabled for level WARN, false otherwise.
    • log

      void log(Level level, Marker marker, Message message)
      Logs a message with the specific Marker at the given level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message string to be logged
    • log

      void log(Level level, Marker marker, Message message, Throwable throwable)
      Logs a message with the specific Marker at the given level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message string to be logged
      throwable - A Throwable or null.
    • log

      void log(Level level, Marker marker, MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the specified level with the specified Marker. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • log

      void log(Level level, Marker marker, MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the specified level) with the specified Marker and including the stack log of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - A Throwable or null.
      Since:
      2.4
    • log

      void log(Level level, Marker marker, CharSequence message)
      Logs a message CharSequence with the given level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message CharSequence to log.
    • log

      void log(Level level, Marker marker, CharSequence message, Throwable throwable)
      Logs a CharSequence at the given level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • log

      void log(Level level, Marker marker, Object message)
      Logs a message object with the given level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message object to log.
    • log

      void log(Level level, Marker marker, Object message, Throwable throwable)
      Logs a message at the given level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log.
      throwable - the Throwable to log, including its stack trace.
    • log

      void log(Level level, Marker marker, String message)
      Logs a message object with the given level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message object to log.
    • log

      void log(Level level, Marker marker, String message, Object... params)
      Logs a message with parameters at the given level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • log

      void log(Level level, Marker marker, String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the specified level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • log

      void log(Level level, Marker marker, String message, Throwable throwable)
      Logs a message at the given level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log.
      throwable - the Throwable to log, including its stack trace.
    • log

      void log(Level level, Marker marker, Supplier<?> messageSupplier)
      Logs a message (only to be constructed if the logging level is the specified level) with the specified Marker.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • log

      void log(Level level, Marker marker, Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the specified level) with the specified Marker and including the stack log of the Throwable throwable passed as parameter.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - A Throwable or null.
      Since:
      2.4
    • log

      void log(Level level, Message message)
      Logs a message with the specific Marker at the given level.
      Parameters:
      level - the logging level
      message - the message string to be logged
    • log

      void log(Level level, Message message, Throwable throwable)
      Logs a message with the specific Marker at the given level.
      Parameters:
      level - the logging level
      message - the message string to be logged
      throwable - A Throwable or null.
    • log

      void log(Level level, MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the specified level. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      level - the logging level
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • log

      void log(Level level, MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the specified level) including the stack log of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      level - the logging level
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - the Throwable to log, including its stack log.
      Since:
      2.4
    • log

      void log(Level level, CharSequence message)
      Logs a message CharSequence with the given level.
      Parameters:
      level - the logging level
      message - the message CharSequence to log.
    • log

      void log(Level level, CharSequence message, Throwable throwable)
      Logs a CharSequence at the given level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      level - the logging level
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • log

      void log(Level level, Object message)
      Logs a message object with the given level.
      Parameters:
      level - the logging level
      message - the message object to log.
    • log

      void log(Level level, Object message, Throwable throwable)
      Logs a message at the given level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      level - the logging level
      message - the message to log.
      throwable - the Throwable to log, including its stack trace.
    • log

      void log(Level level, String message)
      Logs a message object with the given level.
      Parameters:
      level - the logging level
      message - the message string to log.
    • log

      void log(Level level, String message, Object... params)
      Logs a message with parameters at the given level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • log

      void log(Level level, String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the specified level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • log

      void log(Level level, String message, Throwable throwable)
      Logs a message at the given level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      level - the logging level
      message - the message to log.
      throwable - the Throwable to log, including its stack trace.
    • log

      void log(Level level, Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the specified level.
      Parameters:
      level - the logging level
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • log

      void log(Level level, Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the specified level) including the stack log of the Throwable throwable passed as parameter.
      Parameters:
      level - the logging level
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - the Throwable to log, including its stack log.
      Since:
      2.4
    • log

      void log(Level level, Marker marker, String message, Object p0)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • log

      void log(Level level, Marker marker, String message, Object p0, Object p1)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • log

      void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • log

      void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • log

      void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • log

      void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • log

      void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • log

      void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • log

      void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • log

      void log(Level level, Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • log

      void log(Level level, String message, Object p0)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • log

      void log(Level level, String message, Object p0, Object p1)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • log

      void log(Level level, String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • log

      void log(Level level, String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • log

      void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • log

      void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • log

      void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • log

      void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • log

      void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • log

      void log(Level level, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at the specified level.
      Parameters:
      level - the logging level
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • printf

      void printf(Level level, Marker marker, String format, Object... params)
      Logs a formatted message using the specified format string and arguments.
      Parameters:
      level - The logging Level.
      marker - the marker data specific to this log statement.
      format - The format String.
      params - Arguments specified by the format.
    • printf

      void printf(Level level, String format, Object... params)
      Logs a formatted message using the specified format string and arguments.
      Parameters:
      level - The logging Level.
      format - The format String.
      params - Arguments specified by the format.
    • throwing

      <T extends Throwable> T throwing(Level level, T throwable)
      Logs a Throwable to be thrown. This may be coded as:
       throw logger.throwing(Level.DEBUG, myException);
       
      Type Parameters:
      T - the Throwable type.
      Parameters:
      level - The logging Level.
      throwable - The Throwable.
      Returns:
      the Throwable.
    • throwing

      <T extends Throwable> T throwing(T throwable)
      Logs a Throwable to be thrown at the ERROR level. This may be coded as:
       throw logger.throwing(myException);
       
      Type Parameters:
      T - the Throwable type.
      Parameters:
      throwable - The Throwable.
      Returns:
      the Throwable.
    • trace

      void trace(Marker marker, Message message)
      Logs a message with the specific Marker at the TRACE level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
    • trace

      void trace(Marker marker, Message message, Throwable throwable)
      Logs a message with the specific Marker at the TRACE level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
      throwable - A Throwable or null.
    • trace

      void trace(Marker marker, MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the TRACE level with the specified Marker. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • trace

      void trace(Marker marker, MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the TRACE level) with the specified Marker and including the stack trace of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - A Throwable or null.
      Since:
      2.4
    • trace

      void trace(Marker marker, CharSequence message)
      Logs a message CharSequence with the TRACE level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message CharSequence to log.
    • trace

      void trace(Marker marker, CharSequence message, Throwable throwable)
      Logs a CharSequence at the TRACE level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
      See Also:
    • trace

      void trace(Marker marker, Object message)
      Logs a message object with the TRACE level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
    • trace

      void trace(Marker marker, Object message, Throwable throwable)
      Logs a message at the TRACE level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
      See Also:
    • trace

      void trace(Marker marker, String message)
      Logs a message object with the TRACE level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to log.
    • trace

      void trace(Marker marker, String message, Object... params)
      Logs a message with parameters at the TRACE level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • trace

      void trace(Marker marker, String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the TRACE level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • trace

      void trace(Marker marker, String message, Throwable throwable)
      Logs a message at the TRACE level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
      See Also:
    • trace

      void trace(Marker marker, Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the TRACE level with the specified Marker.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • trace

      void trace(Marker marker, Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the TRACE level) with the specified Marker and including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - A Throwable or null.
      Since:
      2.4
    • trace

      void trace(Message message)
      Logs a message with the specific Marker at the TRACE level.
      Parameters:
      message - the message string to be logged
    • trace

      void trace(Message message, Throwable throwable)
      Logs a message with the specific Marker at the TRACE level.
      Parameters:
      message - the message string to be logged
      throwable - A Throwable or null.
    • trace

      void trace(MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the TRACE level. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • trace

      void trace(MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the TRACE level) including the stack trace of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - the Throwable to log, including its stack trace.
      Since:
      2.4
    • trace

      void trace(CharSequence message)
      Logs a message CharSequence with the TRACE level.
      Parameters:
      message - the message CharSequence to log.
    • trace

      void trace(CharSequence message, Throwable throwable)
      Logs a CharSequence at the TRACE level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
      See Also:
    • trace

      void trace(Object message)
      Logs a message object with the TRACE level.
      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.
      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.
      Parameters:
      message - the message string to log.
    • trace

      void trace(String message, Object... params)
      Logs a message with parameters at the TRACE level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • trace

      void trace(String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the TRACE level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • 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.
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
      See Also:
    • trace

      void trace(Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the TRACE level.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • trace

      void trace(Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the TRACE level) including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - the Throwable to log, including its stack trace.
      Since:
      2.4
    • trace

      void trace(Marker marker, String message, Object p0)
      Logs a message with parameters at trace level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • trace

      void trace(Marker marker, String message, Object p0, Object p1)
      Logs a message with parameters at trace level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • trace

      void trace(Marker marker, String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at trace level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • trace

      void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at trace level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • trace

      void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at trace level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • trace

      void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at trace level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • trace

      void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at trace level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • trace

      void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at trace level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • trace

      void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at trace level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • trace

      void trace(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at trace level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • trace

      void trace(String message, Object p0)
      Logs a message with parameters at trace level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • trace

      void trace(String message, Object p0, Object p1)
      Logs a message with parameters at trace level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • trace

      void trace(String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at trace level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • trace

      void trace(String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at trace level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • trace

      void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at trace level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • trace

      void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at trace level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • trace

      void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at trace level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • trace

      void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at trace level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • trace

      void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at trace level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • trace

      void trace(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at trace level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • traceEntry

      EntryMessage traceEntry()
      Logs entry to a method. Used when the method in question has no parameters or when the parameters should not be logged.
      Returns:
      built message
      Since:
      2.6
    • traceEntry

      EntryMessage traceEntry(String format, Object... params)
      Logs entry to a method along with its parameters. For example,
       public void doSomething(String foo, int bar) {
           LOGGER.traceEntry("Parameters: {} and {}", foo, bar);
           // do something
       }
       
      or:
       public int doSomething(String foo, int bar) {
           Message m = LOGGER.traceEntry("doSomething(foo={}, bar={})", foo, bar);
           // do something
           return traceExit(m, value);
       }
       
      Parameters:
      format - The format String for the parameters.
      params - The parameters to the method.
      Returns:
      The built Message
      Since:
      2.6
    • traceEntry

      EntryMessage traceEntry(Supplier<?>... paramSuppliers)
      Logs entry to a method along with its parameters. For example,
      
       public void doSomething(Request foo) {
           LOGGER.traceEntry(()->gson.toJson(foo));
           // do something
       }
       
      Parameters:
      paramSuppliers - The Suppliers for the parameters to the method.
      Returns:
      built message
      Since:
      2.6
    • traceEntry

      EntryMessage traceEntry(String format, Supplier<?>... paramSuppliers)
      Logs entry to a method along with its parameters. For example,
      
       public void doSomething(String foo, int bar) {
           LOGGER.traceEntry("Parameters: {} and {}", ()->gson.toJson(foo), ()-> bar);
           // do something
       }
       
      Parameters:
      format - The format String for the parameters.
      paramSuppliers - The Suppliers for the parameters to the method.
      Returns:
      built message
      Since:
      2.6
    • traceEntry

      EntryMessage traceEntry(Message message)
      Logs entry to a method using a Message to describe the parameters.
       public void doSomething(Request foo) {
           LOGGER.traceEntry(new JsonMessage(foo));
           // do something
       }
       

      Avoid passing a ReusableMessage to this method (therefore, also avoid passing messages created by calling logger.getMessageFactory().newMessage("some message")): Log4j will replace such messages with an immutable message to prevent situations where the reused message instance is modified by subsequent calls to the logger before the returned EntryMessage is fully processed.

      Parameters:
      message - The message. Avoid specifying a ReusableMessage, use immutable messages instead.
      Returns:
      the built message
      Since:
      2.6
      See Also:
    • traceExit

      void traceExit()
      Logs exit from a method. Used for methods that do not return anything.
      Since:
      2.6
    • traceExit

      <R> R traceExit(R result)
      Logs exiting from a method with the result. This may be coded as:
       return LOGGER.traceExit(myResult);
       
      Type Parameters:
      R - The type of the parameter and object being returned.
      Parameters:
      result - The result being returned from the method call.
      Returns:
      the result.
      Since:
      2.6
    • traceExit

      <R> R traceExit(String format, R result)
      Logs exiting from a method with the result. This may be coded as:
       return LOGGER.traceExit("Result: {}", myResult);
       
      Type Parameters:
      R - The type of the parameter and object being returned.
      Parameters:
      format - The format String for the result.
      result - The result being returned from the method call.
      Returns:
      the result.
      Since:
      2.6
    • traceExit

      void traceExit(EntryMessage message)
      Logs exiting from a method with no result. Allows custom formatting of the result. This may be coded as:
       public long doSomething(int a, int b) {
          EntryMessage m = traceEntry("doSomething(a={}, b={})", a, b);
          // ...
          return LOGGER.traceExit(m);
       }
       
      Parameters:
      message - The Message containing the formatted result.
      Since:
      2.6
    • traceExit

      <R> R traceExit(EntryMessage message, R result)
      Logs exiting from a method with the result. Allows custom formatting of the result. This may be coded as:
       public long doSomething(int a, int b) {
          EntryMessage m = traceEntry("doSomething(a={}, b={})", a, b);
          // ...
          return LOGGER.traceExit(m, myResult);
       }
       
      Type Parameters:
      R - The type of the parameter and object being returned.
      Parameters:
      message - The Message containing the formatted result.
      result - The result being returned from the method call.
      Returns:
      the result.
      Since:
      2.6
    • traceExit

      <R> R traceExit(Message message, R result)
      Logs exiting from a method with the result. Allows custom formatting of the result. This may be coded as:
       return LOGGER.traceExit(new JsonMessage(myResult), myResult);
       
      Type Parameters:
      R - The type of the parameter and object being returned.
      Parameters:
      message - The Message containing the formatted result.
      result - The result being returned from the method call.
      Returns:
      the result.
      Since:
      2.6
    • warn

      void warn(Marker marker, Message message)
      Logs a message with the specific Marker at the WARN level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
    • warn

      void warn(Marker marker, Message message, Throwable throwable)
      Logs a message with the specific Marker at the WARN level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message string to be logged
      throwable - A Throwable or null.
    • warn

      void warn(Marker marker, MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the WARN level with the specified Marker. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • warn

      void warn(Marker marker, MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the WARN level) with the specified Marker and including the stack warn of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - A Throwable or null.
      Since:
      2.4
    • warn

      void warn(Marker marker, CharSequence message)
      Logs a message CharSequence with the WARN level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message CharSequence to log.
    • warn

      void warn(Marker marker, CharSequence message, Throwable throwable)
      Logs a CharSequence at the WARN level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • warn

      void warn(Marker marker, Object message)
      Logs a message object with the WARN level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
    • warn

      void warn(Marker marker, Object message, Throwable throwable)
      Logs a message at the WARN level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • warn

      void warn(Marker marker, String message)
      Logs a message object with the WARN level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
    • warn

      void warn(Marker marker, String message, Object... params)
      Logs a message with parameters at the WARN level.
      Parameters:
      marker - the marker data specific to this log statement.
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • warn

      void warn(Marker marker, String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the WARN level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • warn

      void warn(Marker marker, String message, Throwable throwable)
      Logs a message at the WARN level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • warn

      void warn(Marker marker, Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the WARN level with the specified Marker.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • warn

      void warn(Marker marker, Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the WARN level) with the specified Marker and including the stack warn of the Throwable throwable passed as parameter.
      Parameters:
      marker - the marker data specific to this log statement
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - A Throwable or null.
      Since:
      2.4
    • warn

      void warn(Message message)
      Logs a message with the specific Marker at the WARN level.
      Parameters:
      message - the message string to be logged
    • warn

      void warn(Message message, Throwable throwable)
      Logs a message with the specific Marker at the WARN level.
      Parameters:
      message - the message string to be logged
      throwable - A Throwable or null.
    • warn

      void warn(MessageSupplier messageSupplier)
      Logs a message which is only to be constructed if the logging level is the WARN level. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      Since:
      2.4
    • warn

      void warn(MessageSupplier messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the WARN level) including the stack warn of the Throwable throwable passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message.
      throwable - the Throwable to log, including its stack warn.
      Since:
      2.4
    • warn

      void warn(CharSequence message)
      Logs a message CharSequence with the WARN level.
      Parameters:
      message - the message CharSequence to log.
    • warn

      void warn(CharSequence message, Throwable throwable)
      Logs a CharSequence at the WARN level including the stack trace of the Throwable throwable passed as parameter.
      Parameters:
      message - the message CharSequence to log.
      throwable - the Throwable to log, including its stack trace.
    • warn

      void warn(Object message)
      Logs a message object with the WARN level.
      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.
      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.
      Parameters:
      message - the message string to log.
    • warn

      void warn(String message, Object... params)
      Logs a message with parameters at the WARN level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      params - parameters to the message.
      See Also:
    • warn

      void warn(String message, Supplier<?>... paramSuppliers)
      Logs a message with parameters which are only to be constructed if the logging level is the WARN level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      Since:
      2.4
    • 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.
      Parameters:
      message - the message object to log.
      throwable - the Throwable to log, including its stack trace.
    • warn

      void warn(Supplier<?> messageSupplier)
      Logs a message which is only to be constructed if the logging level is the WARN level.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      Since:
      2.4
    • warn

      void warn(Supplier<?> messageSupplier, Throwable throwable)
      Logs a message (only to be constructed if the logging level is the WARN level) including the stack warn of the Throwable throwable passed as parameter.
      Parameters:
      messageSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      throwable - the Throwable to log, including its stack warn.
      Since:
      2.4
    • warn

      void warn(Marker marker, String message, Object p0)
      Logs a message with parameters at warn level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • warn

      void warn(Marker marker, String message, Object p0, Object p1)
      Logs a message with parameters at warn level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • warn

      void warn(Marker marker, String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at warn level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • warn

      void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at warn level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • warn

      void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at warn level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • warn

      void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at warn level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • warn

      void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at warn level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • warn

      void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at warn level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • warn

      void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at warn level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • warn

      void warn(Marker marker, String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at warn level.
      Parameters:
      marker - the marker data specific to this log statement
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • warn

      void warn(String message, Object p0)
      Logs a message with parameters at warn level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
    • warn

      void warn(String message, Object p0, Object p1)
      Logs a message with parameters at warn level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
    • warn

      void warn(String message, Object p0, Object p1, Object p2)
      Logs a message with parameters at warn level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
    • warn

      void warn(String message, Object p0, Object p1, Object p2, Object p3)
      Logs a message with parameters at warn level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
    • warn

      void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4)
      Logs a message with parameters at warn level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
    • warn

      void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5)
      Logs a message with parameters at warn level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
    • warn

      void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6)
      Logs a message with parameters at warn level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
    • warn

      void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7)
      Logs a message with parameters at warn level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
    • warn

      void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8)
      Logs a message with parameters at warn level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
    • warn

      void warn(String message, Object p0, Object p1, Object p2, Object p3, Object p4, Object p5, Object p6, Object p7, Object p8, Object p9)
      Logs a message with parameters at warn level.
      Parameters:
      message - the message to log; the format depends on the message factory.
      p0 - parameter to the message.
      p1 - parameter to the message.
      p2 - parameter to the message.
      p3 - parameter to the message.
      p4 - parameter to the message.
      p5 - parameter to the message.
      p6 - parameter to the message.
      p7 - parameter to the message.
      p8 - parameter to the message.
      p9 - parameter to the message.
    • logMessage

      default void logMessage(Level level, Marker marker, String fqcn, StackTraceElement location, Message message, Throwable throwable)
      Logs a Message.
      Parameters:
      level - The logging Level to check.
      marker - A Marker or null.
      fqcn - The fully qualified class name of the logger entry point, used to determine the caller class and method when location information needs to be logged.
      location - The location of the caller.
      message - The message format.
      throwable - the Throwable to log, including its stack trace.
      Since:
      2.13.0
    • atTrace

      default LogBuilder atTrace()
      Construct a trace log event.
      Returns:
      a LogBuilder.
      Since:
      2.13.0
    • atDebug

      default LogBuilder atDebug()
      Construct a trace log event.
      Returns:
      a LogBuilder.
      Since:
      2.13.0
    • atInfo

      default LogBuilder atInfo()
      Construct a trace log event.
      Returns:
      a LogBuilder.
      Since:
      2.13.0
    • atWarn

      default LogBuilder atWarn()
      Construct a trace log event.
      Returns:
      a LogBuilder.
      Since:
      2.13.0
    • atError

      default LogBuilder atError()
      Construct a trace log event.
      Returns:
      a LogBuilder.
      Since:
      2.13.0
    • atFatal

      default LogBuilder atFatal()
      Construct a trace log event.
      Returns:
      a LogBuilder.
      Since:
      2.13.0
    • always

      default LogBuilder always()
      Construct a log event that will always be logged.
      Returns:
      a LogBuilder.
      Since:
      2.13.0
    • atLevel

      default LogBuilder atLevel(Level level)
      Construct a log event.
      Parameters:
      level - Any level (ignoreed here).
      Returns:
      a LogBuilder.
      Since:
      2.13.0