Class LogManager

public static final String LOGGING_MXBEAN_NAME

The object name for the logging management bean.

Field Value:

"java.util.logging:type=Logging"

Since:

1.5

protected LogManager()

The basic constructor. Object is special, because it has no superclass, so there is no call to super().

public boolean addLogger(Logger logger)

Adds a named logger. If a logger with the same name has already been registered, the method returns false without adding the logger.

The LogManager only keeps weak references to registered loggers. Therefore, names can become available after automatic garbage collection.

Parameters:

logger - the logger to be added.

Returns:

trueif logger was added, false otherwise.

Throws:

NullPointerException - if name is null.

public void addPropertyChangeListener(PropertyChangeListener listener)

Registers a listener which will be notified when the logging properties are re-read.

public void checkAccess()
            throws SecurityException

Checks whether the current security context allows changing the configuration of the logging framework. For the security context to be trusted, it has to be granted a LoggingPermission("control").

Throws:

SecurityException - if a security manager exists and the caller is not granted the permission to control the logging infrastructure.

public static LogManager getLogManager()

Returns the globally shared LogManager instance.

public Logger getLogger(String name)

Returns a Logger given its name.

Parameters:

name - the name of the logger.

Returns:

a named Logger, or null if there is no logger with that name.

public Enumeration getLoggerNames()

Returns an Enumeration of currently registered Logger names. Since other threads can register loggers at any time, the result could be different any time this method is called.

Returns:

an Enumeration with the names of the currently registered Loggers.

public static LoggingMXBean getLoggingMXBean()

Return the logging bean. There is a single logging bean per VM instance.

Since:

1.5

public String getProperty(String name)

Returns the value of a configuration property as a String.

public void readConfiguration()
            throws IOException,
                   SecurityException

Configures the logging framework by reading a configuration file. The name and location of this file are specified by the system property java.util.logging.config.file. If this property is not set, the URL "{gnu.classpath.home.url}/logging.properties" is taken, where "{gnu.classpath.home.url}" stands for the value of the system property gnu.classpath.home.url.

The task of configuring the framework is then delegated to readConfiguration(InputStream), which will notify registered listeners after having read the properties.

Throws:

SecurityException - if a security manager exists and the caller is not granted the permission to control the logging infrastructure, or if the caller is not granted the permission to read the configuration file.

IOException - if there is a problem reading in the configuration file.

public void readConfiguration(InputStream inputStream)
            throws IOException,
                   SecurityException

public void removePropertyChangeListener(PropertyChangeListener listener)

Unregisters a listener. If listener has not been registered previously, nothing happens. Also, no exception is thrown if listener is null.

public void reset()
            throws SecurityException

Resets the logging configuration by removing all handlers for registered named loggers and setting their level to null. The level of the root logger will be set to Level.INFO.

Throws:

SecurityException - if a security manager exists and the caller is not granted the permission to control the logging infrastructure.