de.bb.log

Class Logger

java.lang.Object

de.bb.log.Logger

public class Logger
extends java.lang.Object

A slim and fast Logger implementation.

Field Summary

Fields

Modifier and Type	Field and Description
static int	ALL log level constants.
static int	DEBUG log level constants.
static int	ERROR log level constants.
static int	FATAL log level constants.
static int	FINE log level constants.
static int	INFO log level constants.
static int	OFF log level constants.
static int	TRACE log level constants.
static int	WARN log level constants.

Constructor Summary

Constructors

Constructor and Description
Logger(java.lang.String path) Create a new Logger.

Method Summary

Methods

Modifier and Type	Method and Description
void	addAppenderFormatter(Appender a, Formatter f) Add a appender/formatter pair to the pending configuration.
void	debug(java.lang.String message, java.lang.Object... a) Log a DEBUG message.
void	error(java.lang.String message, java.lang.Object... a) Log a ERROR message.
void	fatal(java.lang.String message, java.lang.Object... a) Log a FATAL message.
void	fine(java.lang.String message, java.lang.Object... a) Log a FINE message.
static java.util.ArrayList<Logger>	getCurrentLoggers() Get all current loggers.
int	getLevel() Get the log level.
static Logger	getLogger(java.lang.Class<?> clazz) Get a Logger using a class name.
static Logger	getLogger(java.lang.String path) Get a Logger using a path.
java.lang.String	getName() Return the path/name of the logger.
static Logger	getRootLogger() Get the root logger.
void	info(java.lang.String message, java.lang.Object... a) Log a INFO message.
boolean	isDebug() Return true if at least DEBUG is enabled.
boolean	isError() Return true if at least ERROR is enabled.
boolean	isFatal() Return true if at least FATAL is enabled.
boolean	isFine() Return true if at least FINE is enabled.
boolean	isInfo() Return true if at least INFO is enabled.
boolean	isTRACE() Return true if at least TRACE is enabled.
boolean	isWarn() Return true if at least WARN is enabled.
static void	loadConfig() (re-)load the configuration.
void	log(java.lang.String level, java.lang.String message, java.lang.Object[] o) Log with the message using the provided level String and an optional Throwable.
void	setLevel(int level) Set the log level.
static int	toLevel(java.lang.String levelString) Convert the level string int the level value.
java.lang.String	toString() User friendly toString().
void	trace(java.lang.String message, java.lang.Object... o) Log a TRACE message plus a Throwable.
void	warn(java.lang.String message, java.lang.Object... a) Log a WARN message.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

OFF

public static final int OFF

log level constants. For the sake of speed use plain integers.

See Also:

Constant Field Values

FATAL

public static final int FATAL

log level constants. For the sake of speed use plain integers.

See Also:

Constant Field Values

ERROR

public static final int ERROR

log level constants. For the sake of speed use plain integers.

See Also:

Constant Field Values

WARN

public static final int WARN

log level constants. For the sake of speed use plain integers.

See Also:

Constant Field Values

INFO

public static final int INFO

log level constants. For the sake of speed use plain integers.

See Also:

Constant Field Values

DEBUG

public static final int DEBUG

log level constants. For the sake of speed use plain integers.

See Also:

Constant Field Values

FINE

public static final int FINE

log level constants. For the sake of speed use plain integers.

See Also:

Constant Field Values

TRACE

public static final int TRACE

log level constants. For the sake of speed use plain integers.

See Also:

Constant Field Values

ALL

public static final int ALL

log level constants. For the sake of speed use plain integers.

See Also:

Constant Field Values

Constructor Detail

Logger

public Logger(java.lang.String path)

Create a new Logger.

Parameters:

path - the path to locate the configuration - search towards root.

Method Detail

getName

public java.lang.String getName()

Return the path/name of the logger.

Returns:

the path/name of the logger.

log

public final void log(java.lang.String level,
       java.lang.String message,
       java.lang.Object[] o)

Log with the message using the provided level String and an optional Throwable. Usually not invoked directly.

Parameters:

level - the level String e.g. "DEBUG"

message - the log message

a - an array with objects

getLevel

public int getLevel()

Get the log level.

Returns:

the log level.

See Also:

#setLogLevel()

setLevel

public void setLevel(int level)

Set the log level.

Parameters:

level - the log level

See Also:

getLevel()

trace

public void trace(java.lang.String message,
         java.lang.Object... o)

Log a TRACE message plus a Throwable.

Parameters:

message - the message.

o - the optional parameters.

isTRACE

public boolean isTRACE()

Return true if at least TRACE is enabled.

Returns:

true if at least TRACE is enabled.

fine

public void fine(java.lang.String message,
        java.lang.Object... a)

Log a FINE message. If optional parameters a supplied the message is parsed to indexes like {0} to expand the message.

Parameters:

message - the message.

a - optional parameters

isFine

public boolean isFine()

Return true if at least FINE is enabled.

Returns:

true if at least FINE is enabled.

debug

public void debug(java.lang.String message,
         java.lang.Object... a)

Log a DEBUG message. If optional parameters a supplied the message is parsed to indexes like {0} to expand the message.

Parameters:

message - the message.

a - optional parameters

isDebug

public boolean isDebug()

Return true if at least DEBUG is enabled.

Returns:

true if at least DEBUG is enabled.

info

public void info(java.lang.String message,
        java.lang.Object... a)

Log a INFO message. If optional parameters a supplied the message is parsed to indexes like {0} to expand the message.

Parameters:

message - the message.

a - optional parameters

isInfo

public boolean isInfo()

Return true if at least INFO is enabled.

Returns:

true if at least INFO is enabled.

warn

public void warn(java.lang.String message,
        java.lang.Object... a)

Log a WARN message. If optional parameters a supplied the message is parsed to indexes like {0} to expand the message.

Parameters:

message - the message.

a - optional parameters

isWarn

public boolean isWarn()

Return true if at least WARN is enabled.

Returns:

true if at least WARN is enabled.

error

public void error(java.lang.String message,
         java.lang.Object... a)

Log a ERROR message. If optional parameters a supplied the message is parsed to indexes like {0} to expand the message.

Parameters:

message - the message.

a - optional parameters

isError

public boolean isError()

Return true if at least ERROR is enabled.

Returns:

true if at least ERROR is enabled.

fatal

public void fatal(java.lang.String message,
         java.lang.Object... a)

Log a FATAL message. If optional parameters a supplied the message is parsed to indexes like {0} to expand the message.

Parameters:

message - the message.

a - optional parameters

isFatal

public boolean isFatal()

Return true if at least FATAL is enabled.

Returns:

true if at least FATAL is enabled.

addAppenderFormatter

public final void addAppenderFormatter(Appender a,
                        Formatter f)

Add a appender/formatter pair to the pending configuration.

Parameters:

a - a Appender

f - a Formatter

toString

public java.lang.String toString()

User friendly toString().

Overrides:

toString in class java.lang.Object

getLogger

public static Logger getLogger(java.lang.Class<?> clazz)

Get a Logger using a class name.

Parameters:

clazz - a class to provide a name

Returns:

the Logger instance.

getLogger

public static Logger getLogger(java.lang.String path)

Get a Logger using a path.

Parameters:

path - the path for the logger

Returns:

the Logger instance.

loadConfig

public static void loadConfig()
                       throws java.io.IOException

(re-)load the configuration.

Throws:

java.io.IOException

toLevel

public static int toLevel(java.lang.String levelString)

Convert the level string int the level value.

Parameters:

levelString - the level string.

Returns:

the level value. If no match is found INFO is returned.

getCurrentLoggers

public static java.util.ArrayList<Logger> getCurrentLoggers()

Get all current loggers.

Returns:

An ArrayList containing all Loggers

getRootLogger

public static Logger getRootLogger()

Get the root logger.

Returns:

the root logger.