Package org.jboss.logmanager

Class LogManager

  • public final class LogManager
extends java.util.logging.LogManager
    Simplified log manager. Designed to work around the (many) design flaws of the JDK platform log manager.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      private java.util.concurrent.atomic.AtomicBoolean configured  
      (package private) static boolean PER_THREAD_LOG_FILTER  
      static java.lang.String PER_THREAD_LOG_FILTER_KEY  

      • Fields inherited from class java.util.logging.LogManager

        LOGGING_MXBEAN_NAME

    • Constructor Summary

      Constructors 
      Constructor Description
      LogManager()
      Construct a new logmanager instance.

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      boolean addLogger​(java.util.logging.Logger logger)
      Do nothing.
      void addPropertyChangeListener​(java.beans.PropertyChangeListener l)
      Do nothing.
      (package private) static <T> T construct​(java.lang.Class<? extends T> type, java.lang.String className)  
      Logger getLogger​(java.lang.String name)
      Get or create a logger with the given name.
      java.util.Enumeration<java.lang.String> getLoggerNames()  
      java.lang.String getProperty​(java.lang.String name)
      Does nothing.
      static java.util.logging.Filter getThreadLocalLogFilter()
      Returns the currently set filter for this thread or null if one has not been set.
      void readConfiguration()
      Configure the log manager one time.
      void readConfiguration​(java.io.InputStream inputStream)
      Configure the log manager.
      void removePropertyChangeListener​(java.beans.PropertyChangeListener l)
      Do nothing.
      void reset()
      Does nothing.
      static void setThreadLocalLogLevel​(java.util.logging.Filter filter)
      Sets the filter on the thread for all loggers.
      private static java.lang.String tryGetProperty​(java.lang.String name, java.lang.String defaultVal)  

      • Methods inherited from class java.util.logging.LogManager

        addConfigurationListener, checkAccess, getLoggingMXBean, getLogManager, removeConfigurationListener, updateConfiguration, updateConfiguration

      • Methods inherited from class java.lang.Object

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

    • Field Detail

      • PER_THREAD_LOG_FILTER_KEY

        public static final java.lang.String PER_THREAD_LOG_FILTER_KEY
        See Also:
        Constant Field Values

      • PER_THREAD_LOG_FILTER

        static final boolean PER_THREAD_LOG_FILTER

      • configured

        private final java.util.concurrent.atomic.AtomicBoolean configured

    • Constructor Detail

      • LogManager

        public LogManager()
        Construct a new logmanager instance. Attempts to plug a known memory leak in Level as well.

    • Method Detail

      • tryGetProperty

        private static java.lang.String tryGetProperty​(java.lang.String name,
                                               java.lang.String defaultVal)

      • readConfiguration

        public void readConfiguration()
                       throws java.io.IOException,
                              java.lang.SecurityException
        Configure the log manager one time. An implementation of ConfigurationLocator is created by constructing an instance of the class name specified in the org.jboss.logmanager.configurationLocator system property.
        Overrides:
        readConfiguration in class java.util.logging.LogManager
        Throws:
        java.io.IOException
        java.lang.SecurityException

      • readConfiguration

        public void readConfiguration​(java.io.InputStream inputStream)
                       throws java.io.IOException,
                              java.lang.SecurityException
        Configure the log manager.
        Overrides:
        readConfiguration in class java.util.logging.LogManager
        Parameters:
        inputStream - the input stream from which the logmanager should be configured
        Throws:
        java.io.IOException
        java.lang.SecurityException

      • construct

        static <T> T construct​(java.lang.Class<? extends T> type,
                       java.lang.String className)
                throws java.io.IOException
        Throws:
        java.io.IOException

      • addPropertyChangeListener

        public void addPropertyChangeListener​(java.beans.PropertyChangeListener l)
        Do nothing. Properties and their listeners are not supported.
        Parameters:
        l - ignored

      • removePropertyChangeListener

        public void removePropertyChangeListener​(java.beans.PropertyChangeListener l)
        Do nothing. Properties and their listeners are not supported.
        Parameters:
        l - ignored

      • getProperty

        public java.lang.String getProperty​(java.lang.String name)
        Does nothing. Properties are not supported.
        Overrides:
        getProperty in class java.util.logging.LogManager
        Parameters:
        name - ignored
        Returns:
        null

      • reset

        public void reset()
        Does nothing. This method only causes trouble.
        Overrides:
        reset in class java.util.logging.LogManager

      • getLoggerNames

        public java.util.Enumeration<java.lang.String> getLoggerNames()
        Overrides:
        getLoggerNames in class java.util.logging.LogManager

      • addLogger

        public boolean addLogger​(java.util.logging.Logger logger)
        Do nothing. Loggers are only added/acquired via getLogger(String).
        Overrides:
        addLogger in class java.util.logging.LogManager
        Parameters:
        logger - ignored
        Returns:
        false

      • getLogger

        public Logger getLogger​(java.lang.String name)
        Get or create a logger with the given name.
        Overrides:
        getLogger in class java.util.logging.LogManager
        Parameters:
        name - the logger name
        Returns:
        the corresponding logger

      • getThreadLocalLogFilter

        public static java.util.logging.Filter getThreadLocalLogFilter()
        Returns the currently set filter for this thread or null if one has not been set.

        If the PER_THREAD_LOG_FILTER_KEY is not set to true then null will always be returned.

        Returns:
        the filter set for the thread or null if no level was set

      • setThreadLocalLogLevel

        public static void setThreadLocalLogLevel​(java.util.logging.Filter filter)
        Sets the filter on the thread for all loggers.

        This feature only works if the PER_THREAD_LOG_FILTER was set to true

        Parameters:
        filter - the filter to set for all loggers on this thread