001    /*--------------------------------------------------------------------------+
002    $Id: IExceptionHandler.java 26283 2010-02-18 11:18:57Z juergens $
003    |                                                                          |
004    | Copyright 2005-2010 Technische Universitaet Muenchen                     |
005    |                                                                          |
006    | Licensed under the Apache License, Version 2.0 (the "License");          |
007    | you may not use this file except in compliance with the License.         |
008    | You may obtain a copy of the License at                                  |
009    |                                                                          |
010    |    http://www.apache.org/licenses/LICENSE-2.0                            |
011    |                                                                          |
012    | Unless required by applicable law or agreed to in writing, software      |
013    | distributed under the License is distributed on an "AS IS" BASIS,        |
014    | WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
015    | See the License for the specific language governing permissions and      |
016    | limitations under the License.                                           |
017    +--------------------------------------------------------------------------*/
018    package edu.tum.cs.commons.error;
019    
020    /**
021     * Interface for a exception handling routine.
022     * 
023     * @param <X_IN>
024     *            the type of exception being handled.
025     * @param <X_OUT>
026     *            the type of exception being (potentially) thrown. Use
027     *            {@link NeverThrownRuntimeException} if no exception will be thrown
028     *            by this handler.
029     * 
030     * @author hummelb
031     * @author $Author: juergens $
032     * @version $Rev: 26283 $
033     * @levd.rating GREEN Hash: F24A6BA392AA6149C12254D72EB576E7
034     */
035    public interface IExceptionHandler<X_IN extends Exception, X_OUT extends Exception> {
036    
037            /**
038             * Handle the provided exception.
039             * 
040             * @param exception
041             *            the exception being handled.
042             */
043            void handleException(X_IN exception) throws X_OUT;
044    }