Log4j 1.3alpha-3

org.apache.log4j
Class LogManager

java.lang.Object
  |
  +--org.apache.log4j.LogManager

public class LogManager
extends java.lang.Object

Use the LogManager class to retreive Logger instances or to operate on the current LoggerRepository. When the LogManager class is loaded into memory the default initalzation procedure is inititated. The default intialization procedure is described in the short log4j manual.

Author:
Ceki Gülcü

Constructor Summary
LogManager()
           
 
Method Summary
static Logger exists(java.lang.String name)
           
static java.util.Enumeration getCurrentLoggers()
           
static Logger getLogger(java.lang.Class clazz)
          Retrieve the appropriate Logger instance.
static Logger getLogger(java.lang.String name)
          Retrieve the appropriate Logger instance.
static Logger getLogger(java.lang.String name, LoggerFactory factory)
          Retrieve the appropriate Logger instance.
static LoggerRepository getLoggerRepository()
           
static RepositorySelector getRepositorySelector()
          Return the repository selector currently in use.
static Logger getRootLogger()
          Retrieve the appropriate root logger.
static org.apache.log4j.scheduler.Scheduler getSchedulerInstance()
          Return a singleton Scheduler instance to be shared by multiple receivers and watchdogs.
static void resetConfiguration()
           
static void setRepositorySelector(RepositorySelector selector, java.lang.Object guard)
          Sets RepositorySelector but only if the correct guard is passed as parameter.
static void shutdown()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

LogManager

public LogManager()
Method Detail

setRepositorySelector

public static void setRepositorySelector(RepositorySelector selector,
                                         java.lang.Object guard)
                                  throws java.lang.IllegalArgumentException
Sets RepositorySelector but only if the correct guard is passed as parameter.

Initally the guard is null. If the guard is null, then invoking this method sets the logger repository and the guard. Following invocations will throw a IllegalArgumentException, unless the previously set guard is passed as the second parameter.

This allows a high-level component to set the RepositorySelector used by the LogManager.

For example, when tomcat starts it will be able to install its own repository selector. However, if and when Tomcat is embedded within JBoss, then JBoss will install its own repository selector and Tomcat will use the repository selector set by its container, JBoss.

java.lang.IllegalArgumentException

getRepositorySelector

public static RepositorySelector getRepositorySelector()
Return the repository selector currently in use.

Returns:
RepositorySelector currently in use.
Since:
1.3

getLoggerRepository

public static LoggerRepository getLoggerRepository()

getRootLogger

public static Logger getRootLogger()
Retrieve the appropriate root logger.


getLogger

public static Logger getLogger(java.lang.String name)
Retrieve the appropriate Logger instance.


getLogger

public static Logger getLogger(java.lang.Class clazz)
Retrieve the appropriate Logger instance.


getLogger

public static Logger getLogger(java.lang.String name,
                               LoggerFactory factory)
Retrieve the appropriate Logger instance.


exists

public static Logger exists(java.lang.String name)

getCurrentLoggers

public static java.util.Enumeration getCurrentLoggers()

shutdown

public static void shutdown()

resetConfiguration

public static void resetConfiguration()

getSchedulerInstance

public static org.apache.log4j.scheduler.Scheduler getSchedulerInstance()
Return a singleton Scheduler instance to be shared by multiple receivers and watchdogs.

Since:
1.3

Log4j 1.3alpha-3

Copyright 2000-2003 Apache Software Foundation.