alvinalexander.com | career | drupal | java | mac | mysql | perl | scala | uml | unix  

What this is

This file is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Java by Example" TM.

Other links

The source code

/*
 * Copyright (C) The Apache Software Foundation. All rights reserved.
 *
 * This software is published under the terms of the Apache Software
 * License version 1.1, a copy of which has been included with this
 * distribution in the LICENSE.txt file.  */

package org.apache.log4j.spi;

import org.apache.log4j.Appender;
import org.apache.log4j.Logger;


/**
   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ü */ public interface ErrorHandler extends OptionHandler { /** 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 */ void setLogger(Logger logger); /** Equivalent to the {@link #error(String, Exception, int, LoggingEvent event)} with the the event parameteter set to null. */ void error(String message, Exception e, int errorCode); /** This method is normally used to just print the error message passed as a parameter. */ void error(String message); /** 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 */ void error(String message, Exception e, int errorCode, LoggingEvent event); /** Set the appender for which errors are handled. This method is usually called when the error handler is configured. @since 1.2 */ void setAppender(Appender appender); /** Set the appender to falkback upon in case of failure. @since 1.2 */ void setBackupAppender(Appender appender); }

... this post is sponsored by my books ...

#1 New Release!

FP Best Seller

 

new blog posts

 

Copyright 1998-2021 Alvin Alexander, alvinalexander.com
All Rights Reserved.

A percentage of advertising revenue from
pages under the /java/jwarehouse URI on this website is
paid back to open source projects.