Apache Log4j JUL Adapter 2.22.0 · org.apache.logging.log4j.jul.LogManager

Log4j implementation of java.util.logging.LogManager. Note that the system property java.util.logging.manager must be set to org.apache.logging.log4j.jul.LogManager in order to use this adaptor. This LogManager requires the log4j-api library to be available. If log4j-core is also available, then more features of java.util.logging.Logger are supported.

To override the default AbstractLoggerAdapter that is used, specify the Log4j property log4j.jul.LoggerAdapter and set it to the fully qualified class name of a custom implementation. All implementations must have a default constructor.

Modifier and Type	Field and Description
private static final Logger	LOGGER
private final AbstractLoggerAdapter	loggerAdapter
private final ThreadLocal<Set<String>>	recursive

Access	Constructor and Description
public	LogManager()

Modifier and Type	Method and Description
public boolean	addLogger(final Logger the new logger. logger) Overrides java.util.logging.LogManager.addLogger. Add a named logger.
public Logger	getLogger(final String name of the logger name) Overrides java.util.logging.LogManager.getLogger. Method to find a named logger.
public Enumeration<String>	getLoggerNames() Overrides java.util.logging.LogManager.getLoggerNames. Get an enumeration of known logger names.

LOGGER	back to summary
private static final Logger LOGGER

loggerAdapter	back to summary
private final AbstractLoggerAdapter loggerAdapter

recursive	back to summary
private final ThreadLocal<Set<String>> recursive

LogManager	back to summary
public LogManager()

Method Detail

addLogger	back to summary
public boolean addLogger(final Logger logger) Overrides java.util.logging.LogManager.addLogger. Doc from java.util.logging.LogManager.addLogger. Add a named logger. This does nothing and returns false if a logger with the same name is already registered. The Logger factory methods call this method to register each newly created Logger. The application should retain its own reference to the Logger object to avoid it being garbage collected. The LogManager may only retain a weak reference. Parameters logger:Logger the new logger. Returns:boolean true if the argument logger was registered successfully, false if a logger of that name already exists. Annotations @Override

addLogger

back to summary

public boolean addLogger(final Logger logger)

Overrides java.util.logging.LogManager.addLogger.

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

Add a named logger. This does nothing and returns false if a logger with the same name is already registered.

The Logger factory methods call this method to register each newly created Logger.

The application should retain its own reference to the Logger object to avoid it being garbage collected. The LogManager may only retain a weak reference.

Parameters

logger:Logger: the new logger.

Returns:boolean

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

Annotations

@Override

getLogger back to summary

getLogger	back to summary
public Logger getLogger(final String name) Overrides java.util.logging.LogManager.getLogger. Doc from java.util.logging.LogManager.getLogger. Method to find a named logger. Note that since untrusted code may create loggers with arbitrary names this method should not be relied on to find Loggers for security sensitive logging. It is also important to note that the Logger associated with the String `name` may be garbage collected at any time if there is no strong reference to the Logger. The caller of this method must check the return value for null in order to properly handle the case where the Logger has been garbage collected. Parameters name:String name of the logger Returns:Logger matching logger or null if none is found Annotations @Override

public Logger getLogger(final String name)

Overrides java.util.logging.LogManager.getLogger.

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

Method to find a named logger.

Note that since untrusted code may create loggers with arbitrary names this method should not be relied on to find Loggers for security sensitive logging. It is also important to note that the Logger associated with the String name may be garbage collected at any time if there is no strong reference to the Logger. The caller of this method must check the return value for null in order to properly handle the case where the Logger has been garbage collected.

Parameters

name:String: name of the logger

Returns:Logger

matching logger or null if none is found

Annotations

@Override

getLoggerNames back to summary

getLoggerNames	back to summary
public Enumeration<String> getLoggerNames() Overrides java.util.logging.LogManager.getLoggerNames. Doc from java.util.logging.LogManager.getLoggerNames. Get an enumeration of known logger names. Note Loggers may be added dynamically as new classes are loaded. This method only reports on the loggers that are currently registered. It is also important to note that this method only returns the name of a Logger, not a strong reference to the Logger itself. The returned String does nothing to prevent the Logger from being garbage collected. In particular, if the returned name is passed to `LogManager.getLogger()`, then the caller must check the return value from `LogManager.getLogger()` for null to properly handle the case where the Logger has been garbage collected in the time since its name was returned by this method. Returns:Enumeration<String> enumeration of logger name strings Annotations @Override

public Enumeration<String> getLoggerNames()

Overrides java.util.logging.LogManager.getLoggerNames.

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

Get an enumeration of known logger names.

Note

Loggers may be added dynamically as new classes are loaded. This method only reports on the loggers that are currently registered. It is also important to note that this method only returns the name of a Logger, not a strong reference to the Logger itself. The returned String does nothing to prevent the Logger from being garbage collected. In particular, if the returned name is passed to LogManager.getLogger(), then the caller must check the return value from LogManager.getLogger() for null to properly handle the case where the Logger has been garbage collected in the time since its name was returned by this method.

Returns:Enumeration<String>

enumeration of logger name strings

Annotations

@Override

public Class LogManager

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail