1 /* 2 * Copyright 1999-2004 The Apache Software Foundation 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 12 * implied. 13 * 14 * See the License for the specific language governing permissions and 15 * limitations under the License. 16 */ 17 package org.apache.log; 18 19 /** 20 * Handle unrecoverable errors that occur during logging. 21 * Based on Log4js notion of ErrorHandlers. 22 * 23 * @author Peter Donald 24 */ 25 public interface ErrorHandler 26 { 27 /** 28 * Log an unrecoverable error. 29 * 30 * @param message the error message 31 * @param throwable the exception associated with error (may be null) 32 * @param event the LogEvent that caused error, if any (may be null) 33 */ 34 void error( String message, Throwable throwable, LogEvent event ); 35 } 36