addTarget
public void addTarget(LogTarget target)
Adds a log target to this facility. Log targets get informed, via the LogTarget interface,
whenever a message is logged with this class.
createContext
public static LogContext createContext(Class context)
Creates a log context.
context
- the class (null
not permitted).
createContext
public static LogContext createContext(String context)
Creates a log context.
context
- the label for the context.
debug
public static void debug(Object message)
A convenience method for logging a 'debug' message.
debug
public static void debug(Object message,
Exception e)
A convenience method for logging a 'debug' message.
message
- the message.e
- the exception.
defineLog
protected static void defineLog(Log log)
Redefines or clears the currently used log instance.
log
- the new log instance or null, to return to the default implementation.
doLog
protected void doLog(int level,
Object message)
Logs a message to the main log stream. All attached log targets will also
receive this message. If the given log-level is higher than the given debug-level
in the main config file, no logging will be done.
level
- log level of the message.message
- text to be logged.
doLog
protected void doLog(int level,
Object message,
Exception e)
Logs a message to the main log stream. All attached logTargets will also
receive this message. If the given log-level is higher than the given debug-level
in the main config file, no logging will be done.
The exception's stacktrace will be appended to the log-stream
level
- log level of the message.message
- text to be logged.e
- the exception, which should be logged.
error
public static void error(Object message)
A convenience method for logging an 'error' message.
error
public static void error(Object message,
Exception e)
A convenience method for logging an 'error' message.
message
- the message.e
- the exception.
getDebuglevel
public int getDebuglevel()
Returns the currently defined debug level. The higher the level, the more details
are printed.
getInstance
public static Log getInstance()
Returns the singleton Log instance. A new instance is created if necessary.
info
public static void info(Object message)
A convenience method for logging an 'info' message.
info
public static void info(Object message,
Exception e)
A convenience method for logging an 'info' message.
message
- the message.e
- the exception.
init
public void init()
Initializes the logging system. Implementors should
override this method to supply their own log configuration.
internalCreateContext
protected LogContext internalCreateContext(String context)
Creates a log context.
context
- the name of the logging context (a common prefix).
isDebugEnabled
public static boolean isDebugEnabled()
Returns true, if the log level allows debug messages to be
printed.
- true, if messages with an log level of DEBUG are allowed.
isErrorEnabled
public static boolean isErrorEnabled()
Returns true, if the log level allows error messages to be
printed.
- true, if messages with an log level of ERROR are allowed.
isInfoEnabled
public static boolean isInfoEnabled()
Returns true, if the log level allows informational
messages to be printed.
- true, if messages with an log level of INFO are allowed.
isWarningEnabled
public static boolean isWarningEnabled()
Returns true, if the log level allows warning messages to be
printed.
- true, if messages with an log level of WARN are allowed.
log
public static void log(int level,
Object message)
Logs a message to the main log stream. All attached log targets will also
receive this message. If the given log-level is higher than the given debug-level
in the main config file, no logging will be done.
level
- log level of the message.message
- text to be logged.
log
public static void log(int level,
Object message,
Exception e)
Logs a message to the main log stream. All attached logTargets will also
receive this message. If the given log-level is higher than the given debug-level
in the main config file, no logging will be done.
The exception's stacktrace will be appended to the log-stream
level
- log level of the message.message
- text to be logged.e
- the exception, which should be logged.
removeTarget
public void removeTarget(LogTarget target)
Removes a log target from this facility.
target
- the target to remove.
replaceTargets
public void replaceTargets(LogTarget target)
Replaces all log targets by the given target.
target
- the new and only logtarget.
setDebuglevel
protected void setDebuglevel(int debuglevel)
Defines the debug level for the log system.
debuglevel
- the new debug level
warn
public static void warn(Object message)
A convenience method for logging a 'warning' message.
warn
public static void warn(Object message,
Exception e)
A convenience method for logging a 'warning' message.
message
- the message.e
- the exception.