|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object java16.util.logging.LogManager
public class LogManager
Field Summary | |
---|---|
static java.lang.String |
LOGGING_MXBEAN_NAME
String representation of the javax.management.ObjectName for LoggingMXBean . |
Method Summary | |
---|---|
boolean |
addLogger(Logger logger)
Add a named logger. |
void |
addPropertyChangeListener(java.beans.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(java.lang.String name)
Method to find a named logger. |
java.util.Enumeration<java.lang.String> |
getLoggerNames()
Get an enumeration of known logger names. |
static java.util.logging.LoggingMXBean |
getLoggingMXBean()
Returns LoggingMXBean for managing loggers. |
static LogManager |
getLogManager()
Return the global LogManager object. |
java.lang.String |
getProperty(java.lang.String name)
Get the value of a logging property. |
void |
readConfiguration()
Reinitialize the logging properties and reread the logging configuration. |
void |
readConfiguration(java.io.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(java.beans.PropertyChangeListener l)
Removes an event listener for property change events. |
void |
reset()
Reset the logging configuration. |
Methods inherited from class java.lang.Object |
---|
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
---|
public static final java.lang.String LOGGING_MXBEAN_NAME
javax.management.ObjectName
for LoggingMXBean
.
Method Detail |
---|
public static LogManager getLogManager()
public void addPropertyChangeListener(java.beans.PropertyChangeListener l) throws java.lang.SecurityException
l
- event listener
java.lang.SecurityException
- if a security manager exists and if
the caller does not have LoggingPermission("control").
java.lang.NullPointerException
- if the PropertyChangeListener is null.public void removePropertyChangeListener(java.beans.PropertyChangeListener l) throws java.lang.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)
java.lang.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.
java.lang.NullPointerException
- if the logger name is null.public Logger getLogger(java.lang.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 java.util.Enumeration<java.lang.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 java.io.IOException, java.lang.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.
java.lang.SecurityException
- if a security manager exists and if
the caller does not have LoggingPermission("control").
java.io.IOException
- if there are IO problems reading the configuration.public void reset() throws java.lang.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.
java.lang.SecurityException
- if a security manager exists and if
the caller does not have LoggingPermission("control").public void readConfiguration(java.io.InputStream ins) throws java.io.IOException, java.lang.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
java.lang.SecurityException
- if a security manager exists and if
the caller does not have LoggingPermission("control").
java.io.IOException
- if there are problems reading from the stream.public java.lang.String getProperty(java.lang.String name)
name
- property name
public void checkAccess() throws java.lang.SecurityException
If the check fails we throw a SecurityException, otherwise we return normally.
java.lang.SecurityException
- if a security manager exists and if
the caller does not have LoggingPermission("control").public static java.util.logging.LoggingMXBean getLoggingMXBean()
platform MBeanServer
method.
LoggingMXBean
object.java.lang.management.ManagementFactory
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |