|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface Logi18n
Internationalised logging interface abstracting the various logging APIs supported by Arjuna CLF.
The five logging levels used by Log
are (in order):
Performance is often a logging concern. By examining the appropriate property, a component can avoid expensive operations (producing information to be logged).
For example,
if (log.isDebugEnabled()) {
... do something expensive ...
log.debug(theResult);
}
Configuration of the underlying logging system will generally be done external to the Logging APIs, through whatever mechanism is supported by that system.
Method Summary | |
---|---|
void |
debug(java.lang.String key)
Log a message with DEBUG Level |
void |
debug(java.lang.String key,
java.lang.Object[] params)
Log a message with DEBUG Level and with arguments |
void |
debug(java.lang.String key,
java.lang.Object[] params,
java.lang.Throwable throwable)
Log a message with DEBUG Level, with arguments and with a throwable arguments |
void |
debug(java.lang.String key,
java.lang.Throwable throwable)
Log a message with the DEBUG Level and with a throwable arguments |
void |
error(java.lang.String key)
Log a message with the ERROR Level |
void |
error(java.lang.String key,
java.lang.Object[] params)
Log a message with the ERROR Level and with arguments |
void |
error(java.lang.String key,
java.lang.Object[] params,
java.lang.Throwable throwable)
Log a message with the ERROR Level, with arguments and with a throwable arguments |
void |
error(java.lang.String key,
java.lang.Throwable throwable)
Log a message with the ERROR Level and with a throwable arguments |
void |
fatal(java.lang.String key)
Log a message with the FATAL Level |
void |
fatal(java.lang.String key,
java.lang.Object[] params)
Log a message with the FATAL Level and with arguments |
void |
fatal(java.lang.String key,
java.lang.Object[] params,
java.lang.Throwable throwable)
Log a message with the FATAL Level, with arguments and with a throwable arguments |
void |
fatal(java.lang.String key,
java.lang.Throwable throwable)
Log a message with the FATAL Level and with a throwable arguments |
java.lang.String |
getString(java.lang.String key)
Obtain a localized message from one of the resource bundles associated with this logger. |
java.lang.String |
getString(java.lang.String key,
java.lang.Object[] params)
Obtain a localized and parameterized message from one of the resource bundles associated with this logger. |
void |
info(java.lang.String key)
Log a message with INFO Level |
void |
info(java.lang.String key,
java.lang.Object[] params)
Log a message with the INFO Level and with arguments |
void |
info(java.lang.String key,
java.lang.Object[] params,
java.lang.Throwable throwable)
Log a message with the INFO Level, with arguments and with a throwable arguments |
void |
info(java.lang.String key,
java.lang.Throwable throwable)
Log a message with the INFO Level and with a throwable arguments |
boolean |
isDebugEnabled()
Determine if this logger is enabled for DEBUG messages. |
boolean |
isErrorEnabled()
Determine if this logger is enabled for ERROR messages. |
boolean |
isFatalEnabled()
Determine if this logger is enabled for FATAL messages. |
boolean |
isInfoEnabled()
Determine if this logger is enabled for INFO messages. |
boolean |
isWarnEnabled()
Determine if this logger is enabled for WARN messages. |
void |
warn(java.lang.String key)
Log a message with the WARN Level |
void |
warn(java.lang.String key,
java.lang.Object[] params)
Log a message with the WARN Level and with arguments |
void |
warn(java.lang.String key,
java.lang.Object[] params,
java.lang.Throwable throwable)
Log a message with the WARN Level, with arguments and with a throwable arguments |
void |
warn(java.lang.String key,
java.lang.Throwable throwable)
Log a message with the WARN Level and with a throwable arguments |
Method Detail |
---|
boolean isDebugEnabled()
boolean isInfoEnabled()
boolean isWarnEnabled()
boolean isErrorEnabled()
boolean isFatalEnabled()
void debug(java.lang.String key)
key
- resource bundle key for the message to logvoid debug(java.lang.String key, java.lang.Throwable throwable)
key
- resource bundle key for the message to logthrowable
- The Throwable to logvoid debug(java.lang.String key, java.lang.Object[] params)
key
- resource bundle key for the message to logparams
- parameters passed to the messagevoid debug(java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
key
- resource bundle key for the message to logparams
- parameters passed to the messagethrowable
- The Throwable to logvoid info(java.lang.String key)
key
- resource bundle key for the message to logvoid info(java.lang.String key, java.lang.Throwable throwable)
key
- resource bundle key for the message to logthrowable
- Throwable associated to the logging messagevoid info(java.lang.String key, java.lang.Object[] params)
key
- resource bundle key for the message to logparams
- parameters passed to the messagevoid info(java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
key
- resource bundle key for the message to logparams
- parameters passed to the messagethrowable
- Throwable associated with the logging requestvoid warn(java.lang.String key)
key
- resource bundle key for the message to logvoid warn(java.lang.String key, java.lang.Throwable throwable)
key
- resource bundle key for the message to logthrowable
- Throwable associated with the logging requestvoid warn(java.lang.String key, java.lang.Object[] params)
key
- resource bundle key for the message to logparams
- parameters passed to the messagevoid warn(java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
key
- resource bundle key for the message to logparams
- parameters passed to the messagethrowable
- Throwable associated with the logging requestvoid error(java.lang.String key)
key
- resource bundle key for the message to logvoid error(java.lang.String key, java.lang.Throwable throwable)
key
- resource bundle key for the message to logthrowable
- Throwable associated with the logging requestvoid error(java.lang.String key, java.lang.Object[] params)
key
- resource bundle key for the message to logparams
- parameters passed to the messagevoid error(java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
key
- resource bundle key for the message to logparams
- parameters passed to the messagethrowable
- Throwable associated with the logging requestvoid fatal(java.lang.String key)
key
- resource bundle key for the message to logvoid fatal(java.lang.String key, java.lang.Throwable throwable)
key
- resource bundle key for the message to logthrowable
- Throwable associated with the logging requestvoid fatal(java.lang.String key, java.lang.Object[] params)
key
- resource bundle key for the message to logparams
- parameters passed to the messagevoid fatal(java.lang.String key, java.lang.Object[] params, java.lang.Throwable throwable)
key
- resource bundle key for the message to logparams
- parameters passed to the messagethrowable
- Throwable associated with the logging requestjava.lang.String getString(java.lang.String key)
key
is replaced by its localized
version from the resource bundle.
key
- unique key to identify an entry in the resource bundle.
java.lang.String getString(java.lang.String key, java.lang.Object[] params)
key
is searched in the resource
bundle. Next, the resulting pattern is formatted using
MessageFormat.format(String,Object[])
method with the
user supplied object array params
.
key
- unique key to identify an entry in the resource bundle.params
- parameters to fill placeholders (e.g., {0}, {1}) in the resource bundle string.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |