java.lang.Object | |
↳ | java.util.logging.Level |
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.
Clients should normally use the predefined Level constants such as Level.SEVERE.
The levels in descending order are:
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.
Fields | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
ALL | ALL indicates that all messages should be logged. | ||||||||||
CONFIG | CONFIG is a message level for static configuration messages. | ||||||||||
FINE | FINE is a message level providing tracing information. | ||||||||||
FINER | FINER indicates a fairly detailed tracing message. | ||||||||||
FINEST | FINEST indicates a highly detailed tracing message. | ||||||||||
INFO | INFO is a message level for informational messages. | ||||||||||
OFF | OFF is a special level that can be used to turn off logging. | ||||||||||
SEVERE | SEVERE is a message level indicating a serious failure. | ||||||||||
WARNING | WARNING is a message level indicating a potential problem. |
Protected Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Create a named Level with a given integer value.
| |||||||||||
Create a named Level with a given integer value and a
given localization resource name.
|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Compare two objects for value equality.
| |||||||||||
Return the localized string name of the Level, for
the current default locale.
| |||||||||||
Return the non-localized string name of the Level.
| |||||||||||
Return the level's localization resource bundle name, or
null if no localization bundle is defined.
| |||||||||||
Generate a hashcode.
| |||||||||||
Get the integer value for this level.
| |||||||||||
Parse a level name string into a Level.
| |||||||||||
Returns a string representation of the object.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
ALL indicates that all messages should be logged.
This level is initialized to Integer.MIN_VALUE
.
CONFIG is a message level for static configuration messages.
CONFIG 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.
All 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
.
FINEST indicates a highly detailed tracing message.
This level is initialized to 300
.
INFO is a message level for informational messages.
Typically 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
.
SEVERE is a message level indicating a serious failure.
In 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
.
Create a named Level with a given integer value.
Note that this constructor is "protected" to allow subclassing. In general clients of logging should use one of the constant Level objects such as SEVERE or FINEST. However, if clients need to add new logging levels, they may subclass Level and define new constants.
name | the name of the Level, for example "SEVERE". |
---|---|
value | an integer value for the level. |
NullPointerException | if the name is null |
---|
Create a named Level with a given integer value and a given localization resource name.
name | the name of the Level, for example "SEVERE". |
---|---|
value | an integer value for the level. |
resourceBundleName | name of a resource bundle to use in localizing the given name. If the resourceBundleName is null or an empty string, it is ignored. |
NullPointerException | if the name is null |
---|
Compare two objects for value equality.
ox | the reference object with which to compare. |
---|
Return the localized string name of the Level, for the current default locale.
If no localization information is available, the non-localized name is returned.
Return the non-localized string name of the Level.
Return the level's localization resource bundle name, or null if no localization bundle is defined.
Generate a hashcode.
Get the integer value for this level. This integer value can be used for efficient ordering comparisons between Level objects.
Parse a level name string into a Level.
The argument string may consist of either a level name or an integer value.
For example:
name | string to be parsed |
---|
CONFIG
).
Passing an integer that does not (eg 1) will return a new level name
initialized to that value.
NullPointerException | if the name is null |
---|---|
IllegalArgumentException | if the value is not valid.
Valid values are integers between Integer.MIN_VALUE
and Integer.MAX_VALUE , and all known level names.
Known names are the levels defined by this class (i.e. FINE ,
FINER , FINEST ), or created by this class with
appropriate package access, or new levels defined or created
by subclasses. |
Returns a string representation of the object. In general, the
toString
method returns a string that
"textually represents" this object. The result should
be a concise but informative representation that is easy for a
person to read.
It is recommended that all subclasses override this method.
The toString
method for class Object
returns a string consisting of the name of the class of which the
object is an instance, the at-sign character `@
', and
the unsigned hexadecimal representation of the hash code of the
object. In other words, this method returns a string equal to the
value of:
getClass().getName() + '@' + Integer.toHexString(hashCode())