java.lang.Object | +--java.util.logging.LogManager
LogManager() |
synchronized boolean | addLogger(java.util.logging.Logger logger) Adds a named logger. |
synchronized void | addPropertyChangeListener(java.beans.PropertyChangeListener listener) Registers a listener which will be notified when the logging properties are re-read. |
void | checkAccess() Checks whether the current security context allows changing the configuration of the logging framework. |
static java.util.logging.LogManager | getLogManager() Returns the globally shared LogManager instance. |
synchronized java.util.logging.Logger | getLogger(java.lang.String name) Returns a Logger given its name. |
synchronized java.util.Enumeration | getLoggerNames() Returns an Enumeration of currently registered Logger names. |
synchronized java.lang.String | getProperty(java.lang.String name) Returns the value of a configuration property as a String. |
synchronized void | readConfiguration() Configures the logging framework by reading a configuration file. |
synchronized void | readConfiguration(java.io.InputStream inputStream) |
synchronized void | removePropertyChangeListener(java.beans.PropertyChangeListener listener) Unregisters a listener. |
synchronized void | reset() Resets the logging configuration by removing all handlers for
registered named loggers and setting their level to |
protected LogManager()
public synchronized boolean addLogger(java.util.logging.Logger logger)
false
without adding the logger.
The LogManager
only keeps weak references
to registered loggers. Therefore, names can become available
after automatic garbage collection.
logger
- the logger to be added.trueif logger
was added,
false
otherwise.
NullPointerException
- if name is
null
.
public synchronized void addPropertyChangeListener(java.beans.PropertyChangeListener listener)
listener
- public void checkAccess()
SecurityException
- if a security manager exists and
the caller is not granted the permission to control
the logging infrastructure.public static LogManager getLogManager()
public synchronized Logger getLogger(java.lang.String name)
name
- the name of the logger.null
if there is no
logger with that name.public synchronized Enumeration getLoggerNames()
public synchronized String getProperty(java.lang.String name)
name
- public synchronized void readConfiguration()
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(java.io.InputStream), which will notify registered listeners after having read the properties.
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 synchronized void readConfiguration(java.io.InputStream inputStream)
Parameters:inputStream
- public synchronized void removePropertyChangeListener(java.beans.PropertyChangeListener listener)
listener
has not been registered previously,
nothing happens. Also, no exception is thrown if
listener
is null
.
listener
- public synchronized void reset()
null
.
The level of the root logger will be set to Level.INFO
.
SecurityException
- if a security manager exists and
the caller is not granted the permission to control
the logging infrastructure.
LogManager
maintains a hierarchical namespace of Logger objects and manages properties for configuring the logging framework. There exists only one singleLogManager
per virtual machine. This instance can be retrieved using the static method #getLogManager().Configuration Process: The global LogManager object is created and configured when the class
java.util.logging.LogManager
is initialized. The configuration process includes the subsequent steps:java.util.logging.manager
is set to the name of a subclass ofjava.util.logging.LogManager
, an instance of that subclass is created and becomes the global LogManager. Otherwise, a new instance of LogManager is created.LogManager
constructor tries to create a new instance of the class specified by the system propertyjava.util.logging.config.class
. Typically, the constructor of this class will callLogManager.getLogManager().readConfiguration(java.io.InputStream)
for configuring the logging framework. The configuration process stops at this point if the system propertyjava.util.logging.config.class
is set (irrespective of whether the class constructor could be called or an exception was thrown).java.util.logging.config.class
is not set, the configuration parameters are read in from a file and passed to #readConfiguration(java.io.InputStream). The name and location of this file are specified by the system propertyjava.util.logging.config.file
.java.util.logging.config.file
is not set, however, the contents of the URL "{gnu.classpath.home.url}/logging.properties" are passed to #readConfiguration(java.io.InputStream). Here, "{gnu.classpath.home.url}" stands for the value of the system propertygnu.classpath.home.url
.