org.apache.log4j.spi

Interface LoggerRepository

Known Implementing Classes:
Hierarchy

public interface LoggerRepository

A LoggerRepository is used to create and retrieve Loggers. The relation between loggers in a repository depends on the repository but typically loggers are arranged in a named hierarchy.

In addition to the creational methods, a LoggerRepository can be queried for existing loggers, can act as a point of registry for events related to loggers.

Author:
Ceki Gülcü

Since:
1.2

Method Summary

void
addHierarchyEventListener(HierarchyEventListener listener)
Add a HierarchyEventListener event to the repository.
void
emitNoAppenderWarning(Category cat)
Logger
exists(String name)
void
fireAddAppenderEvent(Category logger, Appender appender)
Enumeration
getCurrentCategories()
Deprecated. Please use getCurrentLoggers() instead.
Enumeration
getCurrentLoggers()
Logger
getLogger(String name)
Logger
getLogger(String name, LoggerFactory factory)
Logger
getRootLogger()
Level
getThreshold()
Get the repository-wide threshold.
boolean
isDisabled(int level)
Returns whether this repository is disabled for a given level.
void
resetConfiguration()
void
setThreshold(String val)
Another form of setThreshold(Level) accepting a string parameter instead of a Level.
void
setThreshold(Level level)
Set the repository-wide threshold.
void
shutdown()

Method Details

addHierarchyEventListener

public void addHierarchyEventListener(HierarchyEventListener listener)
Add a HierarchyEventListener event to the repository.


emitNoAppenderWarning

public void emitNoAppenderWarning(Category cat)


exists

public Logger exists(String name)


fireAddAppenderEvent

public void fireAddAppenderEvent(Category logger,
                                 Appender appender)


getCurrentCategories

public Enumeration getCurrentCategories()

Deprecated. Please use getCurrentLoggers() instead.


getCurrentLoggers

public Enumeration getCurrentLoggers()


getLogger

public Logger getLogger(String name)


getLogger

public Logger getLogger(String name,
                        LoggerFactory factory)


getRootLogger

public Logger getRootLogger()


getThreshold

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


isDisabled

public boolean isDisabled(int level)
Returns whether this repository is disabled for a given level. The answer depends on the repository threshold and the level parameter. See also setThreshold method.


resetConfiguration

public void resetConfiguration()


setThreshold

public void setThreshold(String val)
Another form of setThreshold(Level) accepting a string parameter instead of a Level.


setThreshold

public void setThreshold(Level level)
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.


shutdown

public void shutdown()


Copyright 2000-2002 Apache Software Foundation.