org.apache.commons.logging

Interface Log

All Known Subinterfaces:

AndroidLog

All Known Implementing Classes:

AndroidLogger, SimpleAndroidLog, SimpleLog

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):

1. trace (the least serious)
2. debug
3. info
4. warn
5. error
6. fatal (the most serious)

The mapping of these log levels to the concepts used by the underlying logging system is implementation dependent. The implemention 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.

* * @author Scott Sanders * @author Rod Waldhoff * @version $Id: Log.java 424107 2006-07-20 23:15:42Z skitching $

Method Summary

Methods

Modifier and Type	Method and Description
void	debug(Object message)
void	debug(Object message, Throwable t)
void	error(Object message)
void	error(Object message, Throwable t)
void	fatal(Object message)
void	fatal(Object message, Throwable t)
void	info(Object message)
void	info(Object message, Throwable t)
boolean	isDebugEnabled()
boolean	isErrorEnabled()
boolean	isFatalEnabled()
boolean	isInfoEnabled()
boolean	isTraceEnabled()
boolean	isWarnEnabled()
void	trace(Object message)
void	trace(Object message, Throwable t)
void	warn(Object message)
void	warn(Object message, Throwable t)

Method Detail

isDebugEnabled

boolean isDebugEnabled()

isErrorEnabled

boolean isErrorEnabled()

isFatalEnabled

boolean isFatalEnabled()

isInfoEnabled

boolean isInfoEnabled()

isTraceEnabled

boolean isTraceEnabled()

isWarnEnabled

boolean isWarnEnabled()

trace

void trace(Object message)

trace

void trace(Object message,
         Throwable t)

debug

void debug(Object message)

debug

void debug(Object message,
         Throwable t)

info

void info(Object message)

info

void info(Object message,
        Throwable t)

warn

void warn(Object message)

warn

void warn(Object message,
        Throwable t)

error

void error(Object message)

error

void error(Object message,
         Throwable t)

fatal

void fatal(Object message)

fatal

void fatal(Object message,
         Throwable t)