Class ErrorManager

java.lang.Object
java.util.logging.ErrorManager

public class ErrorManager
extends Object
An error reporting facility for Handler implementations to record any error that may happen during logging. Handlers should report errors to an ErrorManager, instead of throwing exceptions, which would interfere with the log issuer's execution.
  • Field Summary

    Fields
    Modifier and Type Field Description
    static int CLOSE_FAILURE
    The error code indicating a failure when closing an output stream.
    static int FLUSH_FAILURE
    The error code indicating a failure when flushing an output stream.
    static int FORMAT_FAILURE
    The error code indicating a failure when formatting the error messages.
    static int GENERIC_FAILURE
    The error code indicating a failure that does not fit in any of the specific types of failures that follow.
    static int OPEN_FAILURE
    The error code indicating a failure when opening an output stream.
    static int WRITE_FAILURE
    The error code indicating a failure when writing to an output stream.
  • Constructor Summary

    Constructors
    Constructor Description
    ErrorManager()
    Constructs an instance of ErrorManager.
  • Method Summary

    Modifier and Type Method Description
    void error​(String message, Exception exception, int errorCode)
    Reports an error using the given message, exception and error code.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • GENERIC_FAILURE

      public static final int GENERIC_FAILURE
      The error code indicating a failure that does not fit in any of the specific types of failures that follow.
      See Also:
      Constant Field Values
    • WRITE_FAILURE

      public static final int WRITE_FAILURE
      The error code indicating a failure when writing to an output stream.
      See Also:
      Constant Field Values
    • FLUSH_FAILURE

      public static final int FLUSH_FAILURE
      The error code indicating a failure when flushing an output stream.
      See Also:
      Constant Field Values
    • CLOSE_FAILURE

      public static final int CLOSE_FAILURE
      The error code indicating a failure when closing an output stream.
      See Also:
      Constant Field Values
    • OPEN_FAILURE

      public static final int OPEN_FAILURE
      The error code indicating a failure when opening an output stream.
      See Also:
      Constant Field Values
    • FORMAT_FAILURE

      public static final int FORMAT_FAILURE
      The error code indicating a failure when formatting the error messages.
      See Also:
      Constant Field Values
  • Constructor Details

    • ErrorManager

      public ErrorManager()
      Constructs an instance of ErrorManager.
  • Method Details

    • error

      public void error​(String message, Exception exception, int errorCode)
      Reports an error using the given message, exception and error code. This implementation will write out the message to System.err on the first call and all subsequent calls are ignored. A subclass of this class should override this method.
      Parameters:
      message - the error message, which may be null.
      exception - the exception associated with the error, which may be null.
      errorCode - the error code that identifies the type of error; see the constant fields of this class for possible values.