java.lang.Object
org.refcodes.logger.RuntimeLoggerSingleton
- All Implemented Interfaces:
LogDecorator
,LogPriorityAccessor
,MessageLogger<LogPriority>
,RuntimeLogger
,org.refcodes.mixin.NameAccessor
This
RuntimeLoggerSingleton
provides a RuntimeLogger
singleton configured by a "runtimelogger-config.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 (as defined in the
Folders.CONFIG_DIRS
) relative to this base directory is generated :
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"
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
SystemProperty.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
org.refcodes.mixin.NameAccessor.NameBuilder<B extends org.refcodes.mixin.NameAccessor.NameBuilder<B>>, org.refcodes.mixin.NameAccessor.NameMutator, org.refcodes.mixin.NameAccessor.NameProperty
-
Field Summary
Fields inherited from interface org.refcodes.logger.RuntimeLogger
ROOT_LOGGER_ELEMENT_PATH, RUNTIME_LOGGER_CONFIG
-
Constructor Summary
ModifierConstructorDescriptionprotected
RuntimeLoggerSingleton
(RuntimeLogger aRuntimeLogger) Instantiates a new runtime logger singleton. -
Method Summary
Modifier and TypeMethodDescriptionvoid
Logs a log message with log priorityLogPriority.ALERT
.void
Logs a log message with log priorityLogPriority.ALERT
.void
Logs a log message with log priorityLogPriority.ALERT
.void
Logs a log message with log priorityLogPriority.ALERT
.void
Logs a log message with log priorityLogPriority.CRITICAL
.void
Logs a log message with log priorityLogPriority.CRITICAL
.void
Logs a log message with log priorityLogPriority.CRITICAL
.void
Logs a log message with log priorityLogPriority.CRITICAL
.void
Logs a log message with log priorityLogPriority.DEBUG
.void
Logs a log message with log priorityLogPriority.DEBUG
.void
Logs a log message with log priorityLogPriority.ERROR
.void
Logs a log message with log priorityLogPriority.ERROR
.void
Logs a log message with log priorityLogPriority.ERROR
.void
Logs a log message with log priorityLogPriority.ERROR
.static RuntimeLogger
Returns the singleton's instance as fabricated by thisRuntimeLoggerSingleton
.Retrieves theLogPriority
from theLogPriorityAccessor
.getName()
void
Logs a log message with log priorityLogPriority.INFO
.void
Logs a log message with log priorityLogPriority.INFO
.boolean
isLog
(LogPriority aPriority) Determines whether theRuntimeLogger
is being configured to log messages of the accordingLogPriority
.boolean
Determines whether theRuntimeLogger
is being configured to log fatal messages (LogPriority.ALERT
).boolean
Determines whether theRuntimeLogger
is being configured to log fatal messages (LogPriority.CRITICAL
).boolean
Determines whether theRuntimeLogger
is being configured to log debug messages (LogPriority.DEBUG
).boolean
Determines whether theRuntimeLogger
is being configured to log errors (LogPriority.ERROR
).boolean
Determines whether theRuntimeLogger
is being configured to log infos (LogPriority.INFO
).boolean
Determines whether theRuntimeLogger
is being configured to log notices (LogPriority.NOTICE
).boolean
Determines whether theRuntimeLogger
is being configured to log fatal messages (LogPriority.PANIC
).boolean
Determines whether theRuntimeLogger
is being configured to log comments (LogPriority.TRACE
).boolean
Determines whether theRuntimeLogger
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
Logs a log message with log priorityLogPriority.NOTICE
.void
Logs a log message with log priorityLogPriority.NOTICE
.void
Logs a log message with log priorityLogPriority.PANIC
.void
Logs a log message with log priorityLogPriority.PANIC
.void
Logs a log message with log priorityLogPriority.PANIC
.void
Logs a log message with log priorityLogPriority.PANIC
.void
Logs a log message with log priorityLogPriority.TRACE
.void
Logs a log message with log priorityLogPriority.TRACE
.void
Logs a log message with log priorityLogPriority.WARN
.void
Logs a log message with log priorityLogPriority.WARN
.void
Logs a log message with log priorityLogPriority.WARN
.void
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
Methods inherited from interface org.refcodes.logger.LogDecorator
printHead, printSeparator, printTail
Methods inherited from interface org.refcodes.logger.RuntimeLogger
log
-
Constructor Details
-
RuntimeLoggerSingleton
Instantiates a new runtime logger singleton.- Parameters:
aRuntimeLogger
- the runtime logger
-
-
Method Details
-
getInstance
Returns the singleton's instance as fabricated by thisRuntimeLoggerSingleton
.- Returns:
- The
RuntimeLogger
singleton's instance. - Throws:
LoggerInstantiationRuntimeException
- Thrown in case instantiating aLogger
(RuntimeLogger
) failed
-
getName
- Specified by:
getName
in interfaceorg.refcodes.mixin.NameAccessor
-
getLogPriority
Retrieves theLogPriority
from theLogPriorityAccessor
.- Specified by:
getLogPriority
in interfaceLogPriorityAccessor
- Returns:
- The
LogPriority
stored by theLogPriorityAccessor
.
-
log
Creates a new log message.- Specified by:
log
in interfaceMessageLogger<LogPriority>
- Parameters:
aMarker
- The marker for the message.aMessage
- The message to be logged.
-
log
Creates a new log message.- Specified by:
log
in interfaceRuntimeLogger
- Parameters:
aPriority
- The level of the message.aMessage
- The message to be logged.aThrowable
- An exception that the message should contain.
-
log
Creates a new log message. The placeholders in the messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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 interfaceMessageLogger<LogPriority>
- Parameters:
aMarker
- The marker for the message.aMessage
- The message to be logged.aArguments
- The arguments used when replacing the placeholders.
-
log
Creates a new log message. The placeholders in the messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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 interfaceRuntimeLogger
- 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
Determines whether theRuntimeLogger
is being configured to log messages of the accordingLogPriority
. This method is useful to prevent the generation of vast amounts of log messageString
objects (and according processing) for the accordingLogPriority
in case them messages of thatLogPriority
are not logged at all.- Specified by:
isLog
in interfaceRuntimeLogger
- Parameters:
aPriority
- TheLogPriority
to test whether theRuntimeLogger
does log messages of thatLogPriority
.- Returns:
- True in case the
RuntimeLogger
does log messages of thatLogPriority
.
-
trace
Logs a log message with log priorityLogPriority.TRACE
.- Specified by:
trace
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.
-
trace
Logs a log message with log priorityLogPriority.TRACE
. The placeholders in the messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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 interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aArguments
- The arguments used when replacing the placeholders.
-
isLogTrace
public boolean isLogTrace()Determines whether theRuntimeLogger
is being configured to log comments (LogPriority.TRACE
). This method is useful to prevent the generation of vast amounts of log messageString
objects (and according processing) for the accordingLogPriority
in case them messages of thatLogPriority
are not logged at all.- Specified by:
isLogTrace
in interfaceRuntimeLogger
- Returns:
- True in case comments are logged.
-
debug
Logs a log message with log priorityLogPriority.DEBUG
. "Info useful to developers for debugging the application, not useful during operations." See also http://en.wikipedia.org/wiki/Syslog- Specified by:
debug
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.
-
debug
Logs a log message with log priorityLogPriority.DEBUG
. "Info useful to developers for debugging the application, not useful during operations." The placeholders in the messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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. See also http://en.wikipedia.org/wiki/Syslog- Specified by:
debug
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aArguments
- The arguments used when replacing the placeholders.
-
isLogDebug
public boolean isLogDebug()Determines whether theRuntimeLogger
is being configured to log debug messages (LogPriority.DEBUG
). This method is useful to prevent the generation of vast amounts of log messageString
objects (and according processing) for the accordingLogPriority
in case them messages of thatLogPriority
are not logged at all.- Specified by:
isLogDebug
in interfaceRuntimeLogger
- Returns:
- True in case debug messages are logged.
-
info
Logs a log message with log priorityLogPriority.INFO
. "Additional information which might be useful for some stability period." See also http://en.wikipedia.org/wiki/Syslog- Specified by:
info
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.
-
info
Logs a log message with log priorityLogPriority.INFO
. "Additional information which might be useful for some stability period." The placeholders in the messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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. See also http://en.wikipedia.org/wiki/Syslog- Specified by:
info
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aArguments
- The arguments used when replacing the placeholders.
-
isLogInfo
public boolean isLogInfo()Determines whether theRuntimeLogger
is being configured to log infos (LogPriority.INFO
). This method is useful to prevent the generation of vast amounts of log messageString
objects (and according processing) for the accordingLogPriority
in case them messages of thatLogPriority
are not logged at all.- Specified by:
isLogInfo
in interfaceRuntimeLogger
- Returns:
- True in case infos are logged.
-
notice
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." See also http://en.wikipedia.org/wiki/Syslog- Specified by:
notice
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.
-
notice
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 messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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. See also http://en.wikipedia.org/wiki/Syslog- Specified by:
notice
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aArguments
- The arguments used when replacing the placeholders.
-
isLogNotice
public boolean isLogNotice()Determines whether theRuntimeLogger
is being configured to log notices (LogPriority.NOTICE
). This method is useful to prevent the generation of vast amounts of log messageString
objects (and according processing) for the accordingLogPriority
in case them messages of thatLogPriority
are not logged at all.- Specified by:
isLogNotice
in interfaceRuntimeLogger
- Returns:
- True in case infos are logged.
-
warn
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." See also http://en.wikipedia.org/wiki/Syslog- Specified by:
warn
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.
-
warn
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 messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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. See also http://en.wikipedia.org/wiki/Syslog- Specified by:
warn
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aArguments
- The arguments used when replacing the placeholders.
-
warn
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." See also http://en.wikipedia.org/wiki/Syslog- Specified by:
warn
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aThrowable
- An exception that the message should contain.
-
warn
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 messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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. See also http://en.wikipedia.org/wiki/Syslog- Specified by:
warn
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aThrowable
- An exception that the message should contain.aArguments
- The arguments used when replacing the placeholders.
-
isLogWarn
public boolean isLogWarn()Determines whether theRuntimeLogger
is being configured to log warnings (LogPriority.WARN
). This method is useful to prevent the generation of vast amounts of log messageString
objects (and according processing) for the accordingLogPriority
in case them messages of thatLogPriority
are not logged at all.- Specified by:
isLogWarn
in interfaceRuntimeLogger
- Returns:
- True in case warnings are logged.
-
error
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." See also http://en.wikipedia.org/wiki/Syslog- Specified by:
error
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.
-
error
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 messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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. See also http://en.wikipedia.org/wiki/Syslog- Specified by:
error
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aArguments
- The arguments used when replacing the placeholders.
-
error
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." See also http://en.wikipedia.org/wiki/Syslog- Specified by:
error
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aThrowable
- An exception that the message should contain.
-
error
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 messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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. See also http://en.wikipedia.org/wiki/Syslog- Specified by:
error
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aThrowable
- An exception that the message should contain.aArguments
- The arguments used when replacing the placeholders.
-
isLogError
public boolean isLogError()Determines whether theRuntimeLogger
is being configured to log errors (LogPriority.ERROR
). This method is useful to prevent the generation of vast amounts of log messageString
objects (and according processing) for the accordingLogPriority
in case them messages of thatLogPriority
are not logged at all.- Specified by:
isLogError
in interfaceRuntimeLogger
- Returns:
- True in case errors are logged.
-
critical
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." See also http://en.wikipedia.org/wiki/Syslog- Specified by:
critical
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.
-
critical
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 messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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. See also http://en.wikipedia.org/wiki/Syslog- Specified by:
critical
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aArguments
- The arguments used when replacing the placeholders.
-
critical
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." See also http://en.wikipedia.org/wiki/Syslog- Specified by:
critical
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aThrowable
- An exception that the message should contain.
-
critical
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." See also http://en.wikipedia.org/wiki/Syslog- Specified by:
critical
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aThrowable
- An exception that the message should contain.aArguments
- The arguments used when replacing the placeholders.
-
isLogCritical
public boolean isLogCritical()Determines whether theRuntimeLogger
is being configured to log fatal messages (LogPriority.CRITICAL
). This method is useful to prevent the generation of vast amounts of log messageString
objects (and according processing) for the accordingLogPriority
in case them messages of thatLogPriority
are not logged at all.- Specified by:
isLogCritical
in interfaceRuntimeLogger
- Returns:
- True in case fatal messages are logged.
-
alert
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." See also http://en.wikipedia.org/wiki/Syslog- Specified by:
alert
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.
-
alert
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 messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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. See also http://en.wikipedia.org/wiki/Syslog- Specified by:
alert
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aArguments
- The arguments used when replacing the placeholders.
-
alert
Logs a log message with log priorityLogPriority.ALERT
.- Specified by:
alert
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aThrowable
- An exception that the message should contain.
-
alert
Logs a log message with log priorityLogPriority.ALERT
.- Specified by:
alert
in interfaceRuntimeLogger
- 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()Determines whether theRuntimeLogger
is being configured to log fatal messages (LogPriority.ALERT
). This method is useful to prevent the generation of vast amounts of log messageString
objects (and according processing) for the accordingLogPriority
in case them messages of thatLogPriority
are not logged at all.- Specified by:
isLogAlert
in interfaceRuntimeLogger
- Returns:
- True in case fatal messages are logged.
-
panic
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." ( See also http://en.wikipedia.org/wiki/Syslog- Specified by:
panic
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.
-
panic
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 messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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. See also http://en.wikipedia.org/wiki/Syslog- Specified by:
panic
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aArguments
- The arguments used when replacing the placeholders.
-
panic
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." ( See also http://en.wikipedia.org/wiki/Syslog- Specified by:
panic
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aThrowable
- An exception that the message should contain.
-
panic
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 messageString
are being replaced by the provided arguments. Implementations of this interface are recommended to use Java'sMessageFormat
'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. See also http://en.wikipedia.org/wiki/Syslog- Specified by:
panic
in interfaceRuntimeLogger
- Parameters:
aMessage
- The message to be logged.aThrowable
- An exception that the message should contain.aArguments
- The arguments used when replacing the placeholders.
-
isLogPanic
public boolean isLogPanic()Determines whether theRuntimeLogger
is being configured to log fatal messages (LogPriority.PANIC
). This method is useful to prevent the generation of vast amounts of log messageString
objects (and according processing) for the accordingLogPriority
in case them messages of thatLogPriority
are not logged at all.- Specified by:
isLogPanic
in interfaceRuntimeLogger
- Returns:
- True in case fatal messages are logged.
-