org.slf4j

Interface Logger

public interface Logger

The org.slf4j.Logger interface is the main user entry point of SLF4J API. It is expected that logging takes place through concrete implementations of this interface.

Typical usage pattern:

 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.");
     }
   }
 }
 

Author: Ceki Gülcü

Field Summary
StringROOT_LOGGER_NAME
Case insensitive String constant used to retrieve the name of the root logger.
Method Summary
voiddebug(String msg)
Log a message at the DEBUG level.
voiddebug(String format, Object arg)
Log a message at the DEBUG level according to the specified format and argument.
voiddebug(String format, Object arg1, Object arg2)
Log a message at the DEBUG level according to the specified format and arguments.
voiddebug(String format, Object[] argArray)
Log a message at the DEBUG level according to the specified format and arguments.
voiddebug(String msg, Throwable t)
Log an exception (throwable) at the DEBUG level with an accompanying message.
voiddebug(Marker marker, String msg)
Log a message with the specific Marker at the DEBUG level.
voiddebug(Marker marker, String format, Object arg)
This method is similar to Logger method except that the marker data is also taken into consideration.
voiddebug(Marker marker, String format, Object arg1, Object arg2)
This method is similar to Logger method except that the marker data is also taken into consideration.
voiddebug(Marker marker, String format, Object[] argArray)
This method is similar to (String, Object[]) method except that the marker data is also taken into consideration.
voiddebug(Marker marker, String msg, Throwable t)
This method is similar to Logger method except that the marker data is also taken into consideration.
voiderror(String msg)
Log a message at the ERROR level.
voiderror(String format, Object arg)
Log a message at the ERROR level according to the specified format and argument.
voiderror(String format, Object arg1, Object arg2)
Log a message at the ERROR level according to the specified format and arguments.
voiderror(String format, Object[] argArray)
Log a message at the ERROR level according to the specified format and arguments.
voiderror(String msg, Throwable t)
Log an exception (throwable) at the ERROR level with an accompanying message.
voiderror(Marker marker, String msg)
Log a message with the specific Marker at the ERROR level.
voiderror(Marker marker, String format, Object arg)
This method is similar to Logger method except that the marker data is also taken into consideration.
voiderror(Marker marker, String format, Object arg1, Object arg2)
This method is similar to Logger method except that the marker data is also taken into consideration.
voiderror(Marker marker, String format, Object[] argArray)
This method is similar to (String, Object[]) method except that the marker data is also taken into consideration.
voiderror(Marker marker, String msg, Throwable t)
This method is similar to Logger method except that the marker data is also taken into consideration.
StringgetName()
Return the name of this Logger instance.
voidinfo(String msg)
Log a message at the INFO level.
voidinfo(String format, Object arg)
Log a message at the INFO level according to the specified format and argument.
voidinfo(String format, Object arg1, Object arg2)
Log a message at the INFO level according to the specified format and arguments.
voidinfo(String format, Object[] argArray)
Log a message at the INFO level according to the specified format and arguments.
voidinfo(String msg, Throwable t)
Log an exception (throwable) at the INFO level with an accompanying message.
voidinfo(Marker marker, String msg)
Log a message with the specific Marker at the INFO level.
voidinfo(Marker marker, String format, Object arg)
This method is similar to Logger method except that the marker data is also taken into consideration.
voidinfo(Marker marker, String format, Object arg1, Object arg2)
This method is similar to Logger method except that the marker data is also taken into consideration.
voidinfo(Marker marker, String format, Object[] argArray)
This method is similar to (String, Object[]) method except that the marker data is also taken into consideration.
voidinfo(Marker marker, String msg, Throwable t)
This method is similar to Logger method except that the marker data is also taken into consideration.
booleanisDebugEnabled()
Is the logger instance enabled for the DEBUG level?
booleanisDebugEnabled(Marker marker)
Similar to isDebugEnabled method except that the marker data is also taken into account.
booleanisErrorEnabled()
Is the logger instance enabled for the ERROR level?
booleanisErrorEnabled(Marker marker)
Similar to isErrorEnabled method except that the marker data is also taken into consideration.
booleanisInfoEnabled()
Is the logger instance enabled for the INFO level?
booleanisInfoEnabled(Marker marker)
Similar to isInfoEnabled method except that the marker data is also taken into consideration.
booleanisTraceEnabled()
Is the logger instance enabled for the TRACE level?
booleanisTraceEnabled(Marker marker)
Similar to isTraceEnabled method except that the marker data is also taken into account.
booleanisWarnEnabled()
Is the logger instance enabled for the WARN level?
booleanisWarnEnabled(Marker marker)
Similar to isWarnEnabled method except that the marker data is also taken into consideration.
voidtrace(String msg)
Log a message at the TRACE level.
voidtrace(String format, Object arg)
Log a message at the TRACE level according to the specified format and argument.
voidtrace(String format, Object arg1, Object arg2)
Log a message at the TRACE level according to the specified format and arguments.
voidtrace(String format, Object[] argArray)
Log a message at the TRACE level according to the specified format and arguments.
voidtrace(String msg, Throwable t)
Log an exception (throwable) at the TRACE level with an accompanying message.
voidtrace(Marker marker, String msg)
Log a message with the specific Marker at the TRACE level.
voidtrace(Marker marker, String format, Object arg)
This method is similar to Logger method except that the marker data is also taken into consideration.
voidtrace(Marker marker, String format, Object arg1, Object arg2)
This method is similar to Logger method except that the marker data is also taken into consideration.
voidtrace(Marker marker, String format, Object[] argArray)
This method is similar to (String, Object[]) method except that the marker data is also taken into consideration.
voidtrace(Marker marker, String msg, Throwable t)
This method is similar to Logger method except that the marker data is also taken into consideration.
voidwarn(String msg)
Log a message at the WARN level.
voidwarn(String format, Object arg)
Log a message at the WARN level according to the specified format and argument.
voidwarn(String format, Object[] argArray)
Log a message at the WARN level according to the specified format and arguments.
voidwarn(String format, Object arg1, Object arg2)
Log a message at the WARN level according to the specified format and arguments.
voidwarn(String msg, Throwable t)
Log an exception (throwable) at the WARN level with an accompanying message.
voidwarn(Marker marker, String msg)
Log a message with the specific Marker at the WARN level.
voidwarn(Marker marker, String format, Object arg)
This method is similar to Logger method except that the marker data is also taken into consideration.
voidwarn(Marker marker, String format, Object arg1, Object arg2)
This method is similar to Logger method except that the marker data is also taken into consideration.
voidwarn(Marker marker, String format, Object[] argArray)
This method is similar to (String, Object[]) method except that the marker data is also taken into consideration.
voidwarn(Marker marker, String msg, Throwable t)
This method is similar to Logger method except that the marker data is also taken into consideration.

Field Detail

ROOT_LOGGER_NAME

public final String ROOT_LOGGER_NAME
Case insensitive String constant used to retrieve the name of the root logger.

Since: 1.3

Method Detail

debug

public void debug(String msg)
Log a message at the DEBUG level.

Parameters: msg the message string to be logged

debug

public void debug(String format, Object arg)
Log a message at the DEBUG level according to the specified format and argument.

This form avoids superfluous object creation when the logger is disabled for the DEBUG level.

Parameters: format the format string arg the argument

debug

public void debug(String format, Object arg1, Object arg2)
Log a message at the DEBUG level according to the specified format and arguments.

This form avoids superfluous object creation when the logger is disabled for the DEBUG level.

Parameters: format the format string arg1 the first argument arg2 the second argument

debug

public void debug(String format, Object[] argArray)
Log a message at the DEBUG level according to the specified format and arguments.

This form avoids superfluous object creation when the logger is disabled for the DEBUG level.

Parameters: format the format string argArray an array of arguments

debug

public void debug(String msg, Throwable t)
Log an exception (throwable) at the DEBUG level with an accompanying message.

Parameters: msg the message accompanying the exception t the exception (throwable) to log

debug

public void debug(Marker marker, String msg)
Log a message with the specific Marker at the DEBUG level.

Parameters: marker the marker data specific to this log statement msg the message string to be logged

debug

public void debug(Marker marker, String format, Object arg)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string arg the argument

debug

public void debug(Marker marker, String format, Object arg1, Object arg2)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string arg1 the first argument arg2 the second argument

debug

public void debug(Marker marker, String format, Object[] argArray)
This method is similar to (String, Object[]) method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string argArray an array of arguments

debug

public void debug(Marker marker, String msg, Throwable t)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement msg the message accompanying the exception t the exception (throwable) to log

error

public void error(String msg)
Log a message at the ERROR level.

Parameters: msg the message string to be logged

error

public void error(String format, Object arg)
Log a message at the ERROR level according to the specified format and argument.

This form avoids superfluous object creation when the logger is disabled for the ERROR level.

Parameters: format the format string arg the argument

error

public void error(String format, Object arg1, Object arg2)
Log a message at the ERROR level according to the specified format and arguments.

This form avoids superfluous object creation when the logger is disabled for the ERROR level.

Parameters: format the format string arg1 the first argument arg2 the second argument

error

public void error(String format, Object[] argArray)
Log a message at the ERROR level according to the specified format and arguments.

This form avoids superfluous object creation when the logger is disabled for the ERROR level.

Parameters: format the format string argArray an array of arguments

error

public void error(String msg, Throwable t)
Log an exception (throwable) at the ERROR level with an accompanying message.

Parameters: msg the message accompanying the exception t the exception (throwable) to log

error

public void error(Marker marker, String msg)
Log a message with the specific Marker at the ERROR level.

Parameters: marker The marker specific to this log statement msg the message string to be logged

error

public void error(Marker marker, String format, Object arg)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string arg the argument

error

public void error(Marker marker, String format, Object arg1, Object arg2)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string arg1 the first argument arg2 the second argument

error

public void error(Marker marker, String format, Object[] argArray)
This method is similar to (String, Object[]) method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string argArray an array of arguments

error

public void error(Marker marker, String msg, Throwable t)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement msg the message accompanying the exception t the exception (throwable) to log

getName

public String getName()
Return the name of this Logger instance.

info

public void info(String msg)
Log a message at the INFO level.

Parameters: msg the message string to be logged

info

public void info(String format, Object arg)
Log a message at the INFO level according to the specified format and argument.

This form avoids superfluous object creation when the logger is disabled for the INFO level.

Parameters: format the format string arg the argument

info

public void info(String format, Object arg1, Object arg2)
Log a message at the INFO level according to the specified format and arguments.

This form avoids superfluous object creation when the logger is disabled for the INFO level.

Parameters: format the format string arg1 the first argument arg2 the second argument

info

public void info(String format, Object[] argArray)
Log a message at the INFO level according to the specified format and arguments.

This form avoids superfluous object creation when the logger is disabled for the INFO level.

Parameters: format the format string argArray an array of arguments

info

public void info(String msg, Throwable t)
Log an exception (throwable) at the INFO level with an accompanying message.

Parameters: msg the message accompanying the exception t the exception (throwable) to log

info

public void info(Marker marker, String msg)
Log a message with the specific Marker at the INFO level.

Parameters: marker The marker specific to this log statement msg the message string to be logged

info

public void info(Marker marker, String format, Object arg)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string arg the argument

info

public void info(Marker marker, String format, Object arg1, Object arg2)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string arg1 the first argument arg2 the second argument

info

public void info(Marker marker, String format, Object[] argArray)
This method is similar to (String, Object[]) method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string argArray an array of arguments

info

public void info(Marker marker, String msg, Throwable t)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data for this log statement msg the message accompanying the exception t the exception (throwable) to log

isDebugEnabled

public boolean isDebugEnabled()
Is the logger instance enabled for the DEBUG level?

Returns: True if this Logger is enabled for the DEBUG level, false otherwise.

isDebugEnabled

public boolean isDebugEnabled(Marker marker)
Similar to isDebugEnabled method except that the marker data is also taken into account.

Parameters: marker The marker data to take into consideration

isErrorEnabled

public boolean isErrorEnabled()
Is the logger instance enabled for the ERROR level?

Returns: True if this Logger is enabled for the ERROR level, false otherwise.

isErrorEnabled

public boolean isErrorEnabled(Marker marker)
Similar to isErrorEnabled method except that the marker data is also taken into consideration.

Parameters: marker The marker data to take into consideration

isInfoEnabled

public boolean isInfoEnabled()
Is the logger instance enabled for the INFO level?

Returns: True if this Logger is enabled for the INFO level, false otherwise.

isInfoEnabled

public boolean isInfoEnabled(Marker marker)
Similar to isInfoEnabled method except that the marker data is also taken into consideration.

Parameters: marker The marker data to take into consideration

isTraceEnabled

public boolean isTraceEnabled()
Is the logger instance enabled for the TRACE level?

Returns: True if this Logger is enabled for the TRACE level, false otherwise.

Since: 1.4

isTraceEnabled

public boolean isTraceEnabled(Marker marker)
Similar to isTraceEnabled method except that the marker data is also taken into account.

Parameters: marker The marker data to take into consideration

Since: 1.4

isWarnEnabled

public boolean isWarnEnabled()
Is the logger instance enabled for the WARN level?

Returns: True if this Logger is enabled for the WARN level, false otherwise.

isWarnEnabled

public boolean isWarnEnabled(Marker marker)
Similar to isWarnEnabled method except that the marker data is also taken into consideration.

Parameters: marker The marker data to take into consideration

trace

public void trace(String msg)
Log a message at the TRACE level.

Parameters: msg the message string to be logged

Since: 1.4

trace

public void trace(String format, Object arg)
Log a message at the TRACE level according to the specified format and argument.

This form avoids superfluous object creation when the logger is disabled for the TRACE level.

Parameters: format the format string arg the argument

Since: 1.4

trace

public void trace(String format, Object arg1, Object arg2)
Log a message at the TRACE level according to the specified format and arguments.

This form avoids superfluous object creation when the logger is disabled for the TRACE level.

Parameters: format the format string arg1 the first argument arg2 the second argument

Since: 1.4

trace

public void trace(String format, Object[] argArray)
Log a message at the TRACE level according to the specified format and arguments.

This form avoids superfluous object creation when the logger is disabled for the TRACE level.

Parameters: format the format string argArray an array of arguments

Since: 1.4

trace

public void trace(String msg, Throwable t)
Log an exception (throwable) at the TRACE level with an accompanying message.

Parameters: msg the message accompanying the exception t the exception (throwable) to log

Since: 1.4

trace

public void trace(Marker marker, String msg)
Log a message with the specific Marker at the TRACE level.

Parameters: marker the marker data specific to this log statement msg the message string to be logged

Since: 1.4

trace

public void trace(Marker marker, String format, Object arg)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string arg the argument

Since: 1.4

trace

public void trace(Marker marker, String format, Object arg1, Object arg2)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string arg1 the first argument arg2 the second argument

Since: 1.4

trace

public void trace(Marker marker, String format, Object[] argArray)
This method is similar to (String, Object[]) method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string argArray an array of arguments

Since: 1.4

trace

public void trace(Marker marker, String msg, Throwable t)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement msg the message accompanying the exception t the exception (throwable) to log

Since: 1.4

warn

public void warn(String msg)
Log a message at the WARN level.

Parameters: msg the message string to be logged

warn

public void warn(String format, Object arg)
Log a message at the WARN level according to the specified format and argument.

This form avoids superfluous object creation when the logger is disabled for the WARN level.

Parameters: format the format string arg the argument

warn

public void warn(String format, Object[] argArray)
Log a message at the WARN level according to the specified format and arguments.

This form avoids superfluous object creation when the logger is disabled for the WARN level.

Parameters: format the format string argArray an array of arguments

warn

public void warn(String format, Object arg1, Object arg2)
Log a message at the WARN level according to the specified format and arguments.

This form avoids superfluous object creation when the logger is disabled for the WARN level.

Parameters: format the format string arg1 the first argument arg2 the second argument

warn

public void warn(String msg, Throwable t)
Log an exception (throwable) at the WARN level with an accompanying message.

Parameters: msg the message accompanying the exception t the exception (throwable) to log

warn

public void warn(Marker marker, String msg)
Log a message with the specific Marker at the WARN level.

Parameters: marker The marker specific to this log statement msg the message string to be logged

warn

public void warn(Marker marker, String format, Object arg)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string arg the argument

warn

public void warn(Marker marker, String format, Object arg1, Object arg2)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string arg1 the first argument arg2 the second argument

warn

public void warn(Marker marker, String format, Object[] argArray)
This method is similar to (String, Object[]) method except that the marker data is also taken into consideration.

Parameters: marker the marker data specific to this log statement format the format string argArray an array of arguments

warn

public void warn(Marker marker, String msg, Throwable t)
This method is similar to Logger method except that the marker data is also taken into consideration.

Parameters: marker the marker data for this log statement msg the message accompanying the exception t the exception (throwable) to log

Copyright © 2005-2009 QOS.ch. All Rights Reserved.