01: /*
02: * Licensed to the Apache Software Foundation (ASF) under one
03: * or more contributor license agreements. See the NOTICE file
04: * distributed with this work for additional information
05: * regarding copyright ownership. The ASF licenses this file
06: * to you under the Apache License, Version 2.0 (the
07: * "License"); you may not use this file except in compliance
08: * with the License. You may obtain a copy of the License at
09: *
10: * http://www.apache.org/licenses/LICENSE-2.0
11: *
12: * Unless required by applicable law or agreed to in writing,
13: * software distributed under the License is distributed on an
14: * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15: * KIND, either express or implied. See the License for the
16: * specific language governing permissions and limitations
17: * under the License.
18: *
19: */
20: package org.apache.mina.common;
21:
22: /**
23: * Monitors uncaught exceptions. {@link #exceptionCaught(Throwable)} is
24: * invoked when there are any uncaught exceptions.
25: * <p>
26: * You can monitor any uncaught exceptions by setting {@link ExceptionMonitor}
27: * by calling {@link #setInstance(ExceptionMonitor)}. The default
28: * monitor logs all caught exceptions in <tt>WARN</tt> level using
29: * SLF4J.
30: *
31: * @author The Apache MINA Project (dev@mina.apache.org)
32: * @version $Rev: 576217 $, $Date: 2007-09-16 17:55:27 -0600 (Sun, 16 Sep 2007) $
33: *
34: * @see DefaultExceptionMonitor
35: */
36: public abstract class ExceptionMonitor {
37: private static ExceptionMonitor instance = new DefaultExceptionMonitor();
38:
39: /**
40: * Returns the current exception monitor.
41: */
42: public static ExceptionMonitor getInstance() {
43: return instance;
44: }
45:
46: /**
47: * Sets the uncaught exception monitor. If <code>null</code> is specified,
48: * the default monitor will be set.
49: *
50: * @param monitor A new instance of {@link DefaultExceptionMonitor} is set
51: * if <tt>null</tt> is specified.
52: */
53: public static void setInstance(ExceptionMonitor monitor) {
54: if (monitor == null) {
55: monitor = new DefaultExceptionMonitor();
56: }
57: instance = monitor;
58: }
59:
60: /**
61: * Invoked when there are any uncaught exceptions.
62: */
63: public abstract void exceptionCaught(Throwable cause);
64: }
|