de.uniba.wiai.lspi.util.logging
Class Logger

java.lang.Object
  extended by de.uniba.wiai.lspi.util.logging.Logger
All Implemented Interfaces:
java.io.Serializable
Direct Known Subclasses:
DummyLogger, Log4jLogger, SystemOutPrintlnLogger

public abstract class Logger
extends java.lang.Object
implements java.io.Serializable

This class is the abstract class to be implemented by a logger that should be used within the framework.
A reference to a logger can be obtained by getLogger(java.lang.String) or getLogger(java.lang.Class).
You can use a custom logger by extending this class and setting the system property de.uniba.wiai.lspi.util.logging.logger.class to the FQN of your logger class.
getLogger(java.lang.String) or getLogger(java.lang.Class) then try to instantiate your logger. If that fails one of the standard loggers is created. The standard logger is Log4jLogger. If log4j is not availalbe from the classpath DummyLogger is the standard logger. If you set the system property de.uniba.wiai.lspi.util.logging.off to true DummyLogger is the standard logger.
When implementing a custom logger you have to consider that the logger may be transferred over the network when classes are passed as parameters to remote methods. The custom logger must have a public constructor with String as parameter.

Version:
1.0.5
Author:
sven
See Also:
Serialized Form

Nested Class Summary
static class Logger.LogLevel
           
 
Field Summary
static java.lang.String LOGGER_CLASS_NAME_PROPERTY_NAME
          Name of property that specifies the name of the logger class to be used.
static java.lang.String LOGGING_OFF_PROPERTY_NAME
          Name of property that defines if logging is off.
 
Method Summary
abstract  void debug(java.lang.Object msg)
           
abstract  void debug(java.lang.Object msg, java.lang.Throwable t)
           
abstract  void error(java.lang.Object msg)
           
abstract  void error(java.lang.Object msg, java.lang.Throwable t)
           
abstract  void fatal(java.lang.Object msg)
           
abstract  void fatal(java.lang.Object msg, java.lang.Throwable t)
           
static Logger getLogger(java.lang.Class _class)
           
static Logger getLogger(java.lang.String name)
           
abstract  void info(java.lang.Object msg)
           
abstract  void info(java.lang.Object msg, java.lang.Throwable t)
           
abstract  boolean isEnabledFor(Logger.LogLevel l)
           
abstract  void warn(java.lang.Object msg)
           
abstract  void warn(java.lang.Object msg, java.lang.Throwable t)
           
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

LOGGER_CLASS_NAME_PROPERTY_NAME

public static final java.lang.String LOGGER_CLASS_NAME_PROPERTY_NAME
Name of property that specifies the name of the logger class to be used.

See Also:
Constant Field Values

LOGGING_OFF_PROPERTY_NAME

public static final java.lang.String LOGGING_OFF_PROPERTY_NAME
Name of property that defines if logging is off.

See Also:
Constant Field Values
Method Detail

getLogger

public static Logger getLogger(java.lang.Class _class)
Parameters:
_class -
Returns:
The logger for the given class.

getLogger

public static Logger getLogger(java.lang.String name)
Parameters:
name -
Returns:
The logger with the given name.

isEnabledFor

public abstract boolean isEnabledFor(Logger.LogLevel l)

debug

public abstract void debug(java.lang.Object msg)
Parameters:
msg -

debug

public abstract void debug(java.lang.Object msg,
                           java.lang.Throwable t)
Parameters:
msg -
t -

info

public abstract void info(java.lang.Object msg)
Parameters:
msg -

info

public abstract void info(java.lang.Object msg,
                          java.lang.Throwable t)
Parameters:
msg -
t -

warn

public abstract void warn(java.lang.Object msg)
Parameters:
msg -

warn

public abstract void warn(java.lang.Object msg,
                          java.lang.Throwable t)
Parameters:
msg -
t -

error

public abstract void error(java.lang.Object msg)
Parameters:
msg -

error

public abstract void error(java.lang.Object msg,
                           java.lang.Throwable t)
Parameters:
msg -
t -

fatal

public abstract void fatal(java.lang.Object msg)
Parameters:
msg -

fatal

public abstract void fatal(java.lang.Object msg,
                           java.lang.Throwable t)
Parameters:
msg -
t -