org.slf4j
Interface Logger

All Known Subinterfaces:
LocationAwareLogger
All Known Implementing Classes:
JDK14LoggerAdapter, Log4jLoggerAdapter, MarkerIgnoringBase

public interface Logger

The main user interface to logging. It is expected that logging takes place through concrete implementations of this interface.

Author:
Ceki Gülcü

Field Summary
static String ROOT_LOGGER_NAME
          Case insensitive String constant used to retrieve the name of the root logger.
 
Method Summary
 void debug(Marker marker, String msg)
          Log a message with the specific Marker at the DEBUG level.
 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[] argArray)
          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 arg)
          Log a message at the DEBUG level according to the specified format and argument.
 void debug(String format, Object[] argArray)
          Log a message at the DEBUG level according to the specified format and arguments.
 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 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[] argArray)
          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 arg)
          Log a message at the ERROR level according to the specified format and argument.
 void error(String format, Object[] argArray)
          Log a message at the ERROR level according to the specified format and arguments.
 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 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[] argArray)
          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 arg)
          Log a message at the INFO level according to the specified format and argument.
 void info(String format, Object[] argArray)
          Log a message at the INFO level according to the specified format and arguments.
 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 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[] 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 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 arg)
          Log a message at the TRACE level according to the specified format and argument.
 void trace(String format, Object[] argArray)
          Log a message at the TRACE level according to the specified format and arguments.
 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 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[] argArray)
          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 arg)
          Log a message at the WARN level according to the specified format and argument.
 void warn(String format, Object[] argArray)
          Log a message at the WARN level according to the specified format and arguments.
 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.
 

Field Detail

ROOT_LOGGER_NAME

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

Since:
1.3
See Also:
Constant Field Values
Method Detail

getName

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


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

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

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

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 trace(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
arg - the argument
Since:
1.4

trace

public 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.

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 trace(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 trace(String, Throwable) 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

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.

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

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

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 debug(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
arg - the argument

debug

public 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.

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 debug(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 debug(String, Throwable) 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

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.

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

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

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 info(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
arg - the argument

info

public 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.

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 info(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 info(String, Throwable) 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

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.

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

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

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 warn(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
arg - the argument

warn

public 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.

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 warn(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 warn(String, Throwable) 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

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.

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

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

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 error(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
arg - the argument

error

public 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.

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 error(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 error(String, Throwable) 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


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