public interface Logger
import org.slf4j.Logger; import org.slf4j.LoggerFactory; public class Wombat { final static Logger logger = LoggerFactory.getLogger(Wombat.class); Integer t; Integer oldT; public void setTemperature(Integer temperature) { oldT = t; t = temperature; logger.debug("Temperature set to {}. Old temperature was {}.", t, oldT); if(temperature.intValue() > 50) { logger.info("Temperature has risen above 50 degrees."); } } }Be sure to read the FAQ entry relating to parameterized logging. Note that logging statements can be parameterized in presence of an exception/throwable.
Once you are comfortable using loggers, i.e. instances of this interface, consider using MDC as well as Markers.
Modifier and Type | Field and Description |
---|---|
static String |
ROOT_LOGGER_NAME
Case insensitive String constant used to retrieve the name of the root logger.
|
Modifier and Type | Method and Description |
---|---|
void |
debug(Marker marker,
String msg)
Log a message with the specific Marker at the DEBUG level.
|
void |
debug(Marker marker,
String format,
Object... arguments)
This method is similar to
debug(String, Object...)
method except that the marker data is also taken into
consideration. |
void |
debug(Marker marker,
String format,
Object arg)
This method is similar to
debug(String, Object) method except that the
marker data is also taken into consideration. |
void |
debug(Marker marker,
String format,
Object arg1,
Object arg2)
This method is similar to
debug(String, Object, Object)
method except that the marker data is also taken into
consideration. |
void |
debug(Marker marker,
String msg,
Throwable t)
This method is similar to
debug(String, Throwable) method except that the
marker data is also taken into consideration. |
void |
debug(String msg)
Log a message at the DEBUG level.
|
void |
debug(String format,
Object... arguments)
Log a message at the DEBUG level according to the specified format
and arguments.
|
void |
debug(String format,
Object arg)
Log a message at the DEBUG level according to the specified format
and argument.
|
void |
debug(String format,
Object arg1,
Object arg2)
Log a message at the DEBUG level according to the specified format
and arguments.
|
void |
debug(String msg,
Throwable t)
Log an exception (throwable) at the DEBUG level with an
accompanying message.
|
void |
error(Marker marker,
String msg)
Log a message with the specific Marker at the ERROR level.
|
void |
error(Marker marker,
String format,
Object... arguments)
This method is similar to
error(String, Object...)
method except that the marker data is also taken into
consideration. |
void |
error(Marker marker,
String format,
Object arg)
This method is similar to
error(String, Object) method except that the
marker data is also taken into consideration. |
void |
error(Marker marker,
String format,
Object arg1,
Object arg2)
This method is similar to
error(String, Object, Object)
method except that the marker data is also taken into
consideration. |
void |
error(Marker marker,
String msg,
Throwable t)
This method is similar to
error(String, Throwable)
method except that the marker data is also taken into
consideration. |
void |
error(String msg)
Log a message at the ERROR level.
|
void |
error(String format,
Object... arguments)
Log a message at the ERROR level according to the specified format
and arguments.
|
void |
error(String format,
Object arg)
Log a message at the ERROR level according to the specified format
and argument.
|
void |
error(String format,
Object arg1,
Object arg2)
Log a message at the ERROR level according to the specified format
and arguments.
|
void |
error(String msg,
Throwable t)
Log an exception (throwable) at the ERROR level with an
accompanying message.
|
String |
getName()
Return the name of this
Logger instance. |
void |
info(Marker marker,
String msg)
Log a message with the specific Marker at the INFO level.
|
void |
info(Marker marker,
String format,
Object... arguments)
This method is similar to
info(String, Object...)
method except that the marker data is also taken into
consideration. |
void |
info(Marker marker,
String format,
Object arg)
This method is similar to
info(String, Object) method except that the
marker data is also taken into consideration. |
void |
info(Marker marker,
String format,
Object arg1,
Object arg2)
This method is similar to
info(String, Object, Object)
method except that the marker data is also taken into
consideration. |
void |
info(Marker marker,
String msg,
Throwable t)
This method is similar to
info(String, Throwable) method
except that the marker data is also taken into consideration. |
void |
info(String msg)
Log a message at the INFO level.
|
void |
info(String format,
Object... arguments)
Log a message at the INFO level according to the specified format
and arguments.
|
void |
info(String format,
Object arg)
Log a message at the INFO level according to the specified format
and argument.
|
void |
info(String format,
Object arg1,
Object arg2)
Log a message at the INFO level according to the specified format
and arguments.
|
void |
info(String msg,
Throwable t)
Log an exception (throwable) at the INFO level with an
accompanying message.
|
boolean |
isDebugEnabled()
Is the logger instance enabled for the DEBUG level?
|
boolean |
isDebugEnabled(Marker marker)
Similar to
isDebugEnabled() method except that the
marker data is also taken into account. |
boolean |
isErrorEnabled()
Is the logger instance enabled for the ERROR level?
|
boolean |
isErrorEnabled(Marker marker)
Similar to
isErrorEnabled() method except that the
marker data is also taken into consideration. |
boolean |
isInfoEnabled()
Is the logger instance enabled for the INFO level?
|
boolean |
isInfoEnabled(Marker marker)
Similar to
isInfoEnabled() method except that the marker
data is also taken into consideration. |
boolean |
isTraceEnabled()
Is the logger instance enabled for the TRACE level?
|
boolean |
isTraceEnabled(Marker marker)
Similar to
isTraceEnabled() method except that the
marker data is also taken into account. |
boolean |
isWarnEnabled()
Is the logger instance enabled for the WARN level?
|
boolean |
isWarnEnabled(Marker marker)
Similar to
isWarnEnabled() method except that the marker
data is also taken into consideration. |
void |
trace(Marker marker,
String msg)
Log a message with the specific Marker at the TRACE level.
|
void |
trace(Marker marker,
String format,
Object... argArray)
This method is similar to
trace(String, Object...)
method except that the marker data is also taken into
consideration. |
void |
trace(Marker marker,
String format,
Object arg)
This method is similar to
trace(String, Object) method except that the
marker data is also taken into consideration. |
void |
trace(Marker marker,
String format,
Object arg1,
Object arg2)
This method is similar to
trace(String, Object, Object)
method except that the marker data is also taken into
consideration. |
void |
trace(Marker marker,
String msg,
Throwable t)
This method is similar to
trace(String, Throwable) method except that the
marker data is also taken into consideration. |
void |
trace(String msg)
Log a message at the TRACE level.
|
void |
trace(String format,
Object... arguments)
Log a message at the TRACE level according to the specified format
and arguments.
|
void |
trace(String format,
Object arg)
Log a message at the TRACE level according to the specified format
and argument.
|
void |
trace(String format,
Object arg1,
Object arg2)
Log a message at the TRACE level according to the specified format
and arguments.
|
void |
trace(String msg,
Throwable t)
Log an exception (throwable) at the TRACE level with an
accompanying message.
|
void |
warn(Marker marker,
String msg)
Log a message with the specific Marker at the WARN level.
|
void |
warn(Marker marker,
String format,
Object... arguments)
This method is similar to
warn(String, Object...)
method except that the marker data is also taken into
consideration. |
void |
warn(Marker marker,
String format,
Object arg)
This method is similar to
warn(String, Object) method except that the
marker data is also taken into consideration. |
void |
warn(Marker marker,
String format,
Object arg1,
Object arg2)
This method is similar to
warn(String, Object, Object)
method except that the marker data is also taken into
consideration. |
void |
warn(Marker marker,
String msg,
Throwable t)
This method is similar to
warn(String, Throwable) method
except that the marker data is also taken into consideration. |
void |
warn(String msg)
Log a message at the WARN level.
|
void |
warn(String format,
Object... arguments)
Log a message at the WARN level according to the specified format
and arguments.
|
void |
warn(String format,
Object arg)
Log a message at the WARN level according to the specified format
and argument.
|
void |
warn(String format,
Object arg1,
Object arg2)
Log a message at the WARN level according to the specified format
and arguments.
|
void |
warn(String msg,
Throwable t)
Log an exception (throwable) at the WARN level with an
accompanying message.
|
static final String ROOT_LOGGER_NAME
void debug(Marker marker, String msg)
marker
- the marker data specific to this log statementmsg
- the message string to be loggedvoid debug(Marker marker, String format, Object... arguments)
debug(String, Object...)
method except that the marker data is also taken into
consideration.marker
- the marker data specific to this log statementformat
- the format stringarguments
- a list of 3 or more argumentsvoid debug(Marker marker, String format, Object arg)
debug(String, Object)
method except that the
marker data is also taken into consideration.marker
- the marker data specific to this log statementformat
- the format stringarg
- the argumentvoid debug(Marker marker, String format, Object arg1, Object arg2)
debug(String, Object, Object)
method except that the marker data is also taken into
consideration.marker
- the marker data specific to this log statementformat
- the format stringarg1
- the first argumentarg2
- the second argumentvoid debug(Marker marker, String msg, Throwable t)
debug(String, Throwable)
method except that the
marker data is also taken into consideration.marker
- the marker data specific to this log statementmsg
- the message accompanying the exceptiont
- the exception (throwable) to logvoid debug(String msg)
msg
- the message string to be loggedvoid debug(String format, Object... arguments)
This form avoids superfluous string concatenation when the logger
is disabled for the DEBUG level. However, this variant incurs the hidden
(and relatively small) cost of creating an Object[]
before invoking the method,
even if this logger is disabled for DEBUG. The variants taking
one
and two
arguments exist solely in order to avoid this hidden cost.
format
- the format stringarguments
- a list of 3 or more argumentsvoid debug(String format, Object arg)
This form avoids superfluous object creation when the logger is disabled for the DEBUG level.
format
- the format stringarg
- the argumentvoid debug(String format, Object arg1, Object arg2)
This form avoids superfluous object creation when the logger is disabled for the DEBUG level.
format
- the format stringarg1
- the first argumentarg2
- the second argumentvoid debug(String msg, Throwable t)
msg
- the message accompanying the exceptiont
- the exception (throwable) to logvoid error(Marker marker, String msg)
marker
- The marker specific to this log statementmsg
- the message string to be loggedvoid error(Marker marker, String format, Object... arguments)
error(String, Object...)
method except that the marker data is also taken into
consideration.marker
- the marker data specific to this log statementformat
- the format stringarguments
- a list of 3 or more argumentsvoid error(Marker marker, String format, Object arg)
error(String, Object)
method except that the
marker data is also taken into consideration.marker
- the marker data specific to this log statementformat
- the format stringarg
- the argumentvoid error(Marker marker, String format, Object arg1, Object arg2)
error(String, Object, Object)
method except that the marker data is also taken into
consideration.marker
- the marker data specific to this log statementformat
- the format stringarg1
- the first argumentarg2
- the second argumentvoid error(Marker marker, String msg, Throwable t)
error(String, Throwable)
method except that the marker data is also taken into
consideration.marker
- the marker data specific to this log statementmsg
- the message accompanying the exceptiont
- the exception (throwable) to logvoid error(String msg)
msg
- the message string to be loggedvoid error(String format, Object... arguments)
This form avoids superfluous string concatenation when the logger
is disabled for the ERROR level. However, this variant incurs the hidden
(and relatively small) cost of creating an Object[]
before invoking the method,
even if this logger is disabled for ERROR. The variants taking
one
and two
arguments exist solely in order to avoid this hidden cost.
format
- the format stringarguments
- a list of 3 or more argumentsvoid error(String format, Object arg)
This form avoids superfluous object creation when the logger is disabled for the ERROR level.
format
- the format stringarg
- the argumentvoid error(String format, Object arg1, Object arg2)
This form avoids superfluous object creation when the logger is disabled for the ERROR level.
format
- the format stringarg1
- the first argumentarg2
- the second argumentvoid error(String msg, Throwable t)
msg
- the message accompanying the exceptiont
- the exception (throwable) to logString getName()
Logger
instance.void info(Marker marker, String msg)
marker
- The marker specific to this log statementmsg
- the message string to be loggedvoid info(Marker marker, String format, Object... arguments)
info(String, Object...)
method except that the marker data is also taken into
consideration.marker
- the marker data specific to this log statementformat
- the format stringarguments
- a list of 3 or more argumentsvoid info(Marker marker, String format, Object arg)
info(String, Object)
method except that the
marker data is also taken into consideration.marker
- the marker data specific to this log statementformat
- the format stringarg
- the argumentvoid info(Marker marker, String format, Object arg1, Object arg2)
info(String, Object, Object)
method except that the marker data is also taken into
consideration.marker
- the marker data specific to this log statementformat
- the format stringarg1
- the first argumentarg2
- the second argumentvoid info(Marker marker, String msg, Throwable t)
info(String, Throwable)
method
except that the marker data is also taken into consideration.marker
- the marker data for this log statementmsg
- the message accompanying the exceptiont
- the exception (throwable) to logvoid info(String msg)
msg
- the message string to be loggedvoid info(String format, Object... arguments)
This form avoids superfluous string concatenation when the logger
is disabled for the INFO level. However, this variant incurs the hidden
(and relatively small) cost of creating an Object[]
before invoking the method,
even if this logger is disabled for INFO. The variants taking
one
and two
arguments exist solely in order to avoid this hidden cost.
format
- the format stringarguments
- a list of 3 or more argumentsvoid info(String format, Object arg)
This form avoids superfluous object creation when the logger is disabled for the INFO level.
format
- the format stringarg
- the argumentvoid info(String format, Object arg1, Object arg2)
This form avoids superfluous object creation when the logger is disabled for the INFO level.
format
- the format stringarg1
- the first argumentarg2
- the second argumentvoid info(String msg, Throwable t)
msg
- the message accompanying the exceptiont
- the exception (throwable) to logboolean isDebugEnabled()
boolean isDebugEnabled(Marker marker)
isDebugEnabled()
method except that the
marker data is also taken into account.marker
- The marker data to take into considerationboolean isErrorEnabled()
boolean isErrorEnabled(Marker marker)
isErrorEnabled()
method except that the
marker data is also taken into consideration.marker
- The marker data to take into considerationboolean isInfoEnabled()
boolean isInfoEnabled(Marker marker)
isInfoEnabled()
method except that the marker
data is also taken into consideration.marker
- The marker data to take into considerationboolean isTraceEnabled()
boolean isTraceEnabled(Marker marker)
isTraceEnabled()
method except that the
marker data is also taken into account.marker
- The marker data to take into considerationboolean isWarnEnabled()
boolean isWarnEnabled(Marker marker)
isWarnEnabled()
method except that the marker
data is also taken into consideration.marker
- The marker data to take into considerationvoid trace(Marker marker, String msg)
marker
- the marker data specific to this log statementmsg
- the message string to be loggedvoid trace(Marker marker, String format, Object... argArray)
trace(String, Object...)
method except that the marker data is also taken into
consideration.marker
- the marker data specific to this log statementformat
- the format stringargArray
- an array of argumentsvoid trace(Marker marker, String format, Object arg)
trace(String, Object)
method except that the
marker data is also taken into consideration.marker
- the marker data specific to this log statementformat
- the format stringarg
- the argumentvoid trace(Marker marker, String format, Object arg1, Object arg2)
trace(String, Object, Object)
method except that the marker data is also taken into
consideration.marker
- the marker data specific to this log statementformat
- the format stringarg1
- the first argumentarg2
- the second argumentvoid trace(Marker marker, String msg, Throwable t)
trace(String, Throwable)
method except that the
marker data is also taken into consideration.marker
- the marker data specific to this log statementmsg
- the message accompanying the exceptiont
- the exception (throwable) to logvoid trace(String msg)
msg
- the message string to be loggedvoid trace(String format, Object... arguments)
This form avoids superfluous string concatenation when the logger
is disabled for the TRACE level. However, this variant incurs the hidden
(and relatively small) cost of creating an Object[]
before invoking the method,
even if this logger is disabled for TRACE. The variants taking one
and
two
arguments exist solely in order to avoid this hidden cost.
format
- the format stringarguments
- a list of 3 or more argumentsvoid trace(String format, Object arg)
This form avoids superfluous object creation when the logger is disabled for the TRACE level.
format
- the format stringarg
- the argumentvoid trace(String format, Object arg1, Object arg2)
This form avoids superfluous object creation when the logger is disabled for the TRACE level.
format
- the format stringarg1
- the first argumentarg2
- the second argumentvoid trace(String msg, Throwable t)
msg
- the message accompanying the exceptiont
- the exception (throwable) to logvoid warn(Marker marker, String msg)
marker
- The marker specific to this log statementmsg
- the message string to be loggedvoid warn(Marker marker, String format, Object... arguments)
warn(String, Object...)
method except that the marker data is also taken into
consideration.marker
- the marker data specific to this log statementformat
- the format stringarguments
- a list of 3 or more argumentsvoid warn(Marker marker, String format, Object arg)
warn(String, Object)
method except that the
marker data is also taken into consideration.marker
- the marker data specific to this log statementformat
- the format stringarg
- the argumentvoid warn(Marker marker, String format, Object arg1, Object arg2)
warn(String, Object, Object)
method except that the marker data is also taken into
consideration.marker
- the marker data specific to this log statementformat
- the format stringarg1
- the first argumentarg2
- the second argumentvoid warn(Marker marker, String msg, Throwable t)
warn(String, Throwable)
method
except that the marker data is also taken into consideration.marker
- the marker data for this log statementmsg
- the message accompanying the exceptiont
- the exception (throwable) to logvoid warn(String msg)
msg
- the message string to be loggedvoid warn(String format, Object... arguments)
This form avoids superfluous string concatenation when the logger
is disabled for the WARN level. However, this variant incurs the hidden
(and relatively small) cost of creating an Object[]
before invoking the method,
even if this logger is disabled for WARN. The variants taking
one
and two
arguments exist solely in order to avoid this hidden cost.
format
- the format stringarguments
- a list of 3 or more argumentsvoid warn(String format, Object arg)
This form avoids superfluous object creation when the logger is disabled for the WARN level.
format
- the format stringarg
- the argumentvoid warn(String format, Object arg1, Object arg2)
This form avoids superfluous object creation when the logger is disabled for the WARN level.
format
- the format stringarg1
- the first argumentarg2
- the second argument