|
Generated by JDiff |
||||||||
PREV PACKAGE NEXT PACKAGE FRAMES NO FRAMES |
This file contains all the changes in documentation in the packagejava.util.logging
as colored differences. Deletions are shownlike this, and additions are shown like this.
If no deletions or additions are shown in an entry, the HTML tags will be what has changed. The new HTML tags are shown in the differences. If no documentation existed, and then some was added in a later version, this change is noted in the appropriate class pages of differences, but the change is not shown on this page. Only changes in existing text are shown here. Similarly, documentation which was inherited from another class or interface is not shown here.
Note that an HTML error in the new documentation may cause the display of other documentation changes to be presented incorrectly. For instance, failure to close a <code> tag will cause all subsequent paragraphs to be displayed differently.
The Level class defines a set of standard logging levels that can be used to control logging output. The logging Level objects are ordered and are specified by ordered integers. Enabling logging at a given level also enables logging at all higher levels.Class Level, Level ALLClients should normally use the predefined Level constants such as Level.SEVERE.
The levels in descending order are:
In addition there is a level OFF that can be used to turn off logging and a level ALL that can be used to enable logging of all messages.
- SEVERE (highest value)
- WARNING
- INFO
- CONFIG
- FINE
- FINER
- FINEST (lowest value)
It is possible for third parties to define additional logging levels by subclassing Level. In such cases subclasses should take care to chose unique integer level values and to ensure that they maintain the Object uniqueness property across serialization by defining a suitable readResolve method. @version 1.
9 1210 02/0325/0102 @since 1.4
ALL indicates that all messages should be logged. This level is initialized to Integer.MIN_VALUE
.
Class Level, Level CONFIGCONFIG is a message level for static configuration messages.Class Level, Level FINECONFIG messages are intended to provide a variety of static configuration information to assist in debugging problems that may be associated with particular configurations. For example CONFIG message might include the CPU type the graphics depth the GUI look-and-feel etc. This level is initialized to
700
.
FINE is a message level providing tracing information.Class Level, Level FINERAll of FINE FINER and FINEST are intended for relatively detailed tracing. The exact meaning of the three levels will vary between subsystems but in general FINEST should be used for the most voluminous detailed output FINER for somewhat less detailed output and FINE for the lowest volume (and most important) messages.
In general the FINE level should be used for information that will be broadly interesting to developers who do not have a specialized interest in the specific subsystem.
FINE messages might include things like minor (recoverable) failures. Issues indicating potential performance problems are also worth logging as FINE. This level is initialized to
500
.
FINER indicates a fairly detailed tracing message. By default logging calls for entering returning or throwing an exception are traced at this level. This level is initialized to 400
.
Class Level, Level FINESTFINEST indicates a highly detailed tracing message. This level is initialized to 300
.
Class Level, Level INFOINFO is a message level for informational messages.Class Level, Level OFFTypically INFO messages will be written to the console or its equivalent. So the INFO level should only be used for reasonably significant messages that will make sense to end users and system admins. This level is initialized to
800
.
OFF is a special level that can be used to turn off logging. This level is initialized to Integer.MAX_VALUE
.
Class Level, Level SEVERESEVERE is a message level indicating a serious failure.Class Level, Level WARNINGIn general SEVERE messages should describe events that are of considerable importance and which will prevent normal program execution. They should be reasonably intelligible to end users and to system administrators. This level is initialized to
1000
.
WARNING is a message level indicating a potential problem.In general WARNING messages should describe events that will be of interest to end users or system managers or which indicate potential problems. This level is initialized to
900
.
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).Class LoggingPermission, constructor LoggingPermission(String, String)Currently there is only one named LoggingPermission. This is "control" and it grants the ability to control the logging configuration for example by adding or removing Handlers by adding or removing Filters or by changing logging levels.
Programmers do not normally create LoggingPermission objects directly. Instead they are created by the security policy code based on reading the security policy file. @version 1.
5 126 02/03/01/02 @since 1.4 @see java.security.BasicPermission @see java.security.Permission @see java.security.Permissions @see java.security.PermissionCollection @see java.lang.SecurityManager
Creates a new LoggingPermission object.This constructor exists for use by the Policy object to instantiate new Permission objects.@param name Permission name. Must be "control". @param actions Must be either null or the empty string. @throws IllegalArgumentException if arguments are invalid
Simple network logging Handler.LogRecords are published to a network stream connection. By default the XMLFormatter class is used for formatting.
Configuration: By default each SocketHandler is initialized using the following LogManager configuration properties. If properties are not defined (or have invalid values) then the specified default values are used.
- java.util.logging.SocketHandler.level specifies the default level for the Handler (defaults to Level.ALL).
- java.util.logging.SocketHandler.filter specifies the name of a Filter class to use (defaults to no Filter).
- java.util.logging.SocketHandler.formatter specifies the name of a Formatter class to use (defaults to java.util.logging.XMLFormatter).
- java.util.logging.SocketHandler.encoding the name of the character set encoding to use (defaults to the default platform encoding).
- java.util.logging.SocketHandler.host specifies the target host name to connect to (no default).
- java.util.logging.SocketHandler.port specifies the target TCP port to use (no default).
The output IO stream is buffered but is flushed after each LogRecord is written. @version 1.
1112 02/0321/0102 @since 1.4