org.apache.logging.log4j.spi

Class AbstractLogger

    • Field Detail

      • FLOW_MARKER

        public static final Marker FLOW_MARKER
        Marker for flow tracing.
      • ENTRY_MARKER

        public static final Marker ENTRY_MARKER
        Marker for method entry tracing.
      • EXIT_MARKER

        public static final Marker EXIT_MARKER
        Marker for method exit tracing.
      • EXCEPTION_MARKER

        public static final Marker EXCEPTION_MARKER
        Marker for exception tracing.
      • THROWING_MARKER

        public static final Marker THROWING_MARKER
        Marker for throwing exceptions.
      • CATCHING_MARKER

        public static final Marker CATCHING_MARKER
        Marker for catching exceptions.
      • DEFAULT_MESSAGE_FACTORY_CLASS

        public static final Class<? extends MessageFactory> DEFAULT_MESSAGE_FACTORY_CLASS
        The default MessageFactory class.
    • Constructor Detail

      • AbstractLogger

        public AbstractLogger()
        Creates a new logger named after this class (or subclass).
      • AbstractLogger

        public AbstractLogger(String name)
        Creates a new named logger.
        Parameters:
        name - the logger name
      • AbstractLogger

        public AbstractLogger(String name,
                      MessageFactory messageFactory)
        Creates a new named logger with a particular MessageFactory.
        Parameters:
        name - the logger name
        messageFactory - the message factory, if null then use the default message factory.
    • Method Detail

      • checkMessageFactory

        public static void checkMessageFactory(ExtendedLogger logger,
                               MessageFactory messageFactory)
        Checks that the message factory a logger was created with is the same as the given messageFactory. If they are different log a warning to the StatusLogger. A null MessageFactory translates to the default MessageFactory DEFAULT_MESSAGE_FACTORY_CLASS.
        Parameters:
        logger - The logger to check
        messageFactory - The message factory to check.
      • catching

        public void catching(Level level,
                    Throwable t)
        Description copied from interface: Logger
        Logs an exception or error that has been caught to a specific logging level.
        Specified by:
        catching in interface Logger
        Parameters:
        level - The logging Level.
        t - The Throwable.
      • catching

        protected void catching(String fqcn,
                    Level level,
                    Throwable t)
        Logs a Throwable that has been caught with location information.
        Parameters:
        fqcn - The fully qualified class name of the caller.
        level - The logging level.
        t - The Throwable.
      • catching

        public void catching(Throwable t)
        Description copied from interface: Logger
        Logs an exception or error that has been caught. 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.
        Specified by:
        catching in interface Logger
        Parameters:
        t - The Throwable.
      • debug

        public void debug(Marker marker,
                 Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the DEBUG level.
        Specified by:
        debug in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
      • debug

        public void debug(Marker marker,
                 Message msg,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the DEBUG level.
        Specified by:
        debug in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
        t - A Throwable or null.
      • debug

        public void debug(Marker marker,
                 Object message)
        Description copied from interface: Logger
        Logs a message object with the DEBUG level.
        Specified by:
        debug in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
      • debug

        public void debug(Marker marker,
                 Object message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the DEBUG level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        debug in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message to log.
        t - the exception to log, including its stack trace.
      • debug

        public void debug(Marker marker,
                 String message)
        Description copied from interface: Logger
        Logs a message object with the DEBUG level.
        Specified by:
        debug in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
      • debug

        public void debug(Marker marker,
                 String message,
                 Object... params)
        Description copied from interface: Logger
        Logs a message with parameters at the DEBUG level.
        Specified by:
        debug in interface Logger
        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:
        Logger.getMessageFactory()
      • debug

        public void debug(Marker marker,
                 String message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the DEBUG level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        debug in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message to log.
        t - the exception to log, including its stack trace.
      • debug

        public void debug(Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the DEBUG level.
        Specified by:
        debug in interface Logger
        Parameters:
        msg - the message string to be logged
      • debug

        public void debug(Message msg,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the DEBUG level.
        Specified by:
        debug in interface Logger
        Parameters:
        msg - the message string to be logged
        t - A Throwable or null.
      • debug

        public void debug(Object message)
        Description copied from interface: Logger
        Logs a message object with the DEBUG level.
        Specified by:
        debug in interface Logger
        Parameters:
        message - the message object to log.
      • debug

        public void debug(Object message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the DEBUG level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        debug in interface Logger
        Parameters:
        message - the message to log.
        t - the exception to log, including its stack trace.
      • debug

        public void debug(String message)
        Description copied from interface: Logger
        Logs a message object with the DEBUG level.
        Specified by:
        debug in interface Logger
        Parameters:
        message - the message string to log.
      • debug

        public void debug(String message,
                 Object... params)
        Description copied from interface: Logger
        Logs a message with parameters at the DEBUG level.
        Specified by:
        debug in interface Logger
        Parameters:
        message - the message to log; the format depends on the message factory.
        params - parameters to the message.
        See Also:
        Logger.getMessageFactory()
      • debug

        public void debug(String message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the DEBUG level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        debug in interface Logger
        Parameters:
        message - the message to log.
        t - the exception to log, including its stack trace.
      • debug

        public void debug(Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the DEBUG level.
        Specified by:
        debug in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • debug

        public void debug(Supplier<?> msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the DEBUG level) including the stack trace of the Throwable t passed as parameter.
        Specified by:
        debug in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - the exception to log, including its stack trace.
      • debug

        public void debug(Marker marker,
                 Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the DEBUG level with the specified Marker.
        Specified by:
        debug in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • debug

        public void debug(Marker marker,
                 String message,
                 Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the DEBUG level.
        Specified by:
        debug in interface Logger
        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.
      • debug

        public void debug(Marker marker,
                 Supplier<?> msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter.
        Specified by:
        debug in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - A Throwable or null.
      • debug

        public void debug(String message,
                 Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the DEBUG level.
        Specified by:
        debug in interface Logger
        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.
      • debug

        public void debug(Marker marker,
                 MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        debug in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
      • debug

        public void debug(Marker marker,
                 MessageSupplier msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        debug in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
        t - A Throwable or null.
      • debug

        public void debug(MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        debug in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
      • debug

        public void debug(MessageSupplier msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the DEBUG level) including the stack trace of the Throwable t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        debug in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
        t - the exception to log, including its stack trace.
      • entry

        public void entry()
        Description copied from interface: Logger
        Logs entry to a method. Used when the method in question has no parameters or when the parameters should not be logged.
        Specified by:
        entry in interface Logger
      • entry

        public void entry(Object... params)
        Description copied from interface: Logger
        Logs entry to a method along with its parameters. 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.

        Specified by:
        entry in interface Logger
        Parameters:
        params - The parameters to the method. TODO Use of varargs results in array creation which can be a substantial portion of no-op case. LogMF/LogSF provides several overrides to avoid vararg except in edge cases. (RG) LogMF and LogSF implement these in LogXF which calls logger.callAppenders. callAppenders is part of the implementation and cannot be used by the API. Adding more methods here and in AbstractLogger is sufficient.
      • entry

        protected void entry(String fqcn,
                 Object... params)
        Logs entry to a method with location information.
        Parameters:
        fqcn - The fully qualified class name of the caller.
        params - The parameters to the method.
      • entryMsg

        protected Message entryMsg(int count,
                       Object... params)
      • error

        public void error(Marker marker,
                 Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the ERROR level.
        Specified by:
        error in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
      • error

        public void error(Marker marker,
                 Message msg,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the ERROR level.
        Specified by:
        error in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
        t - A Throwable or null.
      • error

        public void error(Marker marker,
                 Object message)
        Description copied from interface: Logger
        Logs a message object with the ERROR level.
        Specified by:
        error in interface Logger
        Parameters:
        marker - the marker data specific to this log statement.
        message - the message object to log.
      • error

        public void error(Marker marker,
                 Object message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the ERROR level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        error in interface Logger
        Parameters:
        marker - the marker data specific to this log statement.
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • error

        public void error(Marker marker,
                 String message)
        Description copied from interface: Logger
        Logs a message object with the ERROR level.
        Specified by:
        error in interface Logger
        Parameters:
        marker - the marker data specific to this log statement.
        message - the message object to log.
      • error

        public void error(Marker marker,
                 String message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the ERROR level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        error in interface Logger
        Parameters:
        marker - the marker data specific to this log statement.
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • error

        public void error(Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the ERROR level.
        Specified by:
        error in interface Logger
        Parameters:
        msg - the message string to be logged
      • error

        public void error(Message msg,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the ERROR level.
        Specified by:
        error in interface Logger
        Parameters:
        msg - the message string to be logged
        t - A Throwable or null.
      • error

        public void error(Object message)
        Description copied from interface: Logger
        Logs a message object with the ERROR level.
        Specified by:
        error in interface Logger
        Parameters:
        message - the message object to log.
      • error

        public void error(Object message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the ERROR level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        error in interface Logger
        Parameters:
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • error

        public void error(String message)
        Description copied from interface: Logger
        Logs a message object with the ERROR level.
        Specified by:
        error in interface Logger
        Parameters:
        message - the message string to log.
      • error

        public void error(String message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the ERROR level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        error in interface Logger
        Parameters:
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • error

        public void error(Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the ERROR level.
        Specified by:
        error in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • error

        public void error(Supplier<?> msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the ERROR level) including the stack trace of the Throwable t passed as parameter.
        Specified by:
        error in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - the exception to log, including its stack trace.
      • error

        public void error(Marker marker,
                 Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the ERROR level with the specified Marker.
        Specified by:
        error in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • error

        public void error(Marker marker,
                 String message,
                 Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the ERROR level.
        Specified by:
        error in interface Logger
        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.
      • error

        public void error(Marker marker,
                 Supplier<?> msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter.
        Specified by:
        error in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - A Throwable or null.
      • error

        public void error(String message,
                 Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the ERROR level.
        Specified by:
        error in interface Logger
        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.
      • error

        public void error(Marker marker,
                 MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        error in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
      • error

        public void error(Marker marker,
                 MessageSupplier msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        error in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
        t - A Throwable or null.
      • error

        public void error(MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        error in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
      • error

        public void error(MessageSupplier msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the ERROR level) including the stack trace of the Throwable t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        error in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
        t - the exception to log, including its stack trace.
      • exit

        public void exit()
        Description copied from interface: Logger
        Logs exit from a method. Used for methods that do not return anything.
        Specified by:
        exit in interface Logger
      • exit

        public <R> R exit(R result)
        Description copied from interface: Logger
        Logs exiting from a method with the result. This may be coded as:
         return LOGGER.exit(myResult);
         
        Specified by:
        exit in interface Logger
        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.
      • exit

        protected <R> R exit(String fqcn,
                 R result)
        Logs exiting from a method with the result and location information.
        Type Parameters:
        R - The type of the parameter and object being returned.
        Parameters:
        fqcn - The fully qualified class name of the caller.
        result - The result being returned from the method call.
        Returns:
        the return value passed to this method.
      • fatal

        public void fatal(Marker marker,
                 Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the FATAL level.
        Specified by:
        fatal in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
      • fatal

        public void fatal(Marker marker,
                 Message msg,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the FATAL level.
        Specified by:
        fatal in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
        t - A Throwable or null.
      • fatal

        public void fatal(Marker marker,
                 Object message)
        Description copied from interface: Logger
        Logs a message object with the FATAL level.
        Specified by:
        fatal in interface Logger
        Parameters:
        marker - The marker data specific to this log statement.
        message - the message object to log.
      • fatal

        public void fatal(Marker marker,
                 Object message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the FATAL level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        fatal in interface Logger
        Parameters:
        marker - The marker data specific to this log statement.
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • fatal

        public void fatal(Marker marker,
                 String message)
        Description copied from interface: Logger
        Logs a message object with the FATAL level.
        Specified by:
        fatal in interface Logger
        Parameters:
        marker - The marker data specific to this log statement.
        message - the message object to log.
      • fatal

        public void fatal(Marker marker,
                 String message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the FATAL level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        fatal in interface Logger
        Parameters:
        marker - The marker data specific to this log statement.
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • fatal

        public void fatal(Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the FATAL level.
        Specified by:
        fatal in interface Logger
        Parameters:
        msg - the message string to be logged
      • fatal

        public void fatal(Message msg,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the FATAL level.
        Specified by:
        fatal in interface Logger
        Parameters:
        msg - the message string to be logged
        t - A Throwable or null.
      • fatal

        public void fatal(Object message)
        Description copied from interface: Logger
        Logs a message object with the FATAL level.
        Specified by:
        fatal in interface Logger
        Parameters:
        message - the message object to log.
      • fatal

        public void fatal(Object message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the FATAL level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        fatal in interface Logger
        Parameters:
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • fatal

        public void fatal(String message)
        Description copied from interface: Logger
        Logs a message object with the FATAL level.
        Specified by:
        fatal in interface Logger
        Parameters:
        message - the message string to log.
      • fatal

        public void fatal(String message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the FATAL level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        fatal in interface Logger
        Parameters:
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • fatal

        public void fatal(Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the FATAL level.
        Specified by:
        fatal in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • fatal

        public void fatal(Supplier<?> msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the FATAL level) including the stack trace of the Throwable t passed as parameter.
        Specified by:
        fatal in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - the exception to log, including its stack trace.
      • fatal

        public void fatal(Marker marker,
                 Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the FATAL level with the specified Marker.
        Specified by:
        fatal in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • fatal

        public void fatal(Marker marker,
                 String message,
                 Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the FATAL level.
        Specified by:
        fatal in interface Logger
        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.
      • fatal

        public void fatal(Marker marker,
                 Supplier<?> msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter.
        Specified by:
        fatal in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - A Throwable or null.
      • fatal

        public void fatal(String message,
                 Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the FATAL level.
        Specified by:
        fatal in interface Logger
        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.
      • fatal

        public void fatal(Marker marker,
                 MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        fatal in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
      • fatal

        public void fatal(Marker marker,
                 MessageSupplier msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        fatal in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
        t - A Throwable or null.
      • fatal

        public void fatal(MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        fatal in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
      • fatal

        public void fatal(MessageSupplier msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the FATAL level) including the stack trace of the Throwable t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        fatal in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
        t - the exception to log, including its stack trace.
      • getMessageFactory

        public MessageFactory getMessageFactory()
        Description copied from interface: Logger
        Gets the message factory used to convert message Objects and Strings into actual log Messages.
        Specified by:
        getMessageFactory in interface Logger
        Returns:
        the message factory.
      • getName

        public String getName()
        Description copied from interface: Logger
        Gets the logger name.
        Specified by:
        getName in interface Logger
        Returns:
        the logger name.
      • info

        public void info(Marker marker,
                Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the INFO level.
        Specified by:
        info in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
      • info

        public void info(Marker marker,
                Message msg,
                Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the INFO level.
        Specified by:
        info in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
        t - A Throwable or null.
      • info

        public void info(Marker marker,
                Object message)
        Description copied from interface: Logger
        Logs a message object with the INFO level.
        Specified by:
        info in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
      • info

        public void info(Marker marker,
                Object message,
                Throwable t)
        Description copied from interface: Logger
        Logs a message at the INFO level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        info in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • info

        public void info(Marker marker,
                String message)
        Description copied from interface: Logger
        Logs a message object with the INFO level.
        Specified by:
        info in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
      • info

        public void info(Marker marker,
                String message,
                Throwable t)
        Description copied from interface: Logger
        Logs a message at the INFO level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        info in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • info

        public void info(Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the INFO level.
        Specified by:
        info in interface Logger
        Parameters:
        msg - the message string to be logged
      • info

        public void info(Message msg,
                Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the INFO level.
        Specified by:
        info in interface Logger
        Parameters:
        msg - the message string to be logged
        t - A Throwable or null.
      • info

        public void info(Object message)
        Description copied from interface: Logger
        Logs a message object with the INFO level.
        Specified by:
        info in interface Logger
        Parameters:
        message - the message object to log.
      • info

        public void info(Object message,
                Throwable t)
        Description copied from interface: Logger
        Logs a message at the INFO level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        info in interface Logger
        Parameters:
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • info

        public void info(String message)
        Description copied from interface: Logger
        Logs a message object with the INFO level.
        Specified by:
        info in interface Logger
        Parameters:
        message - the message string to log.
      • info

        public void info(String message,
                Throwable t)
        Description copied from interface: Logger
        Logs a message at the INFO level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        info in interface Logger
        Parameters:
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • info

        public void info(Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the INFO level.
        Specified by:
        info in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • info

        public void info(Supplier<?> msgSupplier,
                Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the INFO level) including the stack trace of the Throwable t passed as parameter.
        Specified by:
        info in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - the exception to log, including its stack trace.
      • info

        public void info(Marker marker,
                Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the INFO level with the specified Marker.
        Specified by:
        info in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • info

        public void info(Marker marker,
                String message,
                Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the INFO level.
        Specified by:
        info in interface Logger
        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.
      • info

        public void info(Marker marker,
                Supplier<?> msgSupplier,
                Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter.
        Specified by:
        info in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - A Throwable or null.
      • info

        public void info(String message,
                Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the INFO level.
        Specified by:
        info in interface Logger
        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.
      • info

        public void info(Marker marker,
                MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        info in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
      • info

        public void info(Marker marker,
                MessageSupplier msgSupplier,
                Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        info in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
        t - A Throwable or null.
      • info

        public void info(MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        info in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
      • info

        public void info(MessageSupplier msgSupplier,
                Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the INFO level) including the stack trace of the Throwable t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        info in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
        t - the exception to log, including its stack trace.
      • isDebugEnabled

        public boolean isDebugEnabled()
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the DEBUG Level.
        Specified by:
        isDebugEnabled in interface Logger
        Returns:
        boolean - true if this Logger is enabled for level DEBUG, false otherwise.
      • isDebugEnabled

        public boolean isDebugEnabled(Marker marker)
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the DEBUG Level.
        Specified by:
        isDebugEnabled in interface Logger
        Parameters:
        marker - The marker data specific to this log statement.
        Returns:
        boolean - true if this Logger is enabled for level DEBUG, false otherwise.
      • isEnabled

        public boolean isEnabled(Level level)
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the the given Level.

        Note that passing in OFF always returns true.

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

        public boolean isEnabled(Level level,
                        Marker marker)
        Description copied from interface: Logger
        Checks whether this logger is enabled at the specified level and an optional Marker.
        Specified by:
        isEnabled in interface Logger
        Parameters:
        level - The Level to check.
        marker - The marker data specific to this log statement.
        Returns:
        boolean - true if this Logger is enabled for level WARN, false otherwise.
      • isErrorEnabled

        public boolean isErrorEnabled()
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the ERROR Level.
        Specified by:
        isErrorEnabled in interface Logger
        Returns:
        boolean - true if this Logger is enabled for level ERROR, false otherwise.
      • isErrorEnabled

        public boolean isErrorEnabled(Marker marker)
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the ERROR Level.
        Specified by:
        isErrorEnabled in interface Logger
        Parameters:
        marker - The marker data specific to this log statement.
        Returns:
        boolean - true if this Logger is enabled for level ERROR, false otherwise.
      • isFatalEnabled

        public boolean isFatalEnabled()
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the FATAL Level.
        Specified by:
        isFatalEnabled in interface Logger
        Returns:
        boolean - true if this Logger is enabled for level FATAL, false otherwise.
      • isFatalEnabled

        public boolean isFatalEnabled(Marker marker)
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the FATAL Level.
        Specified by:
        isFatalEnabled in interface Logger
        Parameters:
        marker - The marker data specific to this log statement.
        Returns:
        boolean - true if this Logger is enabled for level FATAL, false otherwise.
      • isInfoEnabled

        public boolean isInfoEnabled()
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the INFO Level.
        Specified by:
        isInfoEnabled in interface Logger
        Returns:
        boolean - true if this Logger is enabled for level INFO, false otherwise.
      • isInfoEnabled

        public boolean isInfoEnabled(Marker marker)
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the INFO Level.
        Specified by:
        isInfoEnabled in interface Logger
        Parameters:
        marker - The marker data specific to this log statement.
        Returns:
        boolean - true if this Logger is enabled for level INFO, false otherwise.
      • isTraceEnabled

        public boolean isTraceEnabled()
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the TRACE level.
        Specified by:
        isTraceEnabled in interface Logger
        Returns:
        boolean - true if this Logger is enabled for level TRACE, false otherwise.
      • isTraceEnabled

        public boolean isTraceEnabled(Marker marker)
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the TRACE level.
        Specified by:
        isTraceEnabled in interface Logger
        Parameters:
        marker - The marker data specific to this log statement.
        Returns:
        boolean - true if this Logger is enabled for level TRACE, false otherwise.
      • isWarnEnabled

        public boolean isWarnEnabled()
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the WARN Level.
        Specified by:
        isWarnEnabled in interface Logger
        Returns:
        boolean - true if this Logger is enabled for level WARN, false otherwise.
      • isWarnEnabled

        public boolean isWarnEnabled(Marker marker)
        Description copied from interface: Logger
        Checks whether this Logger is enabled for the WARN Level.
        Specified by:
        isWarnEnabled in interface Logger
        Parameters:
        marker - The marker data specific to this log statement.
        Returns:
        boolean - true if this Logger is enabled for level WARN, false otherwise.
      • log

        public void log(Level level,
               Marker marker,
               Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the given level.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        marker - the marker data specific to this log statement
        msg - the message string to be logged
      • log

        public void log(Level level,
               Marker marker,
               Message msg,
               Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the given level.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        marker - the marker data specific to this log statement
        msg - the message string to be logged
        t - A Throwable or null.
      • log

        public void log(Level level,
               Marker marker,
               Object message)
        Description copied from interface: Logger
        Logs a message object with the given level.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        marker - the marker data specific to this log statement
        message - the message object to log.
      • log

        public void log(Level level,
               Marker marker,
               Object message,
               Throwable t)
        Description copied from interface: Logger
        Logs a message at the given level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        marker - the marker data specific to this log statement
        message - the message to log.
        t - the exception to log, including its stack trace.
      • log

        public void log(Level level,
               Marker marker,
               String message)
        Description copied from interface: Logger
        Logs a message object with the given level.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        marker - the marker data specific to this log statement
        message - the message object to log.
      • log

        public void log(Level level,
               Marker marker,
               String message,
               Object... params)
        Description copied from interface: Logger
        Logs a message with parameters at the given level.
        Specified by:
        log in interface Logger
        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:
        Logger.getMessageFactory()
      • log

        public void log(Level level,
               Marker marker,
               String message,
               Throwable t)
        Description copied from interface: Logger
        Logs a message at the given level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        marker - the marker data specific to this log statement
        message - the message to log.
        t - the exception to log, including its stack trace.
      • log

        public void log(Level level,
               Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the given level.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        msg - the message string to be logged
      • log

        public void log(Level level,
               Message msg,
               Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the given level.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        msg - the message string to be logged
        t - A Throwable or null.
      • log

        public void log(Level level,
               Object message)
        Description copied from interface: Logger
        Logs a message object with the given level.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        message - the message object to log.
      • log

        public void log(Level level,
               Object message,
               Throwable t)
        Description copied from interface: Logger
        Logs a message at the given level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        message - the message to log.
        t - the exception to log, including its stack trace.
      • log

        public void log(Level level,
               String message)
        Description copied from interface: Logger
        Logs a message object with the given level.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        message - the message string to log.
      • log

        public void log(Level level,
               String message,
               Object... params)
        Description copied from interface: Logger
        Logs a message with parameters at the given level.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        message - the message to log; the format depends on the message factory.
        params - parameters to the message.
        See Also:
        Logger.getMessageFactory()
      • log

        public void log(Level level,
               String message,
               Throwable t)
        Description copied from interface: Logger
        Logs a message at the given level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        message - the message to log.
        t - the exception to log, including its stack trace.
      • log

        public void log(Level level,
               Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the specified level.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • log

        public void log(Level level,
               Supplier<?> msgSupplier,
               Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the specified level) including the stack log of the Throwable t passed as parameter.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - the exception to log, including its stack log.
      • log

        public void log(Level level,
               Marker marker,
               Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the specified level) with the specified Marker.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • log

        public void log(Level level,
               Marker marker,
               String message,
               Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the specified level.
        Specified by:
        log in interface Logger
        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.
      • log

        public void log(Level level,
               Marker marker,
               Supplier<?> msgSupplier,
               Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - A Throwable or null.
      • log

        public void log(Level level,
               String message,
               Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the specified level.
        Specified by:
        log in interface Logger
        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.
      • log

        public void log(Level level,
               Marker marker,
               MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
      • log

        public void log(Level level,
               Marker marker,
               MessageSupplier msgSupplier,
               Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
        t - A Throwable or null.
      • log

        public void log(Level level,
               MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        msgSupplier - A function, which when called, produces the desired log message.
      • log

        public void log(Level level,
               MessageSupplier msgSupplier,
               Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the specified level) including the stack log of the Throwable t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        log in interface Logger
        Parameters:
        level - the logging level
        msgSupplier - A function, which when called, produces the desired log message.
        t - the exception to log, including its stack log.
      • logIfEnabled

        public void logIfEnabled(String fqcn,
                        Level level,
                        Marker marker,
                        Message msg,
                        Throwable t)
        Description copied from interface: ExtendedLogger
        Logs a message if the specified level is active.
        Specified by:
        logIfEnabled in interface ExtendedLogger
        Parameters:
        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.
        level - The logging Level to check.
        marker - A Marker or null.
        msg - The Message.
        t - the exception to log, including its stack trace.
      • logIfEnabled

        public void logIfEnabled(String fqcn,
                        Level level,
                        Marker marker,
                        MessageSupplier msgSupplier,
                        Throwable t)
        Description copied from interface: ExtendedLogger
        Logs a message which is only to be constructed if the specified level is active.
        Specified by:
        logIfEnabled in interface ExtendedLogger
        Parameters:
        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.
        level - The logging Level to check.
        marker - A Marker or null.
        msgSupplier - A function, which when called, produces the desired log message.
        t - the exception to log, including its stack trace.
      • logIfEnabled

        public void logIfEnabled(String fqcn,
                        Level level,
                        Marker marker,
                        Object message,
                        Throwable t)
        Description copied from interface: ExtendedLogger
        Logs a message if the specified level is active.
        Specified by:
        logIfEnabled in interface ExtendedLogger
        Parameters:
        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.
        level - The logging Level to check.
        marker - A Marker or null.
        message - The message.
        t - the exception to log, including its stack trace.
      • logIfEnabled

        public void logIfEnabled(String fqcn,
                        Level level,
                        Marker marker,
                        Supplier<?> msgSupplier,
                        Throwable t)
        Description copied from interface: ExtendedLogger
        Logs a message which is only to be constructed if the specified level is active.
        Specified by:
        logIfEnabled in interface ExtendedLogger
        Parameters:
        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.
        level - The logging Level to check.
        marker - A Marker or null.
        msgSupplier - A function, which when called, produces the desired log message.
        t - the exception to log, including its stack trace.
      • logIfEnabled

        public void logIfEnabled(String fqcn,
                        Level level,
                        Marker marker,
                        String message)
        Description copied from interface: ExtendedLogger
        Logs a message if the specified level is active.
        Specified by:
        logIfEnabled in interface ExtendedLogger
        Parameters:
        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.
        level - The logging Level to check.
        marker - A Marker or null.
        message - The message.
      • logIfEnabled

        public void logIfEnabled(String fqcn,
                        Level level,
                        Marker marker,
                        String message,
                        Supplier<?>... paramSuppliers)
        Description copied from interface: ExtendedLogger
        Logs a message whose parameters are only to be constructed if the specified level is active.
        Specified by:
        logIfEnabled in interface ExtendedLogger
        Parameters:
        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.
        level - The logging Level to check.
        marker - A Marker or null.
        message - The message format.
        paramSuppliers - An array of functions, which when called, produce the desired log message parameters.
      • logIfEnabled

        public void logIfEnabled(String fqcn,
                        Level level,
                        Marker marker,
                        String message,
                        Object... params)
        Description copied from interface: ExtendedLogger
        Logs a message if the specified level is active.
        Specified by:
        logIfEnabled in interface ExtendedLogger
        Parameters:
        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.
        level - The logging Level to check.
        marker - A Marker or null.
        message - The message format.
        params - The message parameters.
      • logIfEnabled

        public void logIfEnabled(String fqcn,
                        Level level,
                        Marker marker,
                        String message,
                        Throwable t)
        Description copied from interface: ExtendedLogger
        Logs a message if the specified level is active.
        Specified by:
        logIfEnabled in interface ExtendedLogger
        Parameters:
        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.
        level - The logging Level to check.
        marker - A Marker or null.
        message - The message.
        t - the exception to log, including its stack trace.
      • printf

        public void printf(Level level,
                  Marker marker,
                  String format,
                  Object... params)
        Description copied from interface: Logger
        Logs a formatted message using the specified format string and arguments.
        Specified by:
        printf in interface Logger
        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

        public void printf(Level level,
                  String format,
                  Object... params)
        Description copied from interface: Logger
        Logs a formatted message using the specified format string and arguments.
        Specified by:
        printf in interface Logger
        Parameters:
        level - The logging Level.
        format - The format String.
        params - Arguments specified by the format.
      • throwing

        public <T extends Throwable> T throwing(T t)
        Description copied from interface: Logger
        Logs an exception or error to be thrown. This may be coded as:
         throw logger.throwing(myException);
         
        Specified by:
        throwing in interface Logger
        Type Parameters:
        T - the Throwable type.
        Parameters:
        t - The Throwable.
        Returns:
        the Throwable.
      • throwing

        public <T extends Throwable> T throwing(Level level,
                                       T t)
        Description copied from interface: Logger
        Logs an exception or error to be thrown. This may be coded as:
         throw logger.throwing(Level.DEBUG, myException);
         
        Specified by:
        throwing in interface Logger
        Type Parameters:
        T - the Throwable type.
        Parameters:
        level - The logging Level.
        t - The Throwable.
        Returns:
        the Throwable.
      • throwing

        protected <T extends Throwable> T throwing(String fqcn,
                                       Level level,
                                       T t)
        Logs a Throwable to be thrown.
        Type Parameters:
        T - the type of the Throwable.
        Parameters:
        fqcn - the fully qualified class name of this Logger implementation.
        level - The logging Level.
        t - The Throwable.
        Returns:
        the Throwable.
      • trace

        public void trace(Marker marker,
                 Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the TRACE level.
        Specified by:
        trace in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
      • trace

        public void trace(Marker marker,
                 Message msg,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the TRACE level.
        Specified by:
        trace in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
        t - A Throwable or null.
      • trace

        public void trace(Marker marker,
                 Object message)
        Description copied from interface: Logger
        Logs a message object with the TRACE level.
        Specified by:
        trace in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
      • trace

        public void trace(Marker marker,
                 Object message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the TRACE level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        trace in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
        t - the exception to log, including its stack trace.
        See Also:
        Logger.debug(String)
      • trace

        public void trace(Marker marker,
                 String message)
        Description copied from interface: Logger
        Logs a message object with the TRACE level.
        Specified by:
        trace in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message string to log.
      • trace

        public void trace(Marker marker,
                 String message,
                 Object... params)
        Description copied from interface: Logger
        Logs a message with parameters at the TRACE level.
        Specified by:
        trace in interface Logger
        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:
        Logger.getMessageFactory()
      • trace

        public void trace(Marker marker,
                 String message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the TRACE level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        trace in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
        t - the exception to log, including its stack trace.
        See Also:
        Logger.debug(String)
      • trace

        public void trace(Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the TRACE level.
        Specified by:
        trace in interface Logger
        Parameters:
        msg - the message string to be logged
      • trace

        public void trace(Message msg,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the TRACE level.
        Specified by:
        trace in interface Logger
        Parameters:
        msg - the message string to be logged
        t - A Throwable or null.
      • trace

        public void trace(Object message)
        Description copied from interface: Logger
        Logs a message object with the TRACE level.
        Specified by:
        trace in interface Logger
        Parameters:
        message - the message object to log.
      • trace

        public void trace(Object message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the TRACE level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        trace in interface Logger
        Parameters:
        message - the message object to log.
        t - the exception to log, including its stack trace.
        See Also:
        Logger.debug(String)
      • trace

        public void trace(String message)
        Description copied from interface: Logger
        Logs a message object with the TRACE level.
        Specified by:
        trace in interface Logger
        Parameters:
        message - the message string to log.
      • trace

        public void trace(String message,
                 Object... params)
        Description copied from interface: Logger
        Logs a message with parameters at the TRACE level.
        Specified by:
        trace in interface Logger
        Parameters:
        message - the message to log; the format depends on the message factory.
        params - parameters to the message.
        See Also:
        Logger.getMessageFactory()
      • trace

        public void trace(String message,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message at the TRACE level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        trace in interface Logger
        Parameters:
        message - the message object to log.
        t - the exception to log, including its stack trace.
        See Also:
        Logger.debug(String)
      • trace

        public void trace(Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the TRACE level.
        Specified by:
        trace in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • trace

        public void trace(Supplier<?> msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the TRACE level) including the stack trace of the Throwable t passed as parameter.
        Specified by:
        trace in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - the exception to log, including its stack trace.
      • trace

        public void trace(Marker marker,
                 Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the TRACE level with the specified Marker.
        Specified by:
        trace in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • trace

        public void trace(Marker marker,
                 String message,
                 Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the TRACE level.
        Specified by:
        trace in interface Logger
        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.
      • trace

        public void trace(Marker marker,
                 Supplier<?> msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter.
        Specified by:
        trace in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - A Throwable or null.
      • trace

        public void trace(String message,
                 Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the TRACE level.
        Specified by:
        trace in interface Logger
        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.
      • trace

        public void trace(Marker marker,
                 MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        trace in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
      • trace

        public void trace(Marker marker,
                 MessageSupplier msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        trace in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
        t - A Throwable or null.
      • trace

        public void trace(MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        trace in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
      • trace

        public void trace(MessageSupplier msgSupplier,
                 Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the TRACE level) including the stack trace of the Throwable t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        trace in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
        t - the exception to log, including its stack trace.
      • warn

        public void warn(Marker marker,
                Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the WARN level.
        Specified by:
        warn in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
      • warn

        public void warn(Marker marker,
                Message msg,
                Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the WARN level.
        Specified by:
        warn in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msg - the message string to be logged
        t - A Throwable or null.
      • warn

        public void warn(Marker marker,
                Object message)
        Description copied from interface: Logger
        Logs a message object with the WARN level.
        Specified by:
        warn in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
      • warn

        public void warn(Marker marker,
                Object message,
                Throwable t)
        Description copied from interface: Logger
        Logs a message at the WARN level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        warn in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • warn

        public void warn(Marker marker,
                String message)
        Description copied from interface: Logger
        Logs a message object with the WARN level.
        Specified by:
        warn in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
      • warn

        public void warn(Marker marker,
                String message,
                Throwable t)
        Description copied from interface: Logger
        Logs a message at the WARN level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        warn in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • warn

        public void warn(Message msg)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the WARN level.
        Specified by:
        warn in interface Logger
        Parameters:
        msg - the message string to be logged
      • warn

        public void warn(Message msg,
                Throwable t)
        Description copied from interface: Logger
        Logs a message with the specific Marker at the WARN level.
        Specified by:
        warn in interface Logger
        Parameters:
        msg - the message string to be logged
        t - A Throwable or null.
      • warn

        public void warn(Object message)
        Description copied from interface: Logger
        Logs a message object with the WARN level.
        Specified by:
        warn in interface Logger
        Parameters:
        message - the message object to log.
      • warn

        public void warn(Object message,
                Throwable t)
        Description copied from interface: Logger
        Logs a message at the WARN level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        warn in interface Logger
        Parameters:
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • warn

        public void warn(String message)
        Description copied from interface: Logger
        Logs a message object with the WARN level.
        Specified by:
        warn in interface Logger
        Parameters:
        message - the message string to log.
      • warn

        public void warn(String message,
                Throwable t)
        Description copied from interface: Logger
        Logs a message at the WARN level including the stack trace of the Throwable t passed as parameter.
        Specified by:
        warn in interface Logger
        Parameters:
        message - the message object to log.
        t - the exception to log, including its stack trace.
      • warn

        public void warn(Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the WARN level.
        Specified by:
        warn in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • warn

        public void warn(Supplier<?> msgSupplier,
                Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the WARN level) including the stack warn of the Throwable t passed as parameter.
        Specified by:
        warn in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - the exception to log, including its stack warn.
      • warn

        public void warn(Marker marker,
                Supplier<?> msgSupplier)
        Description copied from interface: Logger
        Logs a message which is only to be constructed if the logging level is the WARN level with the specified Marker.
        Specified by:
        warn in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
      • warn

        public void warn(Marker marker,
                String message,
                Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the WARN level.
        Specified by:
        warn in interface Logger
        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.
      • warn

        public void warn(Marker marker,
                Supplier<?> msgSupplier,
                Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter.
        Specified by:
        warn in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message; the format depends on the message factory.
        t - A Throwable or null.
      • warn

        public void warn(String message,
                Supplier<?>... paramSuppliers)
        Description copied from interface: Logger
        Logs a message with parameters which are only to be constructed if the logging level is the WARN level.
        Specified by:
        warn in interface Logger
        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.
      • warn

        public void warn(Marker marker,
                MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        warn in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
      • warn

        public void warn(Marker marker,
                MessageSupplier msgSupplier,
                Throwable t)
        Description copied from interface: Logger
        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 t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        warn in interface Logger
        Parameters:
        marker - the marker data specific to this log statement
        msgSupplier - A function, which when called, produces the desired log message.
        t - A Throwable or null.
      • warn

        public void warn(MessageSupplier msgSupplier)
        Description copied from interface: Logger
        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.
        Specified by:
        warn in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
      • warn

        public void warn(MessageSupplier msgSupplier,
                Throwable t)
        Description copied from interface: Logger
        Logs a message (only to be constructed if the logging level is the WARN level) including the stack warn of the Throwable t passed as parameter. The MessageSupplier may or may not use the MessageFactory to construct the Message.
        Specified by:
        warn in interface Logger
        Parameters:
        msgSupplier - A function, which when called, produces the desired log message.
        t - the exception to log, including its stack warn.

Copyright © 1999-2015 Apache Software Foundation. All Rights Reserved.
Apache Logging, Apache Log4j, Log4j, Apache, the Apache feather logo, the Apache Logging project logo, and the Apache Log4j logo are trademarks of The Apache Software Foundation.