FileDocCategorySizeDatePackage
ErrorHandler.javaAPI DocApache log4j 1.2.152941Sat Aug 25 00:09:40 BST 2007org.apache.log4j.spi

ErrorHandler

public interface ErrorHandler implements OptionHandler
Appenders may delegate their error handling to ErrorHandlers.

Error handling is a particularly tedious to get right because by definition errors are hard to predict and to reproduce.

Please take the time to contact the author in case you discover that errors are not properly handled. You are most welcome to suggest new error handling policies or criticize existing policies.

author
Ceki Gülcü

Fields Summary
Constructors Summary
Methods Summary
public voiderror(java.lang.String message, java.lang.Exception e, int errorCode)
Equivalent to the {@link #error(String, Exception, int, LoggingEvent event)} with the the event parameteter set to null.

public voiderror(java.lang.String message)
This method is normally used to just print the error message passed as a parameter.

public voiderror(java.lang.String message, java.lang.Exception e, int errorCode, org.apache.log4j.spi.LoggingEvent event)
This method is invoked to handle the error.

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

public voidsetAppender(org.apache.log4j.Appender appender)
Set the appender for which errors are handled. This method is usually called when the error handler is configured.

since
1.2

public voidsetBackupAppender(org.apache.log4j.Appender appender)
Set the appender to falkback upon in case of failure.

since
1.2

public voidsetLogger(org.apache.log4j.Logger logger)
Add a reference to a logger to which the failing appender might be attached to. The failing appender will be searched and replaced only in the loggers you add through this method.

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