01: /* ====================================================================
02: The Jicarilla Software License
03:
04: Copyright (c) 2003 Leo Simons.
05: All rights reserved.
06:
07: Permission is hereby granted, free of charge, to any person obtaining
08: a copy of this software and associated documentation files (the
09: "Software"), to deal in the Software without restriction, including
10: without limitation the rights to use, copy, modify, merge, publish,
11: distribute, sublicense, and/or sell copies of the Software, and to
12: permit persons to whom the Software is furnished to do so, subject to
13: the following conditions:
14:
15: The above copyright notice and this permission notice shall be
16: included in all copies or substantial portions of the Software.
17:
18: THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
19: EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20: MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
21: IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
22: CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23: TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24: SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25: ==================================================================== */
26: package org.jicarilla.lang;
27:
28: /**
29: * <p>{@link java.awt.event.AWTEventListener AWT-style listener} which can be
30: * notified of any exceptions that occur. Mostly useful as a replacement for
31: * logging statements.</p>
32: *
33: * <p>It is recommended that you use exception listeners everywhere you would
34: * have statements of a form like</p>
35: *
36: * <pre>
37: * logger.warn( "Help!" );
38: *
39: * try {
40: * // possible problem here...
41: * } catch( SomeException se )
42: * {
43: * logger.error( se );
44: * }
45: * </pre>
46: *
47: * <p>This allows for richer exception handling strategies, including logging,
48: * while not sacrificing any functionality. See this <a
49: * href="http://wiki.apache.org/avalon/AvalonNoLogging">whitepaper on the no
50: * logging strategy</a> for more on the subject.</p>
51: *
52: * @author <a href="lsimons at jicarilla dot org">Leo Simons</a>
53: * @version $Id: ExceptionListener.java,v 1.3 2003/12/16 21:20:05 lsimons Exp
54: * $
55: */
56: public interface ExceptionListener {
57: /**
58: * Call any time an exception occurs. Normally, this should only be called
59: * if an exception is not rethrown: otherwise the listener may be notified
60: * of the same exception multiple times.
61: *
62: * Note that implementations of this method should never ever throw an
63: * exception themselves.
64: *
65: * @param t the exception that occured
66: */
67: void exceptionOccurred(Throwable t);
68: }
|