Package java.util.logging

Class Level

java.lang.Object
java.util.logging.Level
All Implemented Interfaces:
Serializable
public class Level
extends Object
implements Serializable
Level objects are used to indicate the level of logging. There are a set of predefined logging levels, each associated with an integer value. Enabling a certain logging level also enables all logging levels with larger values.

The predefined levels in ascending order are FINEST, FINER, FINE, CONFIG, INFO, WARNING, SEVERE. There are two additional predefined levels, which are ALL and OFF. ALL indicates logging all messages, and OFF indicates logging no messages.

See Also:
Serialized Form

  • Field Summary

    Fields
    Modifier and Type Field Description
    static Level ALL
    The ALL level provides all logging messages.
    static Level CONFIG
    The CONFIG level provides static configuration messages.
    static Level FINE
    The FINE level provides tracing messages.
    static Level FINER
    The FINER level provides more detailed tracing messages.
    static Level FINEST
    The FINEST level provides highly detailed tracing messages.
    static Level INFO
    The INFO level provides informative messages.
    static Level OFF
    The OFF level provides no logging messages.
    static Level SEVERE
    The SEVERE level provides severe failure messages.
    static Level WARNING
    The WARNING level provides warnings.

  • Constructor Summary

    Constructors
    Modifier Constructor Description
    protected Level​(String name, int level)
    Constructs an instance of Level taking the supplied name and level value.
    protected Level​(String name, int level, String resourceBundleName)
    Constructs an instance of Level taking the supplied name, level value and resource bundle name.

  • Method Summary

    Modifier and Type Method Description
    boolean equals​(Object o)
    Compares two Level objects for equality.
    String getLocalizedName()
    Gets the localized name of this level.
    String getName()
    Gets the name of this level.
    String getResourceBundleName()
    Gets the name of the resource bundle associated with this level.
    int hashCode()
    Returns the hash code of this Level object.
    int intValue()
    Gets the integer value indicating this level.
    static Level parse​(String name)
    Parses a level name into a Level object.
    String toString()
    Returns the string representation of this Level object.

    Methods inherited from class java.lang.Object

    clone, finalize, getClass, notify, notifyAll, wait, wait, wait

  • Field Details

    • OFF

      public static final Level OFF
      The OFF level provides no logging messages.

    • SEVERE

      public static final Level SEVERE
      The SEVERE level provides severe failure messages.

    • WARNING

      public static final Level WARNING
      The WARNING level provides warnings.

    • INFO

      public static final Level INFO
      The INFO level provides informative messages.

    • CONFIG

      public static final Level CONFIG
      The CONFIG level provides static configuration messages.

    • FINE

      public static final Level FINE
      The FINE level provides tracing messages.

    • FINER

      public static final Level FINER
      The FINER level provides more detailed tracing messages.

    • FINEST

      public static final Level FINEST
      The FINEST level provides highly detailed tracing messages.

    • ALL

      public static final Level ALL
      The ALL level provides all logging messages.

  • Constructor Details

    • Level

      protected Level​(String name, int level)
      Constructs an instance of Level taking the supplied name and level value.
      Parameters:
      name - the name of the level.
      level - an integer value indicating the level.
      Throws:
      NullPointerException - if name is null.

    • Level

      protected Level​(String name, int level, String resourceBundleName)
      Constructs an instance of Level taking the supplied name, level value and resource bundle name.
      Parameters:
      name - the name of the level.
      level - an integer value indicating the level.
      resourceBundleName - the name of the resource bundle to use.
      Throws:
      NullPointerException - if name is null.

  • Method Details

    • parse

      public static Level parse​(String name) throws IllegalArgumentException
      Parses a level name into a Level object.
      Parameters:
      name - the name of the desired level, which cannot be null.
      Returns:
      the level with the specified name.
      Throws:
      NullPointerException - if name is null.
      IllegalArgumentException - if name is not valid.

    • getName

      public String getName()
      Gets the name of this level.
      Returns:
      this level's name.

    • getResourceBundleName

      public String getResourceBundleName()
      Gets the name of the resource bundle associated with this level.
      Returns:
      the name of this level's resource bundle.

    • intValue

      public final int intValue()
      Gets the integer value indicating this level.
      Returns:
      this level's integer value.

    • getLocalizedName

      public String getLocalizedName()
      Gets the localized name of this level. The default locale is used. If no resource bundle is associated with this level then the original level name is returned.
      Returns:
      the localized name of this level.

    • equals

      public boolean equals​(Object o)
      Compares two Level objects for equality. They are considered to be equal if they have the same level value.
      Overrides:
      equals in class Object
      Parameters:
      o - the other object to compare this level to.
      Returns:
      true if this object equals to the supplied object, false otherwise.
      See Also:
      Object.hashCode()

    • hashCode

      public int hashCode()
      Returns the hash code of this Level object.
      Overrides:
      hashCode in class Object
      Returns:
      this level's hash code.
      See Also:
      Object.equals(java.lang.Object)

    • toString

      public final String toString()
      Returns the string representation of this Level object. In this case, it is the level's name.
      Overrides:
      toString in class Object
      Returns:
      the string representation of this level.