org.apache.log4j

Class Hierarchy

java.lang.Object

org.apache.log4j.Hierarchy

All Implemented Interfaces:

LoggerRepository, RendererSupport, ThrowableRendererSupport

public class Hierarchy
extends Object
implements LoggerRepository, RendererSupport, ThrowableRendererSupport

Our replacement for the log4j Hierarchy class. We redirect management of the hierarchy completely to the logmanager's log context.

Constructor Summary

Constructors

Constructor and Description
Hierarchy(Logger root)

Method Summary

Methods

Modifier and Type	Method and Description
void	addHierarchyEventListener(HierarchyEventListener listener) Add a HierarchyEventListener event to the repository.
void	addRenderer(Class classToRender, ObjectRenderer or)
void	clear()
void	emitNoAppenderWarning(Category cat)
Logger	exists(String name)
void	fireAddAppenderEvent(Category logger, Appender appender)
Enumeration	getCurrentCategories() Deprecated.
Enumeration	getCurrentLoggers()
Logger	getLogger(String name)
Logger	getLogger(String name, LoggerFactory factory)
RendererMap	getRendererMap()
Logger	getRootLogger()
Level	getThreshold() Get the repository-wide threshold.
ThrowableRenderer	getThrowableRenderer() Get throwable renderer.
boolean	isDisabled(int level) Returns whether this repository is disabled for a given level.
void	overrideAsNeeded(String override) Deprecated.
void	resetConfiguration()
void	setDisableOverride(String override) Deprecated.
void	setRenderer(Class renderedClass, ObjectRenderer renderer)
void	setThreshold(Level l) Set the repository-wide threshold.
void	setThreshold(String levelStr) Another form of LoggerRepository.setThreshold(Level) accepting a string parameter instead of a Level.
void	setThrowableRenderer(ThrowableRenderer renderer) Set throwable renderer.
void	shutdown()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Hierarchy

public Hierarchy(Logger root)

Method Detail

addRenderer

public void addRenderer(Class classToRender,
               ObjectRenderer or)

addHierarchyEventListener

public void addHierarchyEventListener(HierarchyEventListener listener)

Description copied from interface: LoggerRepository

Add a HierarchyEventListener event to the repository.

Specified by:

addHierarchyEventListener in interface LoggerRepository

clear

public void clear()

emitNoAppenderWarning

public void emitNoAppenderWarning(Category cat)

Specified by:

emitNoAppenderWarning in interface LoggerRepository

exists

public Logger exists(String name)

Specified by:

exists in interface LoggerRepository

setThreshold

public void setThreshold(String levelStr)

Description copied from interface: LoggerRepository

Another form of LoggerRepository.setThreshold(Level) accepting a string parameter instead of a Level.

Specified by:

setThreshold in interface LoggerRepository

setThreshold

public void setThreshold(Level l)

Description copied from interface: LoggerRepository

Set the repository-wide threshold. All logging requests below the threshold are immediately dropped. By default, the threshold is set to Level.ALL which has the lowest possible rank.

Specified by:

setThreshold in interface LoggerRepository

fireAddAppenderEvent

public void fireAddAppenderEvent(Category logger,
                        Appender appender)

Specified by:

fireAddAppenderEvent in interface LoggerRepository

getThreshold

public Level getThreshold()

Description copied from interface: LoggerRepository

Get the repository-wide threshold. See LoggerRepository.setThreshold(Level) for an explanation.

Specified by:

getThreshold in interface LoggerRepository

getLogger

public Logger getLogger(String name)

Specified by:

getLogger in interface LoggerRepository

getLogger

public Logger getLogger(String name,
               LoggerFactory factory)

Specified by:

getLogger in interface LoggerRepository

getCurrentLoggers

public Enumeration getCurrentLoggers()

Specified by:

getCurrentLoggers in interface LoggerRepository

getCurrentCategories

public Enumeration getCurrentCategories()

Description copied from interface: LoggerRepository

Deprecated. Please use LoggerRepository.getCurrentLoggers() instead.

Specified by:

getCurrentCategories in interface LoggerRepository

getRendererMap

public RendererMap getRendererMap()

Specified by:

getRendererMap in interface RendererSupport

getRootLogger

public Logger getRootLogger()

Specified by:

getRootLogger in interface LoggerRepository

isDisabled

public boolean isDisabled(int level)

Description copied from interface: LoggerRepository

Returns whether this repository is disabled for a given level. The answer depends on the repository threshold and the level parameter. See also LoggerRepository.setThreshold(org.apache.log4j.Level) method.

Specified by:

isDisabled in interface LoggerRepository

overrideAsNeeded

@Deprecated
public void overrideAsNeeded(String override)

Deprecated.

resetConfiguration

public void resetConfiguration()

Specified by:

resetConfiguration in interface LoggerRepository

setDisableOverride

@Deprecated
public void setDisableOverride(String override)

Deprecated.

setRenderer

public void setRenderer(Class renderedClass,
               ObjectRenderer renderer)

Specified by:

setRenderer in interface RendererSupport

setThrowableRenderer

public void setThrowableRenderer(ThrowableRenderer renderer)

Description copied from interface: ThrowableRendererSupport

Set throwable renderer.

Specified by:

setThrowableRenderer in interface ThrowableRendererSupport

Parameters:

renderer - renderer, may be null.

getThrowableRenderer

public ThrowableRenderer getThrowableRenderer()

Description copied from interface: ThrowableRendererSupport

Get throwable renderer.

Specified by:

getThrowableRenderer in interface ThrowableRendererSupport

Returns:

throwable renderer, may be null.

shutdown

public void shutdown()

Specified by:

shutdown in interface LoggerRepository