There are four main target uses of the logs:
The key elements of this package include:
The Logging APIs offer both static and dynamic configuration control. Static control enables field service staff to set up a particular configuration and then re-launch the application with the new logging settings. Dynamic control allows for updates to the logging configuration within a currently running program. The APIs also allow for logging to be enabled or disabled for different functional areas of the system. For example, a field service engineer might be interested in tracing all AWT events, but might have no interest in socket events or memory management.
In general, unless otherwise noted in the javadoc, methods and constructors will throw NullPointerException if passed a null argument. The one broad exception to this rule is that the logging convenience methods in the Logger class (the config, entering, exiting, fine, finer, finest, log, logp, logrb, severe, throwing, and warning methods) will accept null values for all arguments except for the initial Level argument (if any).
For an overview of control flow, please refer to the Java Logging Overview
Class | Description |
---|---|
ConsoleHandler | This Handler publishes log records to System.err . |
ErrorManager | ErrorManager objects can be attached to Handlers to process any error that occurs on a Handler during Logging. |
FileHandler | Simple file logging Handler . |
Filter | A Filter can be used to provide fine grain control over what is logged, beyond the control provided by log levels. |
Formatter | A Formatter provides support for formatting LogRecords. |
Handler | A Handler object takes log messages from a Logger and exports them. |
Level | The Level class defines a set of standard logging levels that can be used to control logging output. |
Logger | A Logger object is used to log messages for a specific system or application component. |
LoggingMXBean | Deprecated. |
LoggingPermission | The permission which the SecurityManager will check when code that is running with a SecurityManager calls one of the logging control methods (such as Logger.setLevel). |
LogManager | There is a single global LogManager object that is used to maintain a set of shared state about Loggers and log services. |
LogRecord | LogRecord objects are used to pass logging requests between the logging framework and individual log Handlers. |
MemoryHandler | Handler that buffers requests in a circular buffer in memory. |
SimpleFormatter | Print a brief summary of the LogRecord in a human readable format. |
SocketHandler | Simple network logging Handler . |
StreamHandler | Stream based logging Handler . |
XMLFormatter | Format a LogRecord into a standard XML format. |
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.logging/java/util/logging/package-summary.html
LoggingMXBean
is no longer aplatform MXBean
and is replaced withPlatformLoggingMXBean
.