Initial check-in of preliminary, possibly buggy version.

1 files changed, 293 insertions, 0 deletions

diff --git a/java/util/logging/Level.java b/java/util/logging/Level.java
new file mode 100644
index 000000000..1577015cb
--- /dev/null
+++ b/java/util/logging/Level.java
@@ -0,0 +1,293 @@
+/* Level.java -- a class for indicating logging levels
+   Copyright (C) 2002 Free Software Foundation, Inc.
+
+This file is part of GNU Classpath.
+
+GNU Classpath is free software; you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation; either version 2, or (at your option)
+any later version.
+
+GNU Classpath is distributed in the hope that it will be useful, but
+WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with GNU Classpath; see the file COPYING.  If not, write to the
+Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
+02111-1307 USA.
+
+Linking this library statically or dynamically with other modules is
+making a combined work based on this library.  Thus, the terms and
+conditions of the GNU General Public License cover the whole
+combination.
+
+As a special exception, the copyright holders of this library give you
+permission to link this library with independent modules to produce an
+executable, regardless of the license terms of these independent
+modules, and to copy and distribute the resulting executable under
+terms of your choice, provided that you also meet, for each linked
+independent module, the terms and conditions of the license of that
+module.  An independent module is a module which is not derived from
+or based on this library.  If you modify this library, you may extend
+this exception to your version of the library, but you are not
+obligated to do so.  If you do not wish to do so, delete this
+exception statement from your version.
+
+*/
+
+
+package java.util.logging;
+
+import java.util.ResourceBundle;
+
+
+/**
+ * A class for indicating logging levels.  A number of commonly used
+ * levels is pre-defined (such as <code>java.util.logging.Level.INFO</code>),
+ * and applications should utilize those whenever possible.  For specialized
+ * purposes, however, applications can sub-class Level in order to define
+ * custom logging levels.
+ *
+ * @author Sascha Brawer <brawer@acm.org>
+ */
+public class Level
+  implements java.io.Serializable
+{
+  public static final Level OFF = new Level ("OFF", Integer.MAX_VALUE);
+  public static final Level SEVERE = new Level ("SEVERE", 10000);
+  public static final Level WARNING = new Level ("WARNING", 9000);
+  public static final Level INFO = new Level ("INFO", 8000);
+  public static final Level CONFIG = new Level ("CONFIG", 7000);
+  public static final Level FINE = new Level ("FINE", 6000);
+  public static final Level FINER = new Level ("FINER", 5000);
+  public static final Level FINEST = new Level ("FINEST", 4000);
+  public static final Level ALL = new Level ("ALL", Integer.MIN_VALUE);
+
+  private static final Level[] knownLevels = {
+    ALL, FINEST, FINER, FINE, CONFIG, INFO, WARNING, SEVERE, OFF
+  };
+
+
+  /**
+   * The name of the Level without localizing it, for example
+   * "WARNING".
+   */
+  private String name;
+
+
+  /**
+   * The integer value of this <code>Level</code>.
+   */
+  private int value;
+
+
+  /**
+   * The name of the resource bundle used for localizing the level
+   * name, or <code>null</code> if the name does not undergo
+   * localization.
+   */
+  private String resourceBundleName;
+
+
+  /**
+   * Creates a logging level given a name and an integer value.
+   * It rarely is necessary to create custom levels,
+   * as most applications should be well served with one of the
+   * standard levels such as <code>Level.CONFIG</code>,
+   * <code>Level.INFO</code>, or <code>Level.FINE</code>.
+   *
+   * @param name the name of the level.
+   *
+   * @param value the integer value of the level.  Please note
+   *     that the Java<small><sup>TM</sup></small>
+   *     Logging API does not specify integer
+   *	 values for standard levels (such as
+   *	 Level.FINE).  Therefore, a custom
+   *	 level should pass an integer value that
+   *	 is calculated at run-time, e.g.
+   *	 <code>(Level.FINE.intValue() + Level.CONFIG.intValue())
+   *	 / 2</code> for a level between FINE and CONFIG.
+   */
+  protected Level(String name, int value)
+  {
+    this(name, value, null);
+  }
+
+
+  /**
+   * Create a logging level given a name, an integer value and a name
+   *  of a resource bundle for localizing the level name.  It rarely
+   *  is necessary to create custom levels, as most applications
+   *  should be well served with one of the standard levels such as
+   *  <code>Level.CONFIG</code>, <code>Level.INFO</code>, or
+   *  <code>Level.FINE</code>.
+   *
+   *  @param name the name of the level.
+   *
+   *  @param value the integer value of the level.  Please note
+   *       that the Java<small><sup>TM</sup></small>
+   *	   Logging API does not specify integer
+   *	   values for standard levels (such as
+   *	   Level.FINE).  Therefore, a custom
+   *	   level should pass an integer value that
+   *	   is calculated at run-time, e.g.
+   *	   <code>(Level.FINE.intValue() + Level.CONFIG.intValue())
+   *	   / 2</code> for a level between FINE and CONFIG.
+   *
+   *  @param resourceBundleName the name of a resource bundle
+   *       for localizing the level name, or <code>null</code>
+   *       if the name does not need to be localized.
+   */
+  protected Level(String name, int value, String resourceBundleName)
+  {
+    this.name = name;
+    this.value = value;
+    this.resourceBundleName = resourceBundleName;
+  }
+
+
+  private Object readResolve()
+  {
+    for (int i = 0; i < knownLevels.length; i++)
+      if (value == knownLevels[i].intValue())
+	return knownLevels[i];
+
+    return this;
+  }
+
+
+  /**
+   * Returns the name of the resource bundle used for localizing the
+   * level name.
+   *
+   * @return the name of the resource bundle used for localizing the
+   * level name, or <code>null</code> if the name does not undergo
+   * localization.
+   */
+  public String getResourceBundleName()
+  {
+    return resourceBundleName;
+  }
+
+
+  /**
+   * Returns the name of the Level without localizing it, for example
+   * "WARNING".
+   */
+  public String getName()
+  {
+    return name;
+  }
+
+
+  /**
+   * Returns the name of the Level after localizing it, for example
+   * "WARNUNG".
+   */
+  public String getLocalizedName()
+  {
+    String localizedName = null;
+
+    if (resourceBundleName != null)
+    {
+      try
+      {
+        ResourceBundle b = ResourceBundle.getBundle(resourceBundleName);
+	localizedName = b.getString(name);
+      }
+      catch (Exception _)
+      {
+      }
+    }
+
+    if (localizedName != null)
+      return localizedName;
+    else
+      return name;
+  }
+
+
+  /**
+   * Returns the name of the Level without localizing it, for example
+   * "WARNING".
+   */
+  public final String toString()
+  {
+    return getName ();
+  }
+
+
+  /**
+   * Returns the integer value of the Level.
+   */
+  public final int intValue()
+  {
+    return value;
+  }
+
+
+  /**
+   * Returns one of the standard Levels given either its name or its integer value.
+   * Custom subclasses of Level will not be returned by this method.
+   *
+   * @throws IllegalArgumentException if <code>name</code> is neither the name
+   *   nor the integer value of one of the pre-defined standard logging levels.
+   *
+   * @throws NullPointerException if <code>name</code> is null.
+   *
+   */
+  public static Level parse(String name)
+    throws IllegalArgumentException
+  {
+    /* This will throw a NullPointerException if name is null,
+     * as required by the API specification.
+     */
+    name = name.intern();
+
+    for (int i = 0; i < knownLevels.length; i++)
+    {
+      if (name == knownLevels[i].name)
+	return knownLevels[i];
+    }
+    
+    try
+    {
+      int num = Integer.parseInt(name);
+      for (int i = 0; i < knownLevels.length; i++)
+	if (num == knownLevels[i].value)
+	  return knownLevels[i];
+    }
+    catch (NumberFormatException _)
+    {
+    }
+
+    String msg = "Not the name of standard logging level: \"" + name + "\"";
+    throw new IllegalArgumentException(msg);
+  }
+
+
+  /**
+   * Checks whether this Level's integer value is equal to that of another
+   * object.
+   *
+   * @return <code>true</code> if <code>other</code> is an instance of
+   *	 <code>java.util.logging.Level</code> and has the same integer value,
+   *	 <code>false</code> otherwise.
+   */
+  public boolean equals(Object other)
+  {
+    if (!(other instanceof Level))
+      return false;
+
+    return value == ((Level) other).value;
+  }
+
+
+  public int hashCode()
+  {
+    return value;
+  }  
+}
+