public class

FallbackErrorHandler

extends Object
implements ErrorHandler
java.lang.Object
   ↳ org.apache.log4j.varia.FallbackErrorHandler

Class Overview

The FallbackErrorHandler implements the ErrorHandler interface such that a secondary appender may be specified. This secondary appender takes over if the primary appender fails for whatever reason.

The error message is printed on System.err, and logged in the new secondary appender.

Summary

Public Constructors
FallbackErrorHandler()
Public Methods
void activateOptions()
No options to activate.
void error(String message)
Print a the error message passed as parameter on System.err.
void error(String message, Exception e, int errorCode)
Prints the message and the stack trace of the exception on System.err.
void error(String message, Exception e, int errorCode, LoggingEvent event)
Prints the message and the stack trace of the exception on System.err.
void setAppender(Appender primary)
The appender to which this error handler is attached.
void setBackupAppender(Appender backup)
Set the backup appender.
void setLogger(Logger logger)
Adds the logger passed as parameter to the list of loggers that we need to search for in case of appender failure.
[Expand]
Inherited Methods
From class java.lang.Object
From interface org.apache.log4j.spi.ErrorHandler
From interface org.apache.log4j.spi.OptionHandler

Public Constructors

public FallbackErrorHandler ()

Public Methods

public void activateOptions ()

No options to activate.

public void error (String message)

Print a the error message passed as parameter on System.err.

public void error (String message, Exception e, int errorCode)

Prints the message and the stack trace of the exception on System.err.

public void error (String message, Exception e, int errorCode, LoggingEvent event)

Prints the message and the stack trace of the exception on System.err.

Parameters
message The message assoicated with the error.
e The Exption that was thrown when the error occured.
errorCode The error code associated with the error.
event The logging event that the failing appender is asked to log.

public void setAppender (Appender primary)

The appender to which this error handler is attached.

public void setBackupAppender (Appender backup)

Set the backup appender.

public void setLogger (Logger logger)

Adds the logger passed as parameter to the list of loggers that we need to search for in case of appender failure.

Parameters
logger One of the loggers that will be searched for the failing appender in view of replacement.