org.apache.log
Class Hierarchy
public class Hierarchy
extends java.lang.Object
This class encapsulates a basic independent log hierarchy.
The hierarchy is essentially a safe wrapper around root logger.
Hierarchy
public Hierarchy()
Create a hierarchy object.
The default LogTarget writes to stdout.
addLoggerListener
public void addLoggerListener(LoggerListener loggerListener)
Set the LoggerListener associated with hierarchy. This is a
unicast listener, so only one LoggerListener is allowed.
loggerListener
- the LoggerListener
getDefaultHierarchy
public static Hierarchy getDefaultHierarchy()
Retrieve the default hierarchy.
In most cases the default LogHierarchy is the only
one used in an application. However when security is
a concern or multiple independent applications will
be running in same JVM it is advantageous to create
new Hierarchies rather than reuse default.
getLoggerFor
public Logger getLoggerFor(String category)
Retrieve a logger for named category.
getRootLogger
public final Logger getRootLogger()
Utility method to retrieve logger for hierarchy.
This method is intended for use by sub-classes
which can take responsibility for manipulating
Logger directly.
log
public void log(String message)
Logging components should use ErrorHandler rather than Hierarchy.log()
Logs an error message to error handler.
Default Error Handler is stderr.
message
- a message to log
log
public void log(String message,
Throwable throwable)
Logging components should use ErrorHandler rather than Hierarchy.log()
Logs an error message to error handler.
Default Error Handler is stderr.
message
- a message to logthrowable
- a Throwable to log
removeLoggerListener
public void removeLoggerListener(LoggerListener loggerListener)
Remove the LoggerListener associated with hierarchy. Perform this
step before adding a new one if you want to change it.
loggerListener
- the LoggerListener
setDefaultLogTarget
public void setDefaultLogTarget(LogTarget target)
Set the default log target for hierarchy.
This is the target inherited by loggers if no other target is specified.
target
- the default target
setDefaultLogTargets
public void setDefaultLogTargets(LogTarget[] targets)
Set the default log targets for this hierarchy.
These are the targets inherited by loggers if no other targets are specified
targets
- the default targets
setDefaultPriority
public void setDefaultPriority(Priority priority)
Set the default priority for hierarchy.
This is the priority inherited by loggers if no other priority is specified.
priority
- the default priority
setErrorHandler
public void setErrorHandler(ErrorHandler errorHandler)
Set the ErrorHandler associated with hierarchy.
errorHandler
- the ErrorHandler