Class AppenderLoggingException

All Implemented Interfaces:
Serializable
Direct Known Subclasses:
DbAppenderLoggingException

public class AppenderLoggingException extends LoggingException
Thrown from an appender when a log event could not be written. Appenders should not thrown an exception if an error occurs that does not stop the event from being successfully written. Those types of errors should be logged using the StatusLogger. Appenders should only throw exceptions when an error prevents an event from being written. Appenders must throw an exception in this case so that error-handling features like the FailoverAppender work properly.

Also note that appenders must provide a way to suppress exceptions when the user desires and abide by that instruction. See Appender.ignoreExceptions(), which is the standard way to do this.

See Also:
  • Constructor Details

    • AppenderLoggingException

      public AppenderLoggingException(String message)
      Constructs an exception with a message.
      Parameters:
      message - The reason for the exception
    • AppenderLoggingException

      public AppenderLoggingException(String format, Object... args)
      Constructs an exception with a message.
      Parameters:
      format - The reason format for the exception, see String.format(String, Object...).
      args - The reason arguments for the exception, see String.format(String, Object...).
      Since:
      2.12.1
    • AppenderLoggingException

      public AppenderLoggingException(String message, Throwable cause)
      Constructs an exception with a message and underlying cause.
      Parameters:
      message - The reason for the exception
      cause - The underlying cause of the exception
    • AppenderLoggingException

      public AppenderLoggingException(Throwable cause)
      Constructs an exception with an underlying cause.
      Parameters:
      cause - The underlying cause of the exception
    • AppenderLoggingException

      public AppenderLoggingException(Throwable cause, String format, Object... args)
      Constructs an exception with a message.
      Parameters:
      cause - The underlying cause of the exception
      format - The reason format for the exception, see String.format(String, Object...).
      args - The reason arguments for the exception, see String.format(String, Object...).
      Since:
      2.12.1