File	Doc	Category	Size	Date	Package
Level.java	API Doc	Java SE 5 API	11974	Fri Aug 26 14:57:28 BST 2005	java.util.logging

Level

• java.lang.Object

Fields Summary
private static ArrayList	known
private static String	defaultBundle
private final String	name
private final int	value
private final String	resourceBundleName
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.
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	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	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 admins. This level is initialized to 800.
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	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	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.
public static final Level	FINEST FINEST indicates a highly detailed tracing message. This level is initialized to 300.
public static final Level	ALL ALL indicates that all messages should be logged. This level is initialized to Integer.MIN_VALUE.
private static final long	serialVersionUID

Constructors 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. param name the name of the Level, for example "SEVERE". param value an integer value for the level. throws NullPointerException if the name is null this(name, value, null);
protected Level(String name, int value, String resourceBundleName) Create a named Level with a given integer value and a given localization resource name. param name the name of the Level, for example "SEVERE". param value an integer value for the level. param 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. throws NullPointerException if the name is null if (name == null) { throw new NullPointerException(); } this.name = name; this.value = value; this.resourceBundleName = resourceBundleName; synchronized (Level.class) { known.add(this); }

Methods Summary
public boolean	equals(java.lang.Object ox) Compare two objects for value equality. return true if and only if the two objects have the same level value. try { Level lx = (Level)ox; return (lx.value == this.value); } catch (Exception ex) { return false; }
public java.lang.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. return localized name try { ResourceBundle rb = ResourceBundle.getBundle(resourceBundleName); return rb.getString(name); } catch (Exception ex) { return name; }
public java.lang.String	getName() Return the non-localized string name of the Level. return non-localized name return name;
public java.lang.String	getResourceBundleName() Return the level's localization resource bundle name, or null if no localization bundle is defined. return localization resource bundle name return resourceBundleName;
public int	hashCode() Generate a hashcode. return a hashcode based on the level value return this.value;
public final int	intValue() Get the integer value for this level. This integer value can be used for efficient ordering comparisons between Level objects. return the integer value for this level. return value;
public static synchronized java.util.logging.Level	parse(java.lang.String name) 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" param name string to be parsed throws NullPointerException if the name is null throws 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. return The parsed value. Passing an integer that corresponds to a known name (eg 700) will return the associated name (eg CONFIG). Passing an integer that does not (eg 1) will return a new level name initialized to that value. // Check that name is not null. name.length(); // Look for a known Level with the given non-localized name. for (int i = 0; i < known.size(); i++) { Level l = (Level) known.get(i); if (name.equals(l.name)) { return l; } } // Now, check if the given name is an integer. If so, // first look for a Level with the given value and then // if necessary create one. try { int x = Integer.parseInt(name); for (int i = 0; i < known.size(); i++) { Level l = (Level) known.get(i); if (l.value == x) { return l; } } // Create a new Level. return new Level(name, x); } catch (NumberFormatException ex) { // Not an integer. // Drop through. } // Finally, look for a known level with the given localized name, // in the current default locale. // This is relatively expensive, but not excessively so. for (int i = 0; i < known.size(); i++) { Level l = (Level) known.get(i); if (name.equals(l.getLocalizedName())) { return l; } } // OK, we've tried everything and failed throw new IllegalArgumentException("Bad level \"" + name + "\"");
private java.lang.Object	readResolve() // Serialization magic to prevent "doppelgangers". // This is a performance optimization. synchronized (Level.class) { for (int i = 0; i < known.size(); i++) { Level other = (Level) known.get(i); if (this.name.equals(other.name) && this.value == other.value && (this.resourceBundleName == other.resourceBundleName || (this.resourceBundleName != null && this.resourceBundleName.equals(other.resourceBundleName)))) { return other; } } // Woops. Whoever sent us this object knows // about a new log level. Add it to our list. known.add(this); return this; }
public final java.lang.String	toString() return the non-localized name of the Level, for example "INFO". return name;