public class Level
extends java.lang.Object
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.
Modifier and Type | Field and Description |
---|---|
static Level |
ALL
ALL indicates that all messages should be logged.
|
static Level |
CONFIG
CONFIG is a message level for static configuration messages.
|
static Level |
FINE
FINE is a message level providing tracing information.
|
static Level |
FINER
FINER indicates a fairly detailed tracing message.
|
static Level |
FINEST
FINEST indicates a highly detailed tracing message.
|
static Level |
INFO
INFO is a message level for informational messages.
|
static Level |
OFF
OFF is a special level that can be used to turn off logging.
|
static Level |
SEVERE
SEVERE is a message level indicating a serious failure.
|
static Level |
WARNING
WARNING is a message level indicating a potential problem.
|
Modifier | Constructor and Description |
---|---|
protected |
Level(java.lang.String name,
int value)
Create a named Level with a given integer value.
|
Modifier and Type | Method and Description |
---|---|
boolean |
equals(java.lang.Object ox)
Compare two objects for value equality.
|
java.lang.String |
getName()
Return the non-localized string name of the Level.
|
int |
hashCode()
Generate a hashcode.
|
int |
intValue()
Get the integer value for this level.
|
static Level |
parse(java.lang.String name)
Parse a level name string into a Level.
|
java.lang.String |
toString()
Returns a string representation of this Level.
|
public static final Level OFF
Integer.MAX_VALUE
.public static final Level SEVERE
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
.
public static final Level WARNING
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
.
public static final Level INFO
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 administrators. This level
is initialized to 800
.
public static final Level CONFIG
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
.
public static final Level FINE
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
.
public static final Level FINER
400
.public static final Level FINEST
300
.public static final Level ALL
Integer.MIN_VALUE
.protected Level(java.lang.String name, int 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.java.lang.NullPointerException
- if the name is nullpublic java.lang.String getName()
public final java.lang.String toString()
toString
in class java.lang.Object
public final int intValue()
public static Level parse(java.lang.String name) throws java.lang.IllegalArgumentException
The argument string may consist of either a level name or an integer value.
For example:
name
- string to be parsedCONFIG
). Passing an integer that does not (e.g., 1)
will return a new level name initialized to that value.java.lang.NullPointerException
- if the name is nulljava.lang.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 (e.g.,
FINE
, FINER
, FINEST
),
or created by this class with appropriate package access, or
new levels defined or created by subclasses.public boolean equals(java.lang.Object ox)
equals
in class java.lang.Object
public int hashCode()
hashCode
in class java.lang.Object
Copyright (c) 2013, Oracle and/or its affiliates. All rights reserved.