001/* ----------------------------------------------------------------------------
002   The Kiwi Toolkit - A Java Class Library
003   Copyright (C) 1998-2004 Mark A. Lindner
004
005   This library is free software; you can redistribute it and/or
006   modify it under the terms of the GNU General Public License as
007   published by the Free Software Foundation; either version 2 of the
008   License, or (at your option) any later version.
009
010   This library is distributed in the hope that it will be useful,
011   but WITHOUT ANY WARRANTY; without even the implied warranty of
012   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
013   General Public License for more details.
014
015   You should have received a copy of the GNU General Public License
016   along with this library; if not, write to the Free Software
017   Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
018   02111-1307, USA.
019 
020   The author may be contacted at: mark_a_lindner@yahoo.com
021   ----------------------------------------------------------------------------
022   $Log: ExceptionHandler.java,v $
023   Revision 1.4  2004/05/05 21:22:45  markl
024   Comment header updates.
025
026   Revision 1.3  2003/01/19 09:42:39  markl
027   Javadoc & comment header updates.
028
029   Revision 1.2  2001/03/12 02:57:39  markl
030   Source code cleanup.
031
032   Revision 1.1  1999/07/25 13:40:17  markl
033   Initial revision
034   ----------------------------------------------------------------------------
035*/
036
037package kiwi.util;
038
039/** An interface for delivering an exception to a handler without using the
040 * <i>try / catch</i> programming construct. Sometimes an exception may be
041 * thrown within a method that cannot itself throw an exception, for example if
042 * the method is an implementation of an interface and that interface does not
043 * define a <i>throws</i> clause for that method's signature.
044 * <p>
045 * This interface may be used to deliver caught Exceptions to an appropriate
046 * handler, perhaps in a different object altogether.
047 *
048 * @author Mark Lindner
049 */
050
051public interface ExceptionHandler
052  {
053  /** Handle an exception.
054   *
055   * @param ex The exception that was raised.
056   */
057  
058  public void exceptionRaised(Exception ex);
059  }
060
061/* end of source file */