Class 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.
    • Field Detail

      • 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 Detail

      • ErrorManager

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

      • 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.