org.refcodes.logger.impls

Class RuntimeLoggerSingleton

java.lang.Object

org.refcodes.logger.impls.RuntimeLoggerSingleton

All Implemented Interfaces:

LogPriorityAccessor, MessageLogger<LogPriority>, RuntimeLogger, NameAccessor

public class RuntimeLoggerSingleton
extends Object
implements RuntimeLogger

This RuntimeLoggerSingleton provides a RuntimeLogger singleton configured by a "runtimelogger-conf.xml" file find in one of the several locations relative to your application's base directory:

The applications base directory (where your JAR or your classes reside) is taken and a list of directories relative to this base directory is generated as defined in the RuntimeConsts.CONFIG_DIR_NAMES: The actual directories being looked at (in case them exist) are as follows, relative to your applications base directory:

• ../config"
• ../etc"
• ../settings"
• ../.config"
• ../settings"
• ."
• ./config"
• ./etc"
• ./settings"
• ./.config"
• ./settings"
In case you pass a JVM argument via "-Dconfig.dir=path_to_your_config_dir" (where path_to_your_config_dir stands for the path to the directory where you placed configuration files such as the "runtimelogger-config.xml" file), then your path_to_your_config_dir is placed first in the list of configuration directories to look at (in case the directory exists).See RuntimeConsts.SYS_PROP_CONFIG_DIR

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.logger.LogPriorityAccessor

LogPriorityAccessor.LogPriorityMutator, LogPriorityAccessor.LogPriorityProperty

Nested classes/interfaces inherited from interface org.refcodes.mixin.NameAccessor

NameAccessor.NameBuilder<B extends NameAccessor.NameBuilder<B>>, NameAccessor.NameMutator, NameAccessor.NameProperty

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	RuntimeLoggerSingleton(RuntimeLogger aRuntimeLogger)

Method Summary

Modifier and Type	Method and Description
void	alert(String aMessage) Logs a log message with log priorityLogPriority.ALERT.
void	alert(String aMessage, Object... aArguments) Logs a log message with log priorityLogPriority.ALERT.
void	alert(String aMessage, Throwable aThrowable) Logs a log message with log priorityLogPriority.ALERT.
void	alert(String aMessage, Throwable aThrowable, Object... aArguments) Logs a log message with log priorityLogPriority.ALERT.
void	critical(String aMessage) Logs a log message with log priorityLogPriority.CRITICAL.
void	critical(String aMessage, Object... aArguments) Logs a log message with log priorityLogPriority.CRITICAL.
void	critical(String aMessage, Throwable aThrowable) Logs a log message with log priorityLogPriority.CRITICAL.
void	critical(String aMessage, Throwable aThrowable, Object... aArguments) Logs a log message with log priorityLogPriority.CRITICAL.
void	debug(String aMessage) Logs a log message with log priorityLogPriority.DEBUG.
void	debug(String aMessage, Object... aArguments) Logs a log message with log priorityLogPriority.DEBUG.
void	error(String aMessage) Logs a log message with log priorityLogPriority.ERROR.
void	error(String aMessage, Object... aArguments) Logs a log message with log priorityLogPriority.ERROR.
void	error(String aMessage, Throwable aThrowable) Logs a log message with log priorityLogPriority.ERROR.
void	error(String aMessage, Throwable aThrowable, Object... aArguments) Logs a log message with log priorityLogPriority.ERROR.
static RuntimeLogger	getInstance() Returns the singleton's instance as fabricated by this RuntimeLoggerSingleton.
LogPriority	getLogPriority() Retrieves the LogPriority from the LogPriorityAccessor.
String	getName()
void	info(String aMessage) Logs a log message with log priorityLogPriority.INFO.
void	info(String aMessage, Object... aArguments) Logs a log message with log priorityLogPriority.INFO.
boolean	isLog(LogPriority aPriority) Determines whether the RuntimeLogger is being configured to log messages of the according LogPriority.
boolean	isLogAlert() Determines whether the RuntimeLogger is being configured to log fatal messages (LogPriority.ALERT).
boolean	isLogCritical() Determines whether the RuntimeLogger is being configured to log fatal messages (LogPriority.CRITICAL).
boolean	isLogDebug() Determines whether the RuntimeLogger is being configured to log debug messages (LogPriority.DEBUG).
boolean	isLogError() Determines whether the RuntimeLogger is being configured to log errors (LogPriority.ERROR).
boolean	isLogInfo() Determines whether the RuntimeLogger is being configured to log infos (LogPriority.INFO).
boolean	isLogNotice() Determines whether the RuntimeLogger is being configured to log notices (LogPriority.NOTICE).
boolean	isLogPanic() Determines whether the RuntimeLogger is being configured to log fatal messages (LogPriority.PANIC).
boolean	isLogTrace() Determines whether the RuntimeLogger is being configured to log comments (LogPriority.TRACE).
boolean	isLogWarn() Determines whether the RuntimeLogger is being configured to log warnings (LogPriority.WARN).
void	log(LogPriority aMarker, String aMessage) Creates a new log message.
void	log(LogPriority aMarker, String aMessage, Object... aArguments) Creates a new log message.
void	log(LogPriority aPriority, String aMessage, Throwable aThrowable) Creates a new log message.
void	log(LogPriority aPriority, String aMessage, Throwable aThrowable, Object... aArguments) Creates a new log message.
void	notice(String aMessage) Logs a log message with log priorityLogPriority.NOTICE.
void	notice(String aMessage, Object... aArguments) Logs a log message with log priorityLogPriority.NOTICE.
void	panic(String aMessage) Logs a log message with log priorityLogPriority.PANIC.
void	panic(String aMessage, Object... aArguments) Logs a log message with log priorityLogPriority.PANIC.
void	panic(String aMessage, Throwable aThrowable) Logs a log message with log priorityLogPriority.PANIC.
void	panic(String aMessage, Throwable aThrowable, Object... aArguments) Logs a log message with log priorityLogPriority.PANIC.
void	trace(String aMessage) Logs a log message with log priorityLogPriority.TRACE.
void	trace(String aMessage, Object... aArguments) Logs a log message with log priorityLogPriority.TRACE.
void	warn(String aMessage) Logs a log message with log priorityLogPriority.WARN.
void	warn(String aMessage, Object... aArguments) Logs a log message with log priorityLogPriority.WARN.
void	warn(String aMessage, Throwable aThrowable) Logs a log message with log priorityLogPriority.WARN.
void	warn(String aMessage, Throwable aThrowable, Object... aArguments) Logs a log message with log priorityLogPriority.WARN.

Methods inherited from class java.lang.Object

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

Constructor Detail

RuntimeLoggerSingleton

protected RuntimeLoggerSingleton(RuntimeLogger aRuntimeLogger)

Method Detail

getInstance

public static RuntimeLogger getInstance()
                                 throws LoggerInstantiationRuntimeException

Returns the singleton's instance as fabricated by this RuntimeLoggerSingleton.

Returns:

The RuntimeLogger singleton's instance.

Throws:

LoggerInstantiationRuntimeException - Thrown in case instantiating a Logger (RuntimeLogger) failed

getName

public String getName()

Specified by:

getName in interface NameAccessor

getLogPriority

public LogPriority getLogPriority()

Description copied from interface: LogPriorityAccessor

Retrieves the LogPriority from the LogPriorityAccessor.

Specified by:

getLogPriority in interface LogPriorityAccessor

Returns:

The LogPriority stored by the LogPriorityAccessor .

log

public void log(LogPriority aMarker,
                String aMessage)

Description copied from interface: MessageLogger

Creates a new log message.

Specified by:

log in interface MessageLogger<LogPriority>

Parameters:

aMarker - The marker for the message.

aMessage - The message to be logged.

log

public void log(LogPriority aPriority,
                String aMessage,
                Throwable aThrowable)

Description copied from interface: RuntimeLogger

Creates a new log message.

Specified by:

log in interface RuntimeLogger

Parameters:

aPriority - The level of the message.

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

log

public void log(LogPriority aMarker,
                String aMessage,
                Object... aArguments)

Description copied from interface: MessageLogger

Creates a new log message. The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

log in interface MessageLogger<LogPriority>

Parameters:

aMarker - The marker for the message.

aMessage - The message to be logged.

aArguments - The arguments used when replacing the placeholders.

log

public void log(LogPriority aPriority,
                String aMessage,
                Throwable aThrowable,
                Object... aArguments)

Description copied from interface: RuntimeLogger

Creates a new log message. The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

log in interface RuntimeLogger

Parameters:

aPriority - The level of the message.

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

aArguments - The arguments used when replacing the placeholders.

isLog

public boolean isLog(LogPriority aPriority)

Description copied from interface: RuntimeLogger

Determines whether the RuntimeLogger is being configured to log messages of the according LogPriority. This method is useful to prevent the generation of vast amounts of log message String objects (and according processing) for the according LogPriority in case them messages of that LogPriority are not logged at all.

Specified by:

isLog in interface RuntimeLogger

Parameters:

aPriority - The LogPriority to test whether the RuntimeLogger does log messages of that LogPriority.

Returns:

True in case the RuntimeLogger does log messages of that LogPriority.

trace

public void trace(String aMessage)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.TRACE.

Specified by:

trace in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

trace

public void trace(String aMessage,
                  Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.TRACE. The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

trace in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aArguments - The arguments used when replacing the placeholders.

isLogTrace

public boolean isLogTrace()

Description copied from interface: RuntimeLogger

Determines whether the RuntimeLogger is being configured to log comments (LogPriority.TRACE). This method is useful to prevent the generation of vast amounts of log message String objects (and according processing) for the according LogPriority in case them messages of that LogPriority are not logged at all.

Specified by:

isLogTrace in interface RuntimeLogger

Returns:

True in case comments are logged.

debug

public void debug(String aMessage)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.DEBUG. "Info useful to developers for debugging the application, not useful during operations."

Specified by:

debug in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

See Also:

http://en.wikipedia.org/wiki/Syslog

debug

public void debug(String aMessage,
                  Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.DEBUG. "Info useful to developers for debugging the application, not useful during operations." The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

debug in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

isLogDebug

public boolean isLogDebug()

Description copied from interface: RuntimeLogger

Determines whether the RuntimeLogger is being configured to log debug messages (LogPriority.DEBUG). This method is useful to prevent the generation of vast amounts of log message String objects (and according processing) for the according LogPriority in case them messages of that LogPriority are not logged at all.

Specified by:

isLogDebug in interface RuntimeLogger

Returns:

True in case debug messages are logged.

info

public void info(String aMessage)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.INFO. "Additional information which might be useful for some stability period."

Specified by:

info in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

See Also:

http://en.wikipedia.org/wiki/Syslog

info

public void info(String aMessage,
                 Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.INFO. "Additional information which might be useful for some stability period." The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

info in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

isLogInfo

public boolean isLogInfo()

Description copied from interface: RuntimeLogger

Determines whether the RuntimeLogger is being configured to log infos (LogPriority.INFO). This method is useful to prevent the generation of vast amounts of log message String objects (and according processing) for the according LogPriority in case them messages of that LogPriority are not logged at all.

Specified by:

isLogInfo in interface RuntimeLogger

Returns:

True in case infos are logged.

notice

public void notice(String aMessage)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.NOTICE. "Events that are unusual but not error conditions - might be summarized in an email to developers or admins to spot potential problems - no immediate action required."

Specified by:

notice in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

See Also:

http://en.wikipedia.org/wiki/Syslog

notice

public void notice(String aMessage,
                   Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.NOTICE. "Events that are unusual but not error conditions - might be summarized in an email to developers or admins to spot potential problems - no immediate action required." The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

notice in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

isLogNotice

public boolean isLogNotice()

Description copied from interface: RuntimeLogger

Determines whether the RuntimeLogger is being configured to log notices (LogPriority.NOTICE). This method is useful to prevent the generation of vast amounts of log message String objects (and according processing) for the according LogPriority in case them messages of that LogPriority are not logged at all.

Specified by:

isLogNotice in interface RuntimeLogger

Returns:

True in case infos are logged.

warn

public void warn(String aMessage)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.WARN. "Warning messages, not an error, but indication that an error will occur if action is not taken, e.g. file system 85% full - each item must be resolved within a given time."

Specified by:

warn in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

See Also:

http://en.wikipedia.org/wiki/Syslog

warn

public void warn(String aMessage,
                 Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.WARN. "Warning messages, not an error, but indication that an error will occur if action is not taken, e.g. file system 85% full - each item must be resolved within a given time." The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

warn in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

warn

public void warn(String aMessage,
                 Throwable aThrowable)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.WARN. "Warning messages, not an error, but indication that an error will occur if action is not taken, e.g. file system 85% full - each item must be resolved within a given time."

Specified by:

warn in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

See Also:

http://en.wikipedia.org/wiki/Syslog

warn

public void warn(String aMessage,
                 Throwable aThrowable,
                 Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.WARN. "Warning messages, not an error, but indication that an error will occur if action is not taken, e.g. file system 85% full - each item must be resolved within a given time." The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

warn in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

isLogWarn

public boolean isLogWarn()

Description copied from interface: RuntimeLogger

Determines whether the RuntimeLogger is being configured to log warnings (LogPriority.WARN). This method is useful to prevent the generation of vast amounts of log message String objects (and according processing) for the according LogPriority in case them messages of that LogPriority are not logged at all.

Specified by:

isLogWarn in interface RuntimeLogger

Returns:

True in case warnings are logged.

error

public void error(String aMessage)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.ERROR. "Non-urgent failures, these should be relayed to developers or admins; each item must be resolved within a given time."

Specified by:

error in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

See Also:

http://en.wikipedia.org/wiki/Syslog

error

public void error(String aMessage,
                  Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.ERROR. "Non-urgent failures, these should be relayed to developers or admins; each item must be resolved within a given time." The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

error in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

error

public void error(String aMessage,
                  Throwable aThrowable)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.ERROR. "Non-urgent failures, these should be relayed to developers or admins; each item must be resolved within a given time."

Specified by:

error in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

See Also:

http://en.wikipedia.org/wiki/Syslog

error

public void error(String aMessage,
                  Throwable aThrowable,
                  Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.ERROR. "Non-urgent failures, these should be relayed to developers or admins; each item must be resolved within a given time." The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

error in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

isLogError

public boolean isLogError()

Description copied from interface: RuntimeLogger

Determines whether the RuntimeLogger is being configured to log errors (LogPriority.ERROR). This method is useful to prevent the generation of vast amounts of log message String objects (and according processing) for the according LogPriority in case them messages of that LogPriority are not logged at all.

Specified by:

isLogError in interface RuntimeLogger

Returns:

True in case errors are logged.

critical

public void critical(String aMessage)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.CRITICAL. "Should be corrected immediately, but indicates failure in a secondary system, an example is a loss of a backup ISP connection."

Specified by:

critical in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

See Also:

http://en.wikipedia.org/wiki/Syslog

critical

public void critical(String aMessage,
                     Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.CRITICAL. "Should be corrected immediately, but indicates failure in a secondary system, an example is a loss of a backup ISP connection." The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

critical in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

critical

public void critical(String aMessage,
                     Throwable aThrowable)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.CRITICAL. "Should be corrected immediately, but indicates failure in a secondary system, an example is a loss of a backup ISP connection."

Specified by:

critical in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

See Also:

http://en.wikipedia.org/wiki/Syslog

critical

public void critical(String aMessage,
                     Throwable aThrowable,
                     Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.CRITICAL. "Should be corrected immediately, but indicates failure in a secondary system, an example is a loss of a backup ISP connection."

Specified by:

critical in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

isLogCritical

public boolean isLogCritical()

Description copied from interface: RuntimeLogger

Determines whether the RuntimeLogger is being configured to log fatal messages (LogPriority.CRITICAL). This method is useful to prevent the generation of vast amounts of log message String objects (and according processing) for the according LogPriority in case them messages of that LogPriority are not logged at all.

Specified by:

isLogCritical in interface RuntimeLogger

Returns:

True in case fatal messages are logged.

alert

public void alert(String aMessage)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.ALERT. "Should be corrected immediately, therefore notify staff who can fix the problem. An example would be the loss of a primary ISP connection."

Specified by:

alert in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

See Also:

http://en.wikipedia.org/wiki/Syslog

alert

public void alert(String aMessage,
                  Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.ALERT. "Should be corrected immediately, therefore notify staff who can fix the problem. An example would be the loss of a primary ISP connection." The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

alert in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

alert

public void alert(String aMessage,
                  Throwable aThrowable)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.ALERT.

Specified by:

alert in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

alert

public void alert(String aMessage,
                  Throwable aThrowable,
                  Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.ALERT.

Specified by:

alert in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

aArguments - The arguments used when replacing the placeholders.

isLogAlert

public boolean isLogAlert()

Description copied from interface: RuntimeLogger

Determines whether the RuntimeLogger is being configured to log fatal messages (LogPriority.ALERT). This method is useful to prevent the generation of vast amounts of log message String objects (and according processing) for the according LogPriority in case them messages of that LogPriority are not logged at all.

Specified by:

isLogAlert in interface RuntimeLogger

Returns:

True in case fatal messages are logged.

panic

public void panic(String aMessage)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.PANIC. "A "panic" condition usually affecting multiple apps/servers/sites. At this level it would usually notify all tech staff on call." (

Specified by:

panic in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

See Also:

http://en.wikipedia.org/wiki/Syslog

panic

public void panic(String aMessage,
                  Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.PANIC. "A "panic" condition usually affecting multiple apps/servers/sites. At this level it would usually notify all tech staff on call." The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

panic in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

panic

public void panic(String aMessage,
                  Throwable aThrowable)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.PANIC. "A "panic" condition usually affecting multiple apps/servers/sites. At this level it would usually notify all tech staff on call." (

Specified by:

panic in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

See Also:

http://en.wikipedia.org/wiki/Syslog

panic

public void panic(String aMessage,
                  Throwable aThrowable,
                  Object... aArguments)

Description copied from interface: RuntimeLogger

Logs a log message with log priorityLogPriority.PANIC. "A "panic" condition usually affecting multiple apps/servers/sites. At this level it would usually notify all tech staff on call." The placeholders in the message String are being replaced by the provided arguments. Implementations of this interface are recommended to use Java's MessageFormat's syntax, the placeholder being replaced by the first argument is identified by "{0}" (without the quotes), the second one by "{1}", the third one by "{3}" and so on: Given the message to be "{0} + {1} = {2}" and the three argument be x, y and x + y, then "{0}" is replaced by the value of x, "{1}" is replaced by the value of y and "{2}" is replaced by the value of x + y.

Specified by:

panic in interface RuntimeLogger

Parameters:

aMessage - The message to be logged.

aThrowable - An exception that the message should contain.

aArguments - The arguments used when replacing the placeholders.

See Also:

http://en.wikipedia.org/wiki/Syslog

isLogPanic

public boolean isLogPanic()

Description copied from interface: RuntimeLogger

Determines whether the RuntimeLogger is being configured to log fatal messages (LogPriority.PANIC). This method is useful to prevent the generation of vast amounts of log message String objects (and according processing) for the according LogPriority in case them messages of that LogPriority are not logged at all.

Specified by:

isLogPanic in interface RuntimeLogger

Returns:

True in case fatal messages are logged.