Class 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.
    • Field Detail

      • DEFAULT_CONFIGURATION_FILE

        public static final java.lang.String DEFAULT_CONFIGURATION_FILE
        Deprecated.
        This variable is for internal use only. It will become package protected in future versions.
        See Also:
        Constant Field Values
      • DEFAULT_XML_CONFIGURATION_FILE

        static final java.lang.String DEFAULT_XML_CONFIGURATION_FILE
        See Also:
        Constant Field Values
      • DEFAULT_CONFIGURATION_KEY

        public static final java.lang.String DEFAULT_CONFIGURATION_KEY
        Deprecated.
        This variable is for internal use only. It will become private in future versions.
        See Also:
        Constant Field Values
      • CONFIGURATOR_CLASS_KEY

        public static final java.lang.String CONFIGURATOR_CLASS_KEY
        Deprecated.
        This variable is for internal use only. It will become private in future versions.
        See Also:
        Constant Field Values
      • DEFAULT_INIT_OVERRIDE_KEY

        public static final java.lang.String DEFAULT_INIT_OVERRIDE_KEY
        Deprecated.
        This variable is for internal use only. It will become private in future versions.
        See Also:
        Constant Field Values
      • guard

        private static java.lang.Object guard
    • Constructor Detail

      • LogManager

        public LogManager()
    • Method Detail

      • setRepositorySelector

        public static void setRepositorySelector​(RepositorySelector selector,
                                                 java.lang.Object guard)
                                          throws java.lang.IllegalArgumentException
        Sets 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.

        Throws:
        java.lang.IllegalArgumentException
      • isLikelySafeScenario

        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.
        Parameters:
        ex - exception used to determine calling stack.
        Returns:
        true if calling stack is recognized as likely safe.
      • 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()