Modifier and Type	Class and Description
pack-priv static class	Level.KnownLevel
private static class	Level.RbAccess

Field Summary

Modifier and Type	Field and Description
public static final Level	ALL ALL indicates that all messages should be logged.
private transient Locale	cachedLocale
public static final Level	CONFIG CONFIG is a message level for static configuration messages.
private static final String	defaultBundle
public static final Level	FINE FINE is a message level providing tracing information.
public static final Level	FINER FINER indicates a fairly detailed tracing message.
public static final Level	FINEST FINEST indicates a highly detailed tracing message.
public static final Level	INFO INFO is a message level for informational messages.
private transient String	localizedLevelName
private final String	name
public static final Level	OFF OFF is a special level that can be used to turn off logging.
private final String	resourceBundleName
private static final long	serialVersionUID
public static final Level	SEVERE SEVERE is a message level indicating a serious failure.
private static final Level[]	standardLevels
private final int	value
public static final Level	WARNING WARNING is a message level indicating a potential problem.

Constructor Summary

Access	Constructor and Description
protected	Level(String the name of the Level, for example "SEVERE". name, int an integer value for the level. value) Create a named Level with a given integer value.
protected	Level(String the name of the Level, for example "SEVERE". name, int an integer value for the level. value, String name of a resource bundle to use in localizing the given name. If the resourceBundleName is null or an empty string, it is ignored. resourceBundleName) Create a named Level with a given integer value and a given localization resource name.
private	Level(String name, int value, String resourceBundleName, boolean visible)

Method Summary

Modifier and Type	Method and Description
private String	computeLocalizedLevelName(Locale newLocale)
public boolean	Returns: true if and only if the two objects have the same level value. equals(Object the reference object with which to compare. ox) Overrides java.lang.Object.equals. Compare two objects for value equality.
pack-priv static Level	findLevel(String name)
pack-priv final String	getCachedLocalizedLevelName()
pack-priv final String	getLevelName()
pack-priv final synchronized String	getLocalizedLevelName()
public String	Returns: localized name getLocalizedName() Return the localized string name of the Level, for the current default locale.
public String	Returns: non-localized name getName() Return the non-localized string name of the Level.
public String	Returns: localization resource bundle name getResourceBundleName() Return the level's localization resource bundle name, or null if no localization bundle is defined.
public int	Returns: a hashcode based on the level value hashCode() Overrides java.lang.Object.hashCode. Generate a hashcode.
public final int	Returns: the integer value for this level. intValue() Get the integer value for this level.
public static synchronized Level	Returns: The parsed value. Passing an integer that corresponds to a known name (e.g., 700) will return the associated name (e.g., `CONFIG`). Passing an integer that does not (e.g., 1) will return a new level name initialized to that value. parse(String string to be parsed name) Parse a level name string into a Level.
private Object	Returns: a `Level` instance corresponding to the deserialized object. readResolve() Returns a `Level` instance with the same `name`, `value`, and `resourceBundleName` as the deserialized object.
public final String	Returns: the non-localized name of the Level, for example "INFO". toString() Overrides java.lang.Object.toString. Returns a string representation of this Level.

Inherited from java.lang.Object:: clone finalize getClass notify notifyAll wait wait wait

Field Detail

ALL	back to summary
public static final Level ALL ALL indicates that all messages should be logged. This level is initialized to `Integer.MIN_VALUE`.

cachedLocale	back to summary
private transient Locale cachedLocale

CONFIG back to summary

CONFIG	back to summary
public static final Level CONFIG 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`.

public static final Level CONFIG

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.

defaultBundle	back to summary
private static final String defaultBundle

FINE back to summary

FINE	back to summary
public static final Level FINE 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`.

public static final Level FINE

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	back to summary
public static final Level FINER 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	back to summary
public static final Level FINEST FINEST indicates a highly detailed tracing message. This level is initialized to `300`.

INFO back to summary

INFO	back to summary
public static final Level INFO 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 administrators. This level is initialized to `800`.

public static final Level INFO

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 administrators. This level is initialized to 800.

localizedLevelName	back to summary
private transient String localizedLevelName

name	back to summary
private final String name

OFF	back to summary
public static final Level OFF OFF is a special level that can be used to turn off logging. This level is initialized to `Integer.MAX_VALUE`.

resourceBundleName	back to summary
private final String resourceBundleName

serialVersionUID	back to summary
private static final long serialVersionUID Annotations @Serial

SEVERE back to summary

SEVERE	back to summary
public static final Level SEVERE 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`.

public static final Level SEVERE

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.

standardLevels	back to summary
private static final Level[] standardLevels

value	back to summary
private final int value

WARNING back to summary

WARNING	back to summary
public static final Level WARNING 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`.

public static final Level WARNING

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.

Constructor Detail

Level	back to summary
protected Level(String name, int value) 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. Parameters name:String the name of the Level, for example "SEVERE". value:int an integer value for the level. Exceptions NullPointerException: if the name is null

Level

back to summary

protected Level(String name, int value)

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.

Parameters

name:String: the name of the Level, for example "SEVERE".
value:int: an integer value for the level.

Exceptions

NullPointerException:: if the name is null

Level	back to summary
protected Level(String name, int value, String resourceBundleName) Create a named Level with a given integer value and a given localization resource name. Parameters name:String the name of the Level, for example "SEVERE". value:int an integer value for the level. resourceBundleName:String name of a resource bundle to use in localizing the given name. If the resourceBundleName is null or an empty string, it is ignored. Exceptions NullPointerException: if the name is null

Level

back to summary

protected Level(String name, int value, String resourceBundleName)

Create a named Level with a given integer value and a given localization resource name.

Parameters

name:String: the name of the Level, for example "SEVERE".
value:int: an integer value for the level.
resourceBundleName:String: name of a resource bundle to use in localizing the given name. If the resourceBundleName is null or an empty string, it is ignored.

Exceptions

NullPointerException:: if the name is null

Level	back to summary
private Level(String name, int value, String resourceBundleName, boolean visible)

Method Detail

computeLocalizedLevelName	back to summary
private String computeLocalizedLevelName(Locale newLocale)

equals	back to summary
public boolean equals(Object ox) Overrides java.lang.Object.equals. Compare two objects for value equality. Parameters ox:Object Doc from java.lang.Object.equals. the reference object with which to compare. Returns:boolean true if and only if the two objects have the same level value. Annotations @Override

equals

back to summary

public boolean equals(Object ox)

Overrides java.lang.Object.equals.

Compare two objects for value equality.

Parameters

ox:Object

Doc from java.lang.Object.equals.

the reference object with which to compare.

Returns:boolean

true if and only if the two objects have the same level value.

Annotations

@Override

findLevel	back to summary
pack-priv static Level findLevel(String name)

getCachedLocalizedLevelName	back to summary
pack-priv final String getCachedLocalizedLevelName()

getLevelName	back to summary
pack-priv final String getLevelName()

getLocalizedLevelName	back to summary
pack-priv final synchronized String getLocalizedLevelName()

getLocalizedName	back to summary
public String getLocalizedName() 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. Returns:String localized name

getLocalizedName

back to summary

public String getLocalizedName()

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.

Returns:String: localized name

getName	back to summary
public String getName() Return the non-localized string name of the Level. Returns:String non-localized name

getName

back to summary

public String getName()

Return the non-localized string name of the Level.

Returns:String: non-localized name

getResourceBundleName	back to summary
public String getResourceBundleName() Return the level's localization resource bundle name, or null if no localization bundle is defined. Returns:String localization resource bundle name

getResourceBundleName

back to summary

public String getResourceBundleName()

Return the level's localization resource bundle name, or null if no localization bundle is defined.

Returns:String: localization resource bundle name

hashCode	back to summary
public int hashCode() Overrides java.lang.Object.hashCode. Generate a hashcode. Returns:int a hashcode based on the level value Annotations @Override

hashCode

back to summary

public int hashCode()

Overrides java.lang.Object.hashCode.

Generate a hashcode.

Returns:int

a hashcode based on the level value

Annotations

@Override

intValue	back to summary
public final int intValue() Get the integer value for this level. This integer value can be used for efficient ordering comparisons between Level objects. Returns:int the integer value for this level.

intValue

back to summary

public final int intValue()

Get the integer value for this level. This integer value can be used for efficient ordering comparisons between Level objects.

Returns:int: the integer value for this level.

parse back to summary

parse	back to summary
public static synchronized Level parse(String name) throws IllegalArgumentException Parse a level name string into a Level. The argument string may consist of either a level name or an integer value. For example: "SEVERE" "1000" Parameters name:String string to be parsed Returns:Level The parsed value. Passing an integer that corresponds to a known name (e.g., 700) will return the associated name (e.g., `CONFIG`). Passing an integer that does not (e.g., 1) will return a new level name initialized to that value. Exceptions 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. NullPointerException: if the name is null

public static synchronized Level parse(String name) throws IllegalArgumentException

Parse a level name string into a Level.

The argument string may consist of either a level name or an integer value.

For example:

"SEVERE"
"1000"

Parameters

name:String: string to be parsed

Returns:Level

The parsed value. Passing an integer that corresponds to a known name (e.g., 700) will return the associated name (e.g., CONFIG). Passing an integer that does not (e.g., 1) will return a new level name initialized to that value.

Exceptions

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.
NullPointerException:: if the name is null

readResolve back to summary

readResolve	back to summary
private Object readResolve() Returns a `Level` instance with the same `name`, `value`, and `resourceBundleName` as the deserialized object. Returns:Object a `Level` instance corresponding to the deserialized object. Annotations @Serial

private Object readResolve()

Returns a Level instance with the same name, value, and resourceBundleName as the deserialized object.

Returns:Object

a Level instance corresponding to the deserialized object.

Annotations

@Serial

toString	back to summary
public final String toString() Overrides java.lang.Object.toString. Returns a string representation of this Level. Returns:String the non-localized name of the Level, for example "INFO". Annotations @Override

toString

back to summary

public final String toString()

Overrides java.lang.Object.toString.

Returns a string representation of this Level.

Returns:String

the non-localized name of the Level, for example "INFO".

Annotations

@Override

java.util.logging back to summary

pack-priv final Class Level.KnownLevel

Class Inheritance

extends WeakReference<Level>

Field Summary

Modifier and Type	Field and Description
private static final ClassLoaderValue<List<Level>>	CUSTOM_LEVEL_CLV
private static Map<Integer, List<Level.KnownLevel>>	intToLevels
pack-priv final Level	mirroredLevel
private static Map<String, List<Level.KnownLevel>>	nameToLevels
private static final ReferenceQueue<Level>	QUEUE

Constructor Summary

Access	Constructor and Description
pack-priv	KnownLevel(Level l)

Method Summary

Modifier and Type	Method and Description
pack-priv static synchronized void	add(Level l)
pack-priv static synchronized Optional<Level>	findByLocalizedLevelName(String name, Function<Level.KnownLevel, Optional<Level>> selector)
pack-priv static synchronized Optional<Level>	findByName(String name, Function<Level.KnownLevel, Optional<Level>> selector)
pack-priv static synchronized Optional<Level>	findByValue(int value, Function<Level.KnownLevel, Optional<Level>> selector)
pack-priv static synchronized Optional<Level>	matches(Level l)
pack-priv Optional<Level>	mirrored()
pack-priv static synchronized void	purge()
pack-priv Optional<Level>	referent()
private static void	registerWithClassLoader(Level customLevel)
private void	remove()

Field Detail

CUSTOM_LEVEL_CLV	back to summary
private static final ClassLoaderValue<List<Level>> CUSTOM_LEVEL_CLV

intToLevels	back to summary
private static Map<Integer, List<Level.KnownLevel>> intToLevels

mirroredLevel	back to summary
pack-priv final Level mirroredLevel

nameToLevels	back to summary
private static Map<String, List<Level.KnownLevel>> nameToLevels

QUEUE	back to summary
private static final ReferenceQueue<Level> QUEUE

Constructor Detail

KnownLevel	back to summary
pack-priv KnownLevel(Level l)

Method Detail

add	back to summary
pack-priv static synchronized void add(Level l)

findByLocalizedLevelName	back to summary
pack-priv static synchronized Optional<Level> findByLocalizedLevelName(String name, Function<Level.KnownLevel, Optional<Level>> selector)

findByName	back to summary
pack-priv static synchronized Optional<Level> findByName(String name, Function<Level.KnownLevel, Optional<Level>> selector)

findByValue	back to summary
pack-priv static synchronized Optional<Level> findByValue(int value, Function<Level.KnownLevel, Optional<Level>> selector)

matches	back to summary
pack-priv static synchronized Optional<Level> matches(Level l)

mirrored	back to summary
pack-priv Optional<Level> mirrored()

purge	back to summary
pack-priv static synchronized void purge()

referent	back to summary
pack-priv Optional<Level> referent()

registerWithClassLoader	back to summary
private static void registerWithClassLoader(Level customLevel)

remove	back to summary
private void remove()

public Class Level

Nested and Inner Type Summary

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

pack-priv final Class Level.KnownLevel

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail

private final Class Level.RbAccess

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail