org.modeshape.jcr.api
Interface Logger

All Known Implementing Classes:

ExtensionLogger, WebLogger

public interface Logger

A generic logger interface.

Method Summary

void	debug(String message, Object... params) Log a message at the DEBUG level according to the specified format and (optional) parameters.
void	debug(Throwable t, String message, Object... params) Log an exception (throwable) at the DEBUG level with an accompanying message.
void	error(String message, Object... params) Log a message at the ERROR level according to the specified format and (optional) parameters.
void	error(Throwable t, String message, Object... params) Log an exception (throwable) at the ERROR level with an accompanying message.
void	info(String message, Object... params) Log a message at the INFO level according to the specified format and (optional) parameters.
void	info(Throwable t, String message, Object... params) Log an exception (throwable) at the INFO level with an accompanying message.
void	trace(String message, Object... params) Log a message at the TRACE level according to the specified format and (optional) parameters.
void	trace(Throwable t, String message, Object... params) Log an exception (throwable) at the TRACE level with an accompanying message.
void	warn(String message, Object... params) Log a message at the WARNING level according to the specified format and (optional) parameters.
void	warn(Throwable t, String message, Object... params) Log an exception (throwable) at the WARNING level with an accompanying message.

Method Detail

debug

void debug(String message,
           Object... params)

Log a message at the DEBUG level according to the specified format and (optional) parameters. The message should contain a pair of empty curly braces for each of the parameter, which should be passed in the correct order. The pattern consists of zero or more keys of the form {n}, where n is an integer starting at 0. Therefore, the first parameter replaces all occurrences of "{0}", the second parameter replaces all occurrences of "{1}", etc.

If any parameter is null, the corresponding key is replaced with the string "null". Therefore, consider using an empty string when keys are to be removed altogether.

Parameters:

message - the message string

params - the parameter values that are to replace the variables in the format string

debug

void debug(Throwable t,
           String message,
           Object... params)

Log an exception (throwable) at the DEBUG level with an accompanying message. If the exception is null, then this method calls debug(String, Object...).

Parameters:

t - the exception (throwable) to log

message - the message accompanying the exception

params - the parameter values that are to replace the variables in the format string

error

void error(String message,
           Object... params)

Log a message at the ERROR level according to the specified format and (optional) parameters. The message should contain a pair of empty curly braces for each of the parameter, which should be passed in the correct order. The pattern consists of zero or more keys of the form {n}, where n is an integer starting at 0. Therefore, the first parameter replaces all occurrences of "{0}", the second parameter replaces all occurrences of "{1}", etc.

If any parameter is null, the corresponding key is replaced with the string "null". Therefore, consider using an empty string when keys are to be removed altogether.

Parameters:

message - the message string

params - the parameter values that are to replace the variables in the format string

error

void error(Throwable t,
           String message,
           Object... params)

Log an exception (throwable) at the ERROR level with an accompanying message. If the exception is null, then this method calls error(String, Object...).

Parameters:

t - the exception (throwable) to log

message - the message accompanying the exception

params - the parameter values that are to replace the variables in the format string

info

void info(String message,
          Object... params)

Log a message at the INFO level according to the specified format and (optional) parameters. The message should contain a pair of empty curly braces for each of the parameter, which should be passed in the correct order. The pattern consists of zero or more keys of the form {n}, where n is an integer starting at 0. Therefore, the first parameter replaces all occurrences of "{0}", the second parameter replaces all occurrences of "{1}", etc.

If any parameter is null, the corresponding key is replaced with the string "null". Therefore, consider using an empty string when keys are to be removed altogether.

Parameters:

message - the message string

params - the parameter values that are to replace the variables in the format string

info

void info(Throwable t,
          String message,
          Object... params)

Log an exception (throwable) at the INFO level with an accompanying message. If the exception is null, then this method calls info(String, Object...).

Parameters:

t - the exception (throwable) to log

message - the message accompanying the exception

params - the parameter values that are to replace the variables in the format string

trace

void trace(String message,
           Object... params)

Log a message at the TRACE level according to the specified format and (optional) parameters. The message should contain a pair of empty curly braces for each of the parameter, which should be passed in the correct order. The pattern consists of zero or more keys of the form {n}, where n is an integer starting at 0. Therefore, the first parameter replaces all occurrences of "{0}", the second parameter replaces all occurrences of "{1}", etc.

If any parameter is null, the corresponding key is replaced with the string "null". Therefore, consider using an empty string when keys are to be removed altogether.

Parameters:

message - the message string

params - the parameter values that are to replace the variables in the format string

trace

void trace(Throwable t,
           String message,
           Object... params)

Log an exception (throwable) at the TRACE level with an accompanying message. If the exception is null, then this method calls trace(String, Object...).

Parameters:

t - the exception (throwable) to log

message - the message accompanying the exception

params - the parameter values that are to replace the variables in the format string

warn

void warn(String message,
          Object... params)

Log a message at the WARNING level according to the specified format and (optional) parameters. The message should contain a pair of empty curly braces for each of the parameter, which should be passed in the correct order. The pattern consists of zero or more keys of the form {n}, where n is an integer starting at 0. Therefore, the first parameter replaces all occurrences of "{0}", the second parameter replaces all occurrences of "{1}", etc.

If any parameter is null, the corresponding key is replaced with the string "null". Therefore, consider using an empty string when keys are to be removed altogether.

Parameters:

message - the message string

params - the parameter values that are to replace the variables in the format string

warn

void warn(Throwable t,
          String message,
          Object... params)

Log an exception (throwable) at the WARNING level with an accompanying message. If the exception is null, then this method calls warn(String, Object...).

Parameters:

t - the exception (throwable) to log

message - the message accompanying the exception

params - the parameter values that are to replace the variables in the format string