public class LogManager
extends java.lang.Object
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.Modifier and Type | Field and Description |
---|---|
static java.lang.String |
CONFIGURATOR_CLASS_KEY
Deprecated.
This variable is for internal use only. It will
become private in future versions.
|
static java.lang.String |
DEFAULT_CONFIGURATION_FILE
Deprecated.
This variable is for internal use only. It will
become package protected in future versions.
|
static java.lang.String |
DEFAULT_CONFIGURATION_KEY
Deprecated.
This variable is for internal use only. It will
become private in future versions.
|
static java.lang.String |
DEFAULT_INIT_OVERRIDE_KEY
Deprecated.
This variable is for internal use only. It will
become private in future versions.
|
(package private) static java.lang.String |
DEFAULT_XML_CONFIGURATION_FILE |
private static java.lang.Object |
guard |
private static RepositorySelector |
repositorySelector |
Constructor and Description |
---|
LogManager() |
Modifier and Type | Method and Description |
---|---|
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 Logger |
getRootLogger()
Retrieve the appropriate root logger.
|
private static boolean |
isLikelySafeScenario(java.lang.Exception ex)
This method tests if called from a method that
is known to result in class members being abnormally
set to null but is assumed to be harmless since the
all classes are in the process of being unloaded.
|
static void |
resetConfiguration() |
static void |
setRepositorySelector(RepositorySelector selector,
java.lang.Object guard)
Sets
LoggerFactory but only if the correct
guard is passed as parameter. |
static void |
shutdown() |
public static final java.lang.String DEFAULT_CONFIGURATION_FILE
static final java.lang.String DEFAULT_XML_CONFIGURATION_FILE
public static final java.lang.String DEFAULT_CONFIGURATION_KEY
public static final java.lang.String CONFIGURATOR_CLASS_KEY
public static final java.lang.String DEFAULT_INIT_OVERRIDE_KEY
private static java.lang.Object guard
private static RepositorySelector repositorySelector
public static void setRepositorySelector(RepositorySelector selector, java.lang.Object guard) throws java.lang.IllegalArgumentException
LoggerFactory
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
factory 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
private static boolean isLikelySafeScenario(java.lang.Exception ex)
ex
- exception used to determine calling stack.public static LoggerRepository getLoggerRepository()
public static Logger getRootLogger()
public static Logger getLogger(java.lang.String name)
Logger
instance.public static Logger getLogger(java.lang.Class clazz)
Logger
instance.public static Logger getLogger(java.lang.String name, LoggerFactory factory)
Logger
instance.public static Logger exists(java.lang.String name)
public static java.util.Enumeration getCurrentLoggers()
public static void shutdown()
public static void resetConfiguration()