content: /*
   * Copyright (c) 2001, 2004, Oracle and/or its affiliates. All rights reserved.
   * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   *
   * This code is free software; you can redistribute it and/or modify it
   * under the terms of the GNU General Public License version 2 only, as
   * published by the Free Software Foundation.  Oracle designates this
   * particular file as subject to the "Classpath" exception as provided
   * by Oracle in the LICENSE file that accompanied this code.
   *
   * This code 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
   * version 2 for more details (a copy is included in the LICENSE file that
   * accompanied this code).
   *
   * You should have received a copy of the GNU General Public License version
   * 2 along with this work; if not, write to the Free Software Foundation,
   * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
   *
   * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
   * or visit www.oracle.com if you need additional information or have any
   * questions.
   */
  
  
  package java.util.logging;
  
  /**
   * ErrorManager objects can be attached to Handlers to process
   * any error that occurs on a Handler during Logging.
   * <p>
   * When processing logging output, if a Handler encounters problems
   * then rather than throwing an Exception back to the issuer of
   * the logging call (who is unlikely to be interested) the Handler
   * should call its associated ErrorManager.
   */
  
  public class ErrorManager {
     private boolean reported = false;
  
      /*
       * We declare standard error codes for important categories of errors.
       */
  
      /**
       * GENERIC_FAILURE is used for failure that don't fit
       * into one of the other categories.
       */
      public final static int GENERIC_FAILURE = 0;
      /**
       * WRITE_FAILURE is used when a write to an output stream fails.
       */
      public final static int WRITE_FAILURE = 1;
      /**
       * FLUSH_FAILURE is used when a flush to an output stream fails.
       */
      public final static int FLUSH_FAILURE = 2;
      /**
       * CLOSE_FAILURE is used when a close of an output stream fails.
       */
      public final static int CLOSE_FAILURE = 3;
      /**
       * OPEN_FAILURE is used when an open of an output stream fails.
       */
      public final static int OPEN_FAILURE = 4;
      /**
       * FORMAT_FAILURE is used when formatting fails for any reason.
       */
      public final static int FORMAT_FAILURE = 5;
  
      /**
       * The error method is called when a Handler failure occurs.
       * <p>
       * This method may be overridden in subclasses.  The default
       * behavior in this base class is that the first call is
       * reported to System.err, and subsequent calls are ignored.
       *
       * @param msg    a descriptive string (may be null)
       * @param ex     an exception (may be null)
       * @param code   an error code defined in ErrorManager
       */
      public synchronized void error(String msg, Exception ex, int code) {
          if (reported) {
              // We only report the first error, to avoid clogging
              // the screen.
              return;
          }
          reported = true;
          String text = "java.util.logging.ErrorManager: " + code;
          if (msg != null) {
              text = text + ": " + msg;
          }
          System.err.println(text);
          if (ex != null) {
              ex.printStackTrace();
          }
      }
  }
  