org.jboss.logmanager

Class LogManager

java.lang.Object

java.util.logging.LogManager

org.jboss.logmanager.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.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	LogManager.KnownLevelBuilder
private static class	LogManager.LocalFilterHolder
private static class	LogManager.ReadOnlyArrayList<T>
private static class	LogManager.ReadOnlyHashMap<K,V>
private static class	LogManager.ReadOnlyMapEntry<K,V>

Field Summary

Fields

Modifier and Type	Field and 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 and Description
LogManager() Construct a new logmanager instance.

Method Summary

Modifier and Type	Method and 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

checkAccess, getLoggingMXBean, getLogManager

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.

Overrides:

addPropertyChangeListener in class java.util.logging.LogManager

Parameters:

l - ignored

removePropertyChangeListener

public void removePropertyChangeListener(java.beans.PropertyChangeListener l)

Do nothing. Properties and their listeners are not supported.

Overrides:

removePropertyChangeListener in class java.util.logging.LogManager

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