X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=unused%2Fsrcjar_unused%2Forg%2Fapache%2Flog4j%2Fspi%2FErrorHandler.java;fp=unused%2Fsrcjar_unused%2Forg%2Fapache%2Flog4j%2Fspi%2FErrorHandler.java;h=d629a2dbd26c4b53e8e25a68c2464ed2f2b1ae0e;hb=7e01e1b3e9c8abdf952e085dba51e9266f12b1ee;hp=0000000000000000000000000000000000000000;hpb=88635c3965bb2f1f45e53c2d5f66fed19b93012a;p=jalview.git
diff --git a/unused/srcjar_unused/org/apache/log4j/spi/ErrorHandler.java b/unused/srcjar_unused/org/apache/log4j/spi/ErrorHandler.java
new file mode 100644
index 0000000..d629a2d
--- /dev/null
+++ b/unused/srcjar_unused/org/apache/log4j/spi/ErrorHandler.java
@@ -0,0 +1,92 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+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);
+}