Module org.tinylog.api

Package org.tinylog

Class Logger

java.lang.Object

org.tinylog.Logger

public final class Logger
extends java.lang.Object

Static logger for issuing log entries.

Method Summary

Modifier and Type	Method	Description
static void	debug(java.lang.Object message)	Logs a message at DEBUG level.
static void	debug(java.lang.String message, java.lang.Object... arguments)	Logs a formatted message at DEBUG level. "{}" placeholders will be replaced by given arguments.
static void	debug(java.lang.String message, Supplier<?>... arguments)	Logs a formatted message at DEBUG level. "{}" placeholders will be replaced by given lazy arguments.
static void	debug(java.lang.Throwable exception)	Logs an exception at DEBUG level.
static void	debug(java.lang.Throwable exception, java.lang.String message)	Logs an exception with a custom message at DEBUG level.
static void	debug(java.lang.Throwable exception, java.lang.String message, java.lang.Object... arguments)	Logs an exception with a formatted custom message at DEBUG level. "{}" placeholders will be replaced by given arguments.
static void	debug(java.lang.Throwable exception, java.lang.String message, Supplier<?>... arguments)	Logs an exception with a formatted message at DEBUG level. "{}" placeholders will be replaced by given lazy arguments.
static void	debug(java.lang.Throwable exception, Supplier<java.lang.String> message)	Logs an exception with a custom lazy message at DEBUG level.
static void	debug(Supplier<?> message)	Logs a lazy message at DEBUG level.
static void	error(java.lang.Object message)	Logs a message at ERROR level.
static void	error(java.lang.String message, java.lang.Object... arguments)	Logs a formatted message at ERROR level. "{}" placeholders will be replaced by given arguments.
static void	error(java.lang.String message, Supplier<?>... arguments)	Logs a formatted message at ERROR level. "{}" placeholders will be replaced by given lazy arguments.
static void	error(java.lang.Throwable exception)	Logs an exception at ERROR level.
static void	error(java.lang.Throwable exception, java.lang.String message)	Logs an exception with a custom message at ERROR level.
static void	error(java.lang.Throwable exception, java.lang.String message, java.lang.Object... arguments)	Logs an exception with a formatted custom message at ERROR level. "{}" placeholders will be replaced by given arguments.
static void	error(java.lang.Throwable exception, java.lang.String message, Supplier<?>... arguments)	Logs an exception with a formatted message at ERROR level. "{}" placeholders will be replaced by given lazy arguments.
static void	error(java.lang.Throwable exception, Supplier<java.lang.String> message)	Logs an exception with a custom lazy message at ERROR level.
static void	error(Supplier<?> message)	Logs a lazy message at ERROR level.
static void	info(java.lang.Object message)	Logs a message at INFO level.
static void	info(java.lang.String message, java.lang.Object... arguments)	Logs a formatted message at INFO level. "{}" placeholders will be replaced by given arguments.
static void	info(java.lang.String message, Supplier<?>... arguments)	Logs a formatted message at INFO level. "{}" placeholders will be replaced by given lazy arguments.
static void	info(java.lang.Throwable exception)	Logs an exception at INFO level.
static void	info(java.lang.Throwable exception, java.lang.String message)	Logs an exception with a custom message at INFO level.
static void	info(java.lang.Throwable exception, java.lang.String message, java.lang.Object... arguments)	Logs an exception with a formatted custom message at INFO level. "{}" placeholders will be replaced by given arguments.
static void	info(java.lang.Throwable exception, java.lang.String message, Supplier<?>... arguments)	Logs an exception with a formatted message at INFO level. "{}" placeholders will be replaced by given lazy arguments.
static void	info(java.lang.Throwable exception, Supplier<java.lang.String> message)	Logs an exception with a custom lazy message at INFO level.
static void	info(Supplier<?> message)	Logs a lazy message at INFO level.
static boolean	isDebugEnabled()	Checks whether log entries at DEBUG level will be output.
static boolean	isErrorEnabled()	Checks whether log entries at ERROR level will be output.
static boolean	isInfoEnabled()	Checks whether log entries at INFO level will be output.
static boolean	isTraceEnabled()	Checks whether log entries at TRACE level will be output.
static boolean	isWarnEnabled()	Checks whether log entries at WARN level will be output.
static TaggedLogger	tag(java.lang.String tag)	Gets a tagged logger instance.
static void	trace(java.lang.Object message)	Logs a message at TRACE level.
static void	trace(java.lang.String message, java.lang.Object... arguments)	Logs a formatted message at TRACE level. "{}" placeholders will be replaced by given arguments.
static void	trace(java.lang.String message, Supplier<?>... arguments)	Logs a formatted message at TRACE level. "{}" placeholders will be replaced by given lazy arguments.
static void	trace(java.lang.Throwable exception)	Logs an exception at TRACE level.
static void	trace(java.lang.Throwable exception, java.lang.String message)	Logs an exception with a custom message at TRACE level.
static void	trace(java.lang.Throwable exception, java.lang.String message, java.lang.Object... arguments)	Logs an exception with a formatted custom message at TRACE level. "{}" placeholders will be replaced by given arguments.
static void	trace(java.lang.Throwable exception, java.lang.String message, Supplier<?>... arguments)	Logs an exception with a formatted message at TRACE level. "{}" placeholders will be replaced by given lazy arguments.
static void	trace(java.lang.Throwable exception, Supplier<java.lang.String> message)	Logs an exception with a custom lazy message at TRACE level.
static void	trace(Supplier<?> message)	Logs a lazy message at TRACE level.
static void	warn(java.lang.Object message)	Logs a message at WARN level.
static void	warn(java.lang.String message, java.lang.Object... arguments)	Logs a formatted message at WARN level. "{}" placeholders will be replaced by given arguments.
static void	warn(java.lang.String message, Supplier<?>... arguments)	Logs a formatted message at WARN level. "{}" placeholders will be replaced by given lazy arguments.
static void	warn(java.lang.Throwable exception)	Logs an exception at WARN level.
static void	warn(java.lang.Throwable exception, java.lang.String message)	Logs an exception with a custom message at WARN level.
static void	warn(java.lang.Throwable exception, java.lang.String message, java.lang.Object... arguments)	Logs an exception with a formatted custom message at WARN level. "{}" placeholders will be replaced by given arguments.
static void	warn(java.lang.Throwable exception, java.lang.String message, Supplier<?>... arguments)	Logs an exception with a formatted message at WARN level. "{}" placeholders will be replaced by given lazy arguments.
static void	warn(java.lang.Throwable exception, Supplier<java.lang.String> message)	Logs an exception with a custom lazy message at WARN level.
static void	warn(Supplier<?> message)	Logs a lazy message at WARN level.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

tag

public static TaggedLogger tag(java.lang.String tag)

Gets a tagged logger instance. Tags are case-sensitive.

Parameters:

tag - Tag for logger or null for receiving an untagged logger

Returns:

Logger instance

isTraceEnabled

public static boolean isTraceEnabled()

Checks whether log entries at TRACE level will be output.

Returns:

true if TRACE level is enabled, false if disabled

trace

public static void trace(java.lang.Object message)

Logs a message at TRACE level.

Parameters:

message - String or any other object with a meaningful Object.toString() method

trace

public static void trace(Supplier<?> message)

Logs a lazy message at TRACE level. The message will be only evaluated if the log entry is really output.

Parameters:

message - Function that produces the message

trace

public static void trace(java.lang.String message,
                         java.lang.Object... arguments)

Logs a formatted message at TRACE level. "{}" placeholders will be replaced by given arguments.

Parameters:

message - Formatted text message to log

arguments - Arguments for formatted text message

trace

public static void trace(java.lang.String message,
                         Supplier<?>... arguments)

Logs a formatted message at TRACE level. "{}" placeholders will be replaced by given lazy arguments. The arguments will be only evaluated if the log entry is really output.

Parameters:

message - Formatted text message to log

arguments - Functions that produce the arguments for formatted text message

trace

public static void trace(java.lang.Throwable exception)

Logs an exception at TRACE level.

Parameters:

exception - Caught exception or any other throwable to log

trace

public static void trace(java.lang.Throwable exception,
                         java.lang.String message)

Logs an exception with a custom message at TRACE level.

Parameters:

exception - Caught exception or any other throwable to log

message - Text message to log

trace

public static void trace(java.lang.Throwable exception,
                         Supplier<java.lang.String> message)

Logs an exception with a custom lazy message at TRACE level. The message will be only evaluated if the log entry is really output.

Parameters:

exception - Caught exception or any other throwable to log

message - Function that produces the message

trace

public static void trace(java.lang.Throwable exception,
                         java.lang.String message,
                         java.lang.Object... arguments)

Logs an exception with a formatted custom message at TRACE level. "{}" placeholders will be replaced by given arguments.

Parameters:

exception - Caught exception or any other throwable to log

message - Formatted text message to log

arguments - Arguments for formatted text message

trace

public static void trace(java.lang.Throwable exception,
                         java.lang.String message,
                         Supplier<?>... arguments)

Logs an exception with a formatted message at TRACE level. "{}" placeholders will be replaced by given lazy arguments. The arguments will be only evaluated if the log entry is really output.

Parameters:

exception - Caught exception or any other throwable to log

message - Formatted text message to log

arguments - Functions that produce the arguments for formatted text message

isDebugEnabled

public static boolean isDebugEnabled()

Checks whether log entries at DEBUG level will be output.

Returns:

true if DEBUG level is enabled, false if disabled

debug

public static void debug(java.lang.Object message)

Logs a message at DEBUG level.

Parameters:

message - String or any other object with a meaningful Object.toString() method

debug

public static void debug(Supplier<?> message)

Logs a lazy message at DEBUG level. The message will be only evaluated if the log entry is really output.

Parameters:

message - Function that produces the message

debug

public static void debug(java.lang.String message,
                         java.lang.Object... arguments)

Logs a formatted message at DEBUG level. "{}" placeholders will be replaced by given arguments.

Parameters:

message - Formatted text message to log

arguments - Arguments for formatted text message

debug

public static void debug(java.lang.String message,
                         Supplier<?>... arguments)

Logs a formatted message at DEBUG level. "{}" placeholders will be replaced by given lazy arguments. The arguments will be only evaluated if the log entry is really output.

Parameters:

message - Formatted text message to log

arguments - Functions that produce the arguments for formatted text message

debug

public static void debug(java.lang.Throwable exception)

Logs an exception at DEBUG level.

Parameters:

exception - Caught exception or any other throwable to log

debug

public static void debug(java.lang.Throwable exception,
                         java.lang.String message)

Logs an exception with a custom message at DEBUG level.

Parameters:

exception - Caught exception or any other throwable to log

message - Text message to log

debug

public static void debug(java.lang.Throwable exception,
                         Supplier<java.lang.String> message)

Logs an exception with a custom lazy message at DEBUG level. The message will be only evaluated if the log entry is really output.

Parameters:

exception - Caught exception or any other throwable to log

message - Function that produces the message

debug

public static void debug(java.lang.Throwable exception,
                         java.lang.String message,
                         java.lang.Object... arguments)

Logs an exception with a formatted custom message at DEBUG level. "{}" placeholders will be replaced by given arguments.

Parameters:

exception - Caught exception or any other throwable to log

message - Formatted text message to log

arguments - Arguments for formatted text message

debug

public static void debug(java.lang.Throwable exception,
                         java.lang.String message,
                         Supplier<?>... arguments)

Logs an exception with a formatted message at DEBUG level. "{}" placeholders will be replaced by given lazy arguments. The arguments will be only evaluated if the log entry is really output.

Parameters:

exception - Caught exception or any other throwable to log

message - Formatted text message to log

arguments - Functions that produce the arguments for formatted text message

isInfoEnabled

public static boolean isInfoEnabled()

Checks whether log entries at INFO level will be output.

Returns:

true if INFO level is enabled, false if disabled

info

public static void info(java.lang.Object message)

Logs a message at INFO level.

Parameters:

message - String or any other object with a meaningful Object.toString() method

info

public static void info(Supplier<?> message)

Logs a lazy message at INFO level. The message will be only evaluated if the log entry is really output.

Parameters:

message - Function that produces the message

info

public static void info(java.lang.String message,
                        java.lang.Object... arguments)

Logs a formatted message at INFO level. "{}" placeholders will be replaced by given arguments.

Parameters:

message - Formatted text message to log

arguments - Arguments for formatted text message

info

public static void info(java.lang.String message,
                        Supplier<?>... arguments)

Logs a formatted message at INFO level. "{}" placeholders will be replaced by given lazy arguments. The arguments will be only evaluated if the log entry is really output.

Parameters:

message - Formatted text message to log

arguments - Functions that produce the arguments for formatted text message

info

public static void info(java.lang.Throwable exception)

Logs an exception at INFO level.

Parameters:

exception - Caught exception or any other throwable to log

info

public static void info(java.lang.Throwable exception,
                        java.lang.String message)

Logs an exception with a custom message at INFO level.

Parameters:

exception - Caught exception or any other throwable to log

message - Text message to log

info

public static void info(java.lang.Throwable exception,
                        Supplier<java.lang.String> message)

Logs an exception with a custom lazy message at INFO level. The message will be only evaluated if the log entry is really output.

Parameters:

exception - Caught exception or any other throwable to log

message - Function that produces the message

info

public static void info(java.lang.Throwable exception,
                        java.lang.String message,
                        java.lang.Object... arguments)

Logs an exception with a formatted custom message at INFO level. "{}" placeholders will be replaced by given arguments.

Parameters:

exception - Caught exception or any other throwable to log

message - Formatted text message to log

arguments - Arguments for formatted text message

info

public static void info(java.lang.Throwable exception,
                        java.lang.String message,
                        Supplier<?>... arguments)

Logs an exception with a formatted message at INFO level. "{}" placeholders will be replaced by given lazy arguments. The arguments will be only evaluated if the log entry is really output.

Parameters:

exception - Caught exception or any other throwable to log

message - Formatted text message to log

arguments - Functions that produce the arguments for formatted text message

isWarnEnabled

public static boolean isWarnEnabled()

Checks whether log entries at WARN level will be output.

Returns:

true if WARN level is enabled, false if disabled

warn

public static void warn(java.lang.Object message)

Logs a message at WARN level.

Parameters:

message - String or any other object with a meaningful Object.toString() method

warn

public static void warn(Supplier<?> message)

Logs a lazy message at WARN level. The message will be only evaluated if the log entry is really output.

Parameters:

message - Function that produces the message

warn

public static void warn(java.lang.String message,
                        java.lang.Object... arguments)

Logs a formatted message at WARN level. "{}" placeholders will be replaced by given arguments.

Parameters:

message - Formatted text message to log

arguments - Arguments for formatted text message

warn

public static void warn(java.lang.String message,
                        Supplier<?>... arguments)

Logs a formatted message at WARN level. "{}" placeholders will be replaced by given lazy arguments. The arguments will be only evaluated if the log entry is really output.

Parameters:

message - Formatted text message to log

arguments - Functions that produce the arguments for formatted text message

warn

public static void warn(java.lang.Throwable exception)

Logs an exception at WARN level.

Parameters:

exception - Caught exception or any other throwable to log

warn

public static void warn(java.lang.Throwable exception,
                        java.lang.String message)

Logs an exception with a custom message at WARN level.

Parameters:

exception - Caught exception or any other throwable to log

message - Text message to log

warn

public static void warn(java.lang.Throwable exception,
                        Supplier<java.lang.String> message)

Logs an exception with a custom lazy message at WARN level. The message will be only evaluated if the log entry is really output.

Parameters:

exception - Caught exception or any other throwable to log

message - Function that produces the message

warn

public static void warn(java.lang.Throwable exception,
                        java.lang.String message,
                        java.lang.Object... arguments)

Logs an exception with a formatted custom message at WARN level. "{}" placeholders will be replaced by given arguments.

Parameters:

exception - Caught exception or any other throwable to log

message - Formatted text message to log

arguments - Arguments for formatted text message

warn

public static void warn(java.lang.Throwable exception,
                        java.lang.String message,
                        Supplier<?>... arguments)

Logs an exception with a formatted message at WARN level. "{}" placeholders will be replaced by given lazy arguments. The arguments will be only evaluated if the log entry is really output.

Parameters:

exception - Caught exception or any other throwable to log

message - Formatted text message to log

arguments - Functions that produce the arguments for formatted text message

isErrorEnabled

public static boolean isErrorEnabled()

Checks whether log entries at ERROR level will be output.

Returns:

true if ERROR level is enabled, false if disabled

error

public static void error(java.lang.Object message)

Logs a message at ERROR level.

Parameters:

message - String or any other object with a meaningful Object.toString() method

error

public static void error(Supplier<?> message)

Logs a lazy message at ERROR level. The message will be only evaluated if the log entry is really output.

Parameters:

message - Function that produces the message

error

public static void error(java.lang.String message,
                         java.lang.Object... arguments)

Logs a formatted message at ERROR level. "{}" placeholders will be replaced by given arguments.

Parameters:

message - Formatted text message to log

arguments - Arguments for formatted text message

error

public static void error(java.lang.String message,
                         Supplier<?>... arguments)

Logs a formatted message at ERROR level. "{}" placeholders will be replaced by given lazy arguments. The arguments will be only evaluated if the log entry is really output.

Parameters:

message - Formatted text message to log

arguments - Functions that produce the arguments for formatted text message

error

public static void error(java.lang.Throwable exception)

Logs an exception at ERROR level.

Parameters:

exception - Caught exception or any other throwable to log

error

public static void error(java.lang.Throwable exception,
                         java.lang.String message)

Logs an exception with a custom message at ERROR level.

Parameters:

exception - Caught exception or any other throwable to log

message - Text message to log

error

public static void error(java.lang.Throwable exception,
                         Supplier<java.lang.String> message)

Logs an exception with a custom lazy message at ERROR level. The message will be only evaluated if the log entry is really output.

Parameters:

exception - Caught exception or any other throwable to log

message - Function that produces the message

error

public static void error(java.lang.Throwable exception,
                         java.lang.String message,
                         java.lang.Object... arguments)

Logs an exception with a formatted custom message at ERROR level. "{}" placeholders will be replaced by given arguments.

Parameters:

exception - Caught exception or any other throwable to log

message - Formatted text message to log

arguments - Arguments for formatted text message

error

public static void error(java.lang.Throwable exception,
                         java.lang.String message,
                         Supplier<?>... arguments)

Logs an exception with a formatted message at ERROR level. "{}" placeholders will be replaced by given lazy arguments. The arguments will be only evaluated if the log entry is really output.

Parameters:

exception - Caught exception or any other throwable to log

message - Formatted text message to log

arguments - Functions that produce the arguments for formatted text message