public class Logger
extends java.lang.Object
Logger.info("Hello!");Example, logging with a custom logger:
Logger.of("my.logger").info("Hello!")Each of the logging methods is overloaded to be able to take an array of arguments. These are formatted into the message String, replacing occurrences of '{}'. For example:
Logger.info("A {} request was received at {}", request.method(), request.uri());This might print out:
A POST request was received at /api/itemsThis saves on the cost of String construction when logging is turned off. This API is intended as a simple logging API to meet 99% percent of the most common logging needs with minimal code overhead. For more complex needs, the underlying() methods may be used to get the underlying SLF4J logger, or SLF4J may be used directly.
Modifier and Type | Class and Description |
---|---|
static class |
Logger.ALogger
Typical logger interface
|
Constructor and Description |
---|
Logger() |
Modifier and Type | Method and Description |
---|---|
static void |
debug(java.lang.String message)
Log a message with the DEBUG level.
|
static void |
debug(java.lang.String message,
java.lang.Object... args)
Log a message with the DEBUG level.
|
static void |
debug(java.lang.String message,
java.lang.Throwable error)
Log a message with the DEBUG level.
|
static void |
error(java.lang.String message)
Log a message with the ERROR level.
|
static void |
error(java.lang.String message,
java.lang.Object... args)
Log a message with the ERROR level.
|
static void |
error(java.lang.String message,
java.lang.Throwable error)
Log a message with the ERROR level.
|
static void |
info(java.lang.String message)
Log a message with the INFO level.
|
static void |
info(java.lang.String message,
java.lang.Object... args)
Log a message with the INFO level.
|
static void |
info(java.lang.String message,
java.lang.Throwable error)
Log a message with the INFO level.
|
static boolean |
isDebugEnabled()
Returns
true if the logger instance enabled for the DEBUG level? |
static boolean |
isErrorEnabled()
Returns
true if the logger instance enabled for the ERROR level? |
static boolean |
isInfoEnabled()
Returns
true if the logger instance enabled for the INFO level? |
static boolean |
isTraceEnabled()
Returns
true if the logger instance enabled for the TRACE level? |
static boolean |
isWarnEnabled()
Returns
true if the logger instance enabled for the WARN level? |
static Logger.ALogger |
of(java.lang.Class<?> clazz)
Obtain a logger instance.
|
static Logger.ALogger |
of(java.lang.String name)
Obtain a logger instance.
|
static void |
trace(java.lang.String message)
Log a message with the TRACE level.
|
static void |
trace(java.lang.String message,
java.lang.Object... args)
Log a message with the TRACE level.
|
static void |
trace(java.lang.String message,
java.lang.Throwable error)
Log a message with the TRACE level.
|
static org.slf4j.Logger |
underlying()
Get the underlying application SLF4J logger.
|
static void |
warn(java.lang.String message)
Log a message with the WARN level.
|
static void |
warn(java.lang.String message,
java.lang.Object... args)
Log a message with the WARN level.
|
static void |
warn(java.lang.String message,
java.lang.Throwable error)
Log a message with the WARN level.
|
public static Logger.ALogger of(java.lang.String name)
name
- name of the loggerpublic static Logger.ALogger of(java.lang.Class<?> clazz)
clazz
- a class whose name will be used as logger namepublic static org.slf4j.Logger underlying()
public static boolean isTraceEnabled()
true
if the logger instance enabled for the TRACE level?public static boolean isDebugEnabled()
true
if the logger instance enabled for the DEBUG level?public static boolean isInfoEnabled()
true
if the logger instance enabled for the INFO level?public static boolean isWarnEnabled()
true
if the logger instance enabled for the WARN level?public static boolean isErrorEnabled()
true
if the logger instance enabled for the ERROR level?public static void trace(java.lang.String message)
message
- message to logpublic static void trace(java.lang.String message, java.lang.Object... args)
message
- message to logargs
- The arguments to apply to the message Stringpublic static void trace(java.lang.String message, java.lang.Throwable error)
message
- message to logerror
- associated exceptionpublic static void debug(java.lang.String message)
message
- message to logpublic static void debug(java.lang.String message, java.lang.Object... args)
message
- message to logargs
- The arguments to apply to the message Stringpublic static void debug(java.lang.String message, java.lang.Throwable error)
message
- message to logerror
- associated exceptionpublic static void info(java.lang.String message)
message
- message to logpublic static void info(java.lang.String message, java.lang.Object... args)
message
- message to logargs
- The arguments to apply to the message stringpublic static void info(java.lang.String message, java.lang.Throwable error)
message
- message to logerror
- associated exceptionpublic static void warn(java.lang.String message)
message
- message to logpublic static void warn(java.lang.String message, java.lang.Object... args)
message
- message to logargs
- The arguments to apply to the message stringpublic static void warn(java.lang.String message, java.lang.Throwable error)
message
- message to logerror
- associated exceptionpublic static void error(java.lang.String message)
message
- message to logpublic static void error(java.lang.String message, java.lang.Object... args)
message
- message to logargs
- The arguments to apply to the message stringpublic static void error(java.lang.String message, java.lang.Throwable error)
message
- message to logerror
- associated exception