|
Préférences
Moteurs de recherche
|
||||||||||||||||||||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.6.0
java.util.logging
|
Field Summary | |
---|---|
static String |
LOGGING_MXBEAN_NAME
String representation of the ObjectName for LoggingMXBean . |
Constructor Summary | |
---|---|
protected |
LogManager()
Protected constructor. |
Method Summary | |
---|---|
boolean |
addLogger(Logger logger)
Add a named logger. |
void |
addPropertyChangeListener(PropertyChangeListener l)
Adds an event listener to be invoked when the logging properties are re-read. |
void |
checkAccess()
Check that the current context is trusted to modify the logging configuration. |
Logger |
getLogger(String name)
Method to find a named logger. |
Enumeration<String> |
getLoggerNames()
Get an enumeration of known logger names. |
static LoggingMXBean |
getLoggingMXBean()
Returns LoggingMXBean for managing loggers. |
static LogManager |
getLogManager()
Return the global LogManager object. |
String |
getProperty(String name)
Get the value of a logging property. |
void |
readConfiguration()
Reinitialize the logging properties and reread the logging configuration. |
void |
readConfiguration(InputStream ins)
Reinitialize the logging properties and reread the logging configuration from the given stream, which should be in java.util.Properties format. |
void |
removePropertyChangeListener(PropertyChangeListener l)
Removes an event listener for property change events. |
void |
reset()
Reset the logging configuration. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final String LOGGING_MXBEAN_NAME
ObjectName
for LoggingMXBean
.
Constructor Detail |
---|
protected LogManager()
Method Detail |
---|
public static LogManager getLogManager()
public void addPropertyChangeListener(PropertyChangeListener l) throws SecurityException
l
- event listener
SecurityException
- if a security manager exists and if
the caller does not have LoggingPermission("control").
NullPointerException
- if the PropertyChangeListener is null.public void removePropertyChangeListener(PropertyChangeListener l) throws SecurityException
addPropertyChangeListener
,
then an equivalent number of
removePropertyChangeListener
invocations are required to remove
all instances of that listener from the listener table.
Returns silently if the given listener is not found.
l
- event listener (can be null)
SecurityException
- if a security manager exists and if
the caller does not have LoggingPermission("control").public boolean addLogger(Logger logger)
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.
logger
- the new logger.
NullPointerException
- if the logger name is null.public Logger getLogger(String name)
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.
name
- name of the logger
public Enumeration<String> getLoggerNames()
Note: Loggers may be added dynamically as new classes are loaded. This method only reports on the loggers that are currently registered.
public void readConfiguration() throws IOException, SecurityException
The same rules are used for locating the configuration properties as are used at startup. So normally the logging properties will be re-read from the same file that was used at startup.
Any log level definitions in the new configuration file will be applied using Logger.setLevel(), if the target Logger exists.
A PropertyChangeEvent will be fired after the properties are read.
SecurityException
- if a security manager exists and if
the caller does not have LoggingPermission("control").
IOException
- if there are IO problems reading the configuration.public void reset() throws SecurityException
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.
SecurityException
- if a security manager exists and if
the caller does not have LoggingPermission("control").public void readConfiguration(InputStream ins) throws IOException, SecurityException
Any log level definitions in the new configuration file will be applied using Logger.setLevel(), if the target Logger exists.
ins
- stream to read properties from
SecurityException
- if a security manager exists and if
the caller does not have LoggingPermission("control").
IOException
- if there are problems reading from the stream.public String getProperty(String name)
name
- property name
public void checkAccess() throws SecurityException
If the check fails we throw a SecurityException, otherwise we return normally.
SecurityException
- if a security manager exists and if
the caller does not have LoggingPermission("control").public static LoggingMXBean getLoggingMXBean()
platform MBeanServer
method.
LoggingMXBean
object.ManagementFactory