Class AppenderLoggingException
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- java.lang.RuntimeException
-
- org.apache.logging.log4j.LoggingException
-
- org.apache.logging.log4j.core.appender.AppenderLoggingException
-
- All Implemented Interfaces:
Serializable
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 theStatusLogger
. 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 theFailoverAppender
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:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description AppenderLoggingException(String message)
Constructs an exception with a message.AppenderLoggingException(String format, Object... args)
Constructs an exception with a message.AppenderLoggingException(String message, Throwable cause)
Constructs an exception with a message and underlying cause.AppenderLoggingException(Throwable cause)
Constructs an exception with an underlying cause.AppenderLoggingException(Throwable cause, String format, Object... args)
Constructs an exception with a message.
-
Method Summary
-
Methods inherited from class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
-
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, seeString.format(String, Object...)
.args
- The reason arguments for the exception, seeString.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 exceptioncause
- 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 exceptionformat
- The reason format for the exception, seeString.format(String, Object...)
.args
- The reason arguments for the exception, seeString.format(String, Object...)
.- Since:
- 2.12.1
-
-