org.apache.log

Class Hierarchy

public class Hierarchy extends Object

This class encapsulates a basic independent log hierarchy. The hierarchy is essentially a safe wrapper around root logger.

Author: Avalon Development Team Peter Donald

Constructor Summary
Hierarchy()
Create a hierarchy object.
Method Summary
voidaddLoggerListener(LoggerListener loggerListener)
Set the LoggerListener associated with hierarchy.
static HierarchygetDefaultHierarchy()
Retrieve the default hierarchy.
LoggergetLoggerFor(String category)
Retrieve a logger for named category.
LoggergetRootLogger()
Utility method to retrieve logger for hierarchy.
voidlog(String message, Throwable throwable)
Logs an error message to error handler.
voidlog(String message)
Logs an error message to error handler.
voidremoveLoggerListener(LoggerListener loggerListener)
Remove the LoggerListener associated with hierarchy.
voidsetDefaultLogTarget(LogTarget target)
Set the default log target for hierarchy.
voidsetDefaultLogTargets(LogTarget[] targets)
Set the default log targets for this hierarchy.
voidsetDefaultPriority(Priority priority)
Set the default priority for hierarchy.
voidsetErrorHandler(ErrorHandler errorHandler)
Set the ErrorHandler associated with hierarchy.

Constructor Detail

Hierarchy

public Hierarchy()
Create a hierarchy object. The default LogTarget writes to stdout.

Method Detail

addLoggerListener

public void addLoggerListener(LoggerListener loggerListener)
Set the LoggerListener associated with hierarchy. This is a unicast listener, so only one LoggerListener is allowed.

Parameters: loggerListener the LoggerListener

Throws: UnsupportedOperationException if no more LoggerListeners are permitted.

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.

Returns: the default Hierarchy

getLoggerFor

public Logger getLoggerFor(String category)
Retrieve a logger for named category.

Parameters: category the context

Returns: the Logger

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.

Returns: the Logger

log

public void log(String message, Throwable throwable)

Deprecated: Logging components should use ErrorHandler rather than Hierarchy.log()

Logs an error message to error handler. Default Error Handler is stderr.

Parameters: message a message to log throwable a Throwable to log

log

public void log(String message)

Deprecated: Logging components should use ErrorHandler rather than Hierarchy.log()

Logs an error message to error handler. Default Error Handler is stderr.

Parameters: message a message 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.

Parameters: 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.

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

Parameters: 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.

Parameters: priority the default priority

setErrorHandler

public void setErrorHandler(ErrorHandler errorHandler)
Set the ErrorHandler associated with hierarchy.

Parameters: errorHandler the ErrorHandler