com.noveogroup.android.log

Interface Handler

All Known Implementing Classes:

PatternHandler

public interface Handler

The log message handler.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	isEnabled(Logger.Level level) Checks if the specified log level is enabled or not for this handler.
void	print(String loggerName, Logger.Level level, Throwable throwable, String message) Prints a log message.
void	print(String loggerName, Logger.Level level, Throwable throwable, String messageFormat, Object... args) Prints a log message.

Method Detail

isEnabled

boolean isEnabled(Logger.Level level)

Checks if the specified log level is enabled or not for this handler.

Parameters:

level - the level.

Returns:

Are messages with this level allowed to be logged or not.

print

void print(String loggerName,
         Logger.Level level,
         Throwable throwable,
         String message)
           throws IllegalArgumentException

Prints a log message.

This method should automatically check using isEnabled(Logger.Level) method if the message is allowed to be logged or not.

Parameters:

loggerName - a name of a logger that user used to log message.

level - a level of the log message

throwable - a throwable object or null.

message - a log message. Can be null.

Throws:

IllegalArgumentException - if no format string is specified but arguments are presented.

print

void print(String loggerName,
         Logger.Level level,
         Throwable throwable,
         String messageFormat,
         Object... args)
           throws IllegalArgumentException

Prints a log message.

This method should automatically check using isEnabled(Logger.Level) method if the message is allowed to be logged or not.

The format string of the log message should be formatted according to rules of the standard format string described in JavaDoc of Formatter. Implementations can use Formatter.format(String, Object...) to prepare the log message from format string and array of arguments.

Parameters:

loggerName - a name of a logger that user used to log message.

level - a level of the log message

throwable - a throwable object or null.

messageFormat - a format string of the log message. Can be null.

args - an array of arguments. Can be null which is considered as an empty array.

Throws:

IllegalArgumentException - if no format string is specified but arguments are presented.