public interface
Log
A simple logging interface abstracting logging APIs. In order to be
instantiated successfully by
LogFactory
, classes that implement
this interface must have a constructor that takes a single String
parameter representing the "name" of this Log.
The six logging levels used by
Log
are (in order):
trace (the least serious)
debug
error
fatal (the most serious)
The mapping of these log levels to the concepts used by the underlying
logging system is implementation dependent.
The implementation should ensure, though, that this ordering behaves
as expected.
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.
spring-jcl
variant)
boolean
isFatalEnabled
()
Is fatal logging currently enabled?
Call this method to prevent having to perform expensive operations
(for example,
String
concatenation)
when the log level is more than fatal.
boolean
isErrorEnabled
()
Is error logging currently enabled?
Call this method to prevent having to perform expensive operations
(for example,
String
concatenation)
when the log level is more than error.
boolean
isWarnEnabled
()
Is warn logging currently enabled?
Call this method to prevent having to perform expensive operations
(for example,
String
concatenation)
when the log level is more than warn.
boolean
isInfoEnabled
()
Is info logging currently enabled?
Call this method to prevent having to perform expensive operations
(for example,
String
concatenation)
when the log level is more than info.
boolean
isDebugEnabled
()
Is debug logging currently enabled?
Call this method to prevent having to perform expensive operations
(for example,
String
concatenation)
when the log level is more than debug.
boolean
isTraceEnabled
()
Is trace logging currently enabled?
Call this method to prevent having to perform expensive operations
(for example,
String
concatenation)
when the log level is more than trace.
