Modifier and Type	Class and Description
protected static class	ClassLoaderLogManager.ClassLoaderLogInfo
private class	ClassLoaderLogManager.Cleaner
protected static class	ClassLoaderLogManager.LogNode
protected static class	ClassLoaderLogManager.RootLogger This class is needed to instantiate the root of each per classloader hierarchy.

Modifier and Type	Field and Description
private static ThreadLocal<Boolean>	addingLocalRootLogger
protected final Map<ClassLoader, ClassLoaderLogManager.ClassLoaderLogInfo>	classLoaderLoggers Map containing the classloader information, keyed per classloader.
public static final String	DEBUG_PROPERTY
protected final ThreadLocal<String>	prefix This prefix is used to allow using prefixes for the properties names of handlers and their subcomponents.
protected volatile boolean	useShutdownHook Determines if the shutdown hook is used to perform any necessary clean-up such as flushing buffered handlers on JVM shutdown.

Access	Constructor and Description
public	ClassLoaderLogManager()

Method Summary

Modifier and Type	Method and Description
public synchronized boolean	addLogger(final Logger The logger to be added logger) Overrides java.util.logging.LogManager.addLogger. Add the specified logger to the classloader local configuration.
protected static void	doSetParentLogger(final Logger The logger logger, final Logger The parent logger parent) Set parent child relationship between the two specified loggers.
private synchronized String	findProperty(String name)
pack-priv static ClassLoader	Returns: The class loader to use to lookup loggers, obtain configuration etc. getClassLoader() Obtain the class loader to use to lookup loggers, obtain configuration etc. The search order is: Thread.currentThread().getContextClassLoader() The class laoder of this class
protected synchronized ClassLoaderLogManager.ClassLoaderLogInfo	Returns: the log configuration getClassLoaderInfo(ClassLoader The class loader for which we will retrieve or build the configuration classLoader) Retrieve the configuration associated with the specified classloader.
public synchronized Logger	getLogger(final String The name of the logger to retrieve name) Overrides java.util.logging.LogManager.getLogger. Get the logger associated with the specified name inside the classloader local configuration.
public synchronized Enumeration<String>	getLoggerNames() Overrides java.util.logging.LogManager.getLoggerNames. Get an enumeration of the logger names currently defined in the classloader local configuration.
public String	getProperty(String The property name name) Overrides java.util.logging.LogManager.getProperty. Get the value of the specified property in the classloader local configuration.
public boolean	isUseShutdownHook()
public void	readConfiguration() Overrides java.util.logging.LogManager.readConfiguration. Reads and initializes the logging configuration.
public void	readConfiguration(InputStream stream to read properties from is) Overrides java.util.logging.LogManager.readConfiguration. Reads and initializes the logging configuration from the given input stream.
protected synchronized void	readConfiguration(ClassLoader The classloader classLoader) Read configuration for the specified classloader.
protected synchronized void	readConfiguration(InputStream InputStream to the properties file is, ClassLoader for which the configuration will be loaded classLoader) Load specified configuration.
protected String	Returns: the modified string replace(String The original string str) System property replacement in the given string.
private String	replaceWebApplicationProperties(String propName)
public synchronized void	reset() Overrides java.util.logging.LogManager.reset. Reset the logging configuration.
private void	resetLoggers(ClassLoaderLogManager.ClassLoaderLogInfo clLogInfo)
public void	setUseShutdownHook(boolean useShutdownHook)
public synchronized void	shutdown() Shuts down the logging system.

Inherited from java.util.logging.LogManager:: addConfigurationListener checkAccess getLoggingMXBean getLogManager removeConfigurationListener updateConfiguration updateConfiguration

Field Detail

addingLocalRootLogger	back to summary
private static ThreadLocal<Boolean> addingLocalRootLogger

classLoaderLoggers	back to summary
protected final Map<ClassLoader, ClassLoaderLogManager.ClassLoaderLogInfo> classLoaderLoggers Map containing the classloader information, keyed per classloader. A weak hashmap is used to ensure no classloader reference is leaked from application redeployment.

DEBUG_PROPERTY	back to summary
public static final String DEBUG_PROPERTY

prefix	back to summary
protected final ThreadLocal<String> prefix This prefix is used to allow using prefixes for the properties names of handlers and their subcomponents.

useShutdownHook	back to summary
protected volatile boolean useShutdownHook Determines if the shutdown hook is used to perform any necessary clean-up such as flushing buffered handlers on JVM shutdown. Defaults to `true` but may be set to false if another component ensures that `shutdown()` is called.

Constructor Detail

ClassLoaderLogManager	back to summary
public ClassLoaderLogManager()

Method Detail

addLogger	back to summary
public synchronized boolean addLogger(final Logger logger) Overrides java.util.logging.LogManager.addLogger. Add the specified logger to the classloader local configuration. Parameters logger:Logger The logger to be added Returns:boolean Doc from java.util.logging.LogManager.addLogger. true if the argument logger was registered successfully, false if a logger of that name already exists. Annotations @Override

addLogger

back to summary

public synchronized boolean addLogger(final Logger logger)

Overrides java.util.logging.LogManager.addLogger.

Add the specified logger to the classloader local configuration.

Parameters

logger:Logger: The logger to be added

Returns:boolean

Doc from java.util.logging.LogManager.addLogger.

true if the argument logger was registered successfully, false if a logger of that name already exists.

Annotations

@Override

doSetParentLogger	back to summary
protected static void doSetParentLogger(final Logger logger, final Logger parent) Set parent child relationship between the two specified loggers. Parameters logger:Logger The logger parent:Logger The parent logger

doSetParentLogger

back to summary

protected static void doSetParentLogger(final Logger logger, final Logger parent)

Set parent child relationship between the two specified loggers.

Parameters

logger:Logger: The logger
parent:Logger: The parent logger

findProperty	back to summary
private synchronized String findProperty(String name)

getClassLoader	back to summary
pack-priv static ClassLoader getClassLoader() Obtain the class loader to use to lookup loggers, obtain configuration etc. The search order is: Thread.currentThread().getContextClassLoader() The class laoder of this class Returns:ClassLoader The class loader to use to lookup loggers, obtain configuration etc.

getClassLoader

back to summary

pack-priv static ClassLoader getClassLoader()

Obtain the class loader to use to lookup loggers, obtain configuration etc. The search order is:

Thread.currentThread().getContextClassLoader()
The class laoder of this class

Returns:ClassLoader: The class loader to use to lookup loggers, obtain configuration etc.

getClassLoaderInfo	back to summary
protected synchronized ClassLoaderLogManager.ClassLoaderLogInfo getClassLoaderInfo(ClassLoader classLoader) Retrieve the configuration associated with the specified classloader. If it does not exist, it will be created. If no class loader is specified, the class loader used to load this class is used. Parameters classLoader:ClassLoader The class loader for which we will retrieve or build the configuration Returns:ClassLoaderLogManager.ClassLoaderLogInfo the log configuration

getClassLoaderInfo

back to summary

protected synchronized ClassLoaderLogManager.ClassLoaderLogInfo getClassLoaderInfo(ClassLoader classLoader)

Retrieve the configuration associated with the specified classloader. If it does not exist, it will be created. If no class loader is specified, the class loader used to load this class is used.

Parameters

classLoader:ClassLoader: The class loader for which we will retrieve or build the configuration

Returns:ClassLoaderLogManager.ClassLoaderLogInfo

the log configuration

getLogger	back to summary
public synchronized Logger getLogger(final String name) Overrides java.util.logging.LogManager.getLogger. Get the logger associated with the specified name inside the classloader local configuration. If this returns null, and the call originated for Logger.getLogger, a new logger with the specified name will be instantiated and added using addLogger. Parameters name:String The name of the logger to retrieve Returns:Logger Doc from java.util.logging.LogManager.getLogger. matching logger or null if none is found Annotations @Override

getLogger

back to summary

public synchronized Logger getLogger(final String name)

Overrides java.util.logging.LogManager.getLogger.

Get the logger associated with the specified name inside the classloader local configuration. If this returns null, and the call originated for Logger.getLogger, a new logger with the specified name will be instantiated and added using addLogger.

Parameters

name:String: The name of the logger to retrieve

Returns:Logger

Doc from java.util.logging.LogManager.getLogger.

matching logger or null if none is found

Annotations

@Override

getLoggerNames	back to summary
public synchronized Enumeration<String> getLoggerNames() Overrides java.util.logging.LogManager.getLoggerNames. Get an enumeration of the logger names currently defined in the classloader local configuration. Returns:Enumeration<String> Doc from java.util.logging.LogManager.getLoggerNames. enumeration of logger name strings Annotations @Override

getLoggerNames

back to summary

public synchronized Enumeration<String> getLoggerNames()

Overrides java.util.logging.LogManager.getLoggerNames.

Get an enumeration of the logger names currently defined in the classloader local configuration.

Returns:Enumeration<String>

Doc from java.util.logging.LogManager.getLoggerNames.

enumeration of logger name strings

Annotations

@Override

getProperty	back to summary
public String getProperty(String name) Overrides java.util.logging.LogManager.getProperty. Get the value of the specified property in the classloader local configuration. Parameters name:String The property name Returns:String Doc from java.util.logging.LogManager.getProperty. property value Annotations @Override

getProperty

back to summary

public String getProperty(String name)

Overrides java.util.logging.LogManager.getProperty.

Get the value of the specified property in the classloader local configuration.

Parameters

name:String: The property name

Returns:String

Doc from java.util.logging.LogManager.getProperty.

property value

Annotations

@Override

isUseShutdownHook	back to summary
public boolean isUseShutdownHook()

readConfiguration back to summary

readConfiguration	back to summary
public void readConfiguration() throws IOException, SecurityException Overrides java.util.logging.LogManager.readConfiguration. Doc from java.util.logging.LogManager.readConfiguration. Reads and initializes the logging configuration. If the "java.util.logging.config.class" system property is set, then the property value is treated as a class name. The given class will be loaded, an object will be instantiated, and that object's constructor is responsible for reading in the initial configuration. (That object may use other system properties to control its configuration.) The alternate configuration class can use `readConfiguration(InputStream)` to define properties in the LogManager. If "java.util.logging.config.class" system property is not set, then this method will read the initial configuration from a properties file and calls the `readConfiguration(InputStream)` method to initialize the configuration. The "java.util.logging.config.file" system property can be used to specify the properties file that will be read as the initial configuration; if not set, then the LogManager default configuration is used. The default configuration is typically loaded from the properties file "`conf/logging.properties`" in the Java installation directory. Any registered configuration listener will be invoked after the properties are read. Annotations @Override Exceptions IOException: if there are IO problems reading the configuration. SecurityException: if a security manager exists and if the caller does not have LoggingPermission("control").

public void readConfiguration() throws IOException, SecurityException

Overrides java.util.logging.LogManager.readConfiguration.

Doc from java.util.logging.LogManager.readConfiguration.

Reads and initializes the logging configuration.

If the "java.util.logging.config.class" system property is set, then the property value is treated as a class name. The given class will be loaded, an object will be instantiated, and that object's constructor is responsible for reading in the initial configuration. (That object may use other system properties to control its configuration.) The alternate configuration class can use readConfiguration(InputStream) to define properties in the LogManager.

If "java.util.logging.config.class" system property is not set, then this method will read the initial configuration from a properties file and calls the readConfiguration(InputStream) method to initialize the configuration. The "java.util.logging.config.file" system property can be used to specify the properties file that will be read as the initial configuration; if not set, then the LogManager default configuration is used. The default configuration is typically loaded from the properties file "conf/logging.properties" in the Java installation directory.

Any registered configuration listener will be invoked after the properties are read.

Annotations

@Override

Exceptions

IOException:: if there are IO problems reading the configuration.
SecurityException:: if a security manager exists and if the caller does not have LoggingPermission("control").

readConfiguration	back to summary
public void readConfiguration(InputStream is) throws IOException, SecurityException Overrides java.util.logging.LogManager.readConfiguration. Doc from java.util.logging.LogManager.readConfiguration. Reads and initializes the logging configuration from the given input stream. Any registered configuration listener will be invoked after the properties are read. Parameters is:InputStream stream to read properties from Annotations @Override Exceptions IOException: if there are problems reading from the stream, or the given stream is not in the properties file format. SecurityException: if a security manager exists and if the caller does not have LoggingPermission("control").

readConfiguration

back to summary

public void readConfiguration(InputStream is) throws IOException, SecurityException

Overrides java.util.logging.LogManager.readConfiguration.

Doc from java.util.logging.LogManager.readConfiguration.

Reads and initializes the logging configuration from the given input stream.

Any registered configuration listener will be invoked after the properties are read.

Parameters

is:InputStream: stream to read properties from

Annotations

@Override

Exceptions

IOException:: if there are problems reading from the stream, or the given stream is not in the properties file format.
SecurityException:: if a security manager exists and if the caller does not have LoggingPermission("control").

readConfiguration	back to summary
protected synchronized void readConfiguration(ClassLoader classLoader) throws IOException Read configuration for the specified classloader. Parameters classLoader:ClassLoader The classloader Exceptions IOException: Error reading configuration

readConfiguration

back to summary

protected synchronized void readConfiguration(ClassLoader classLoader) throws IOException

Read configuration for the specified classloader.

Parameters

classLoader:ClassLoader: The classloader

Exceptions

IOException:: Error reading configuration

readConfiguration	back to summary
protected synchronized void readConfiguration(InputStream is, ClassLoader classLoader) throws IOException Load specified configuration. Parameters is:InputStream InputStream to the properties file classLoader:ClassLoader for which the configuration will be loaded Exceptions IOException: If something wrong happens during loading

readConfiguration

back to summary

protected synchronized void readConfiguration(InputStream is, ClassLoader classLoader) throws IOException

Load specified configuration.

Parameters

is:InputStream: InputStream to the properties file
classLoader:ClassLoader: for which the configuration will be loaded

Exceptions

IOException:: If something wrong happens during loading

replace	back to summary
protected String replace(String str) System property replacement in the given string. Parameters str:String The original string Returns:String the modified string

replace

back to summary

protected String replace(String str)

System property replacement in the given string.

Parameters

str:String: The original string

Returns:String

the modified string

replaceWebApplicationProperties	back to summary
private String replaceWebApplicationProperties(String propName)

reset back to summary

reset	back to summary
public synchronized void reset() throws SecurityException Overrides java.util.logging.LogManager.reset. Doc from java.util.logging.LogManager.reset. Reset the logging configuration. For all named loggers, the reset operation removes and closes all Handlers and (except for the root logger) sets the level to `null`. The root logger's level is set to `Level.INFO`. Annotations @Override Exceptions SecurityException: if a security manager exists and if the caller does not have LoggingPermission("control").

public synchronized void reset() throws SecurityException

Overrides java.util.logging.LogManager.reset.

Doc from java.util.logging.LogManager.reset.

Reset the logging configuration.

For all named loggers, the reset operation removes and closes all Handlers and (except for the root logger) sets the level to null. The root logger's level is set to Level.INFO.

Annotations

@Override

Exceptions

SecurityException:: if a security manager exists and if the caller does not have LoggingPermission("control").

resetLoggers	back to summary
private void resetLoggers(ClassLoaderLogManager.ClassLoaderLogInfo clLogInfo)

setUseShutdownHook	back to summary
public void setUseShutdownHook(boolean useShutdownHook)

shutdown	back to summary
public synchronized void shutdown() Shuts down the logging system.

org.apache.juli back to summary

protected final Class ClassLoaderLogManager.ClassLoaderLogInfo

Class Inheritance

extends Object

java.lang.Object
org.apache.juli.ClassLoaderLogManager.ClassLoaderLogInfo

Field Summary

Modifier and Type	Field and Description
pack-priv final Map<String, Handler>	handlers
pack-priv final Map<String, Logger>	loggers
pack-priv final Properties	props
pack-priv final ClassLoaderLogManager.LogNode	rootNode

Constructor Summary

Access	Constructor and Description
pack-priv	ClassLoaderLogInfo(final ClassLoaderLogManager.LogNode rootNode)

Method Summary

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

handlers	back to summary
pack-priv final Map<String, Handler> handlers

loggers	back to summary
pack-priv final Map<String, Logger> loggers

props	back to summary
pack-priv final Properties props

rootNode	back to summary
pack-priv final ClassLoaderLogManager.LogNode rootNode

Constructor Detail

ClassLoaderLogInfo	back to summary
pack-priv ClassLoaderLogInfo(final ClassLoaderLogManager.LogNode rootNode)

org.apache.juli back to summary

private final Class ClassLoaderLogManager.Cleaner

Class Inheritance

extends Thread

java.lang.Object
java.lang.Thread
org.apache.juli.ClassLoaderLogManager.Cleaner

Field Summary

Inherited from java.lang.Thread:: MAX_PRIORITY MIN_PRIORITY NORM_PRIORITY

Constructor Summary

Access	Constructor and Description
private	Cleaner()

Method Summary

Modifier and Type	Method and Description
public void	run() Overrides java.lang.Thread.run. Implements java.lang.Runnable.run. This method is run by the thread when it executes.

Constructor Detail

Cleaner	back to summary
private Cleaner()

Method Detail

run back to summary

run	back to summary
public void run() Overrides java.lang.Thread.run. Implements java.lang.Runnable.run. Doc from java.lang.Thread.run. This method is run by the thread when it executes. Subclasses of `Thread` may override this method. This method is not intended to be invoked directly. If this thread is a platform thread created with a `Runnable` task then invoking this method will invoke the task's `run` method. If this thread is a virtual thread then invoking this method directly does nothing. Annotations @Override

public void run()

Overrides java.lang.Thread.run.

Implements java.lang.Runnable.run.

Doc from java.lang.Thread.run.

This method is run by the thread when it executes. Subclasses of Thread may override this method.

This method is not intended to be invoked directly. If this thread is a platform thread created with a Runnable task then invoking this method will invoke the task's run method. If this thread is a virtual thread then invoking this method directly does nothing.

Annotations

@Override

Modifier and Type	Method and Description
pack-priv ClassLoaderLogManager.LogNode	findNode(String name)
pack-priv Logger	findParentLogger()
pack-priv void	setParentLogger(final Logger parent)

public Class ClassLoaderLogManager

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

protected final Class ClassLoaderLogManager.ClassLoaderLogInfo

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

private final Class ClassLoaderLogManager.Cleaner

Field Summary

Constructor Summary

Method Summary

Constructor Detail

Method Detail

protected final Class ClassLoaderLogManager.LogNode

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

protected Class ClassLoaderLogManager.RootLogger

Field Summary

Constructor Summary

Method Summary

Constructor Detail

Modifier and Type	Field and Description
pack-priv final Map<String, ClassLoaderLogManager.LogNode>	children
pack-priv Logger	logger
pack-priv final ClassLoaderLogManager.LogNode	parent

Access	Constructor and Description
pack-priv	LogNode(final ClassLoaderLogManager.LogNode parent, final Logger logger)
pack-priv	LogNode(final ClassLoaderLogManager.LogNode parent)