View Javadoc

1   /*
2    * EL4J, the Extension Library for the J2EE, adds incremental enhancements to
3    * the spring framework, http://el4j.sf.net
4    * Copyright (C) 2005 by ELCA Informatique SA, Av. de la Harpe 22-24,
5    * 1000 Lausanne, Switzerland, http://www.elca.ch
6    *
7    * EL4J is published under the GNU Lesser General Public License (LGPL)
8    * Version 2.1. See http://www.gnu.org/licenses/
9    *
10   * This program is distributed in the hope that it will be useful,
11   * but WITHOUT ANY WARRANTY; without even the implied warranty of
12   * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13   * GNU Lesser General Public License for more details.
14   *
15   * For alternative licensing, please contact info@elca.ch
16   */
17  
18  package ch.elca.el4j.services.exceptionhandler;
19  
20  import org.aopalliance.intercept.MethodInvocation;
21  
22  import ch.elca.el4j.services.exceptionhandler.handler.ExceptionHandler;
23  
24  /**
25   * The exception configuration is used to determine, whether a exception handler
26   * is able to handle a given exception that was thrown in a given method
27   * invocation.
28   *
29   * @svnLink $Revision: 3875 $;$Date: 2009-08-04 14:35:53 +0200 (Di, 04. Aug 2009) $;$Author: swismer $;$URL: https://el4j.svn.sourceforge.net/svnroot/el4j/branches/el4j_3_1/el4j/framework/modules/exception_handling/src/main/java/ch/elca/el4j/services/exceptionhandler/ExceptionConfiguration.java $
30   *
31   * @author Andreas Bur (ABU)
32   */
33  public interface ExceptionConfiguration {
34  
35  	/**
36  	 * Requests whether this exception configuration is able to handle the
37  	 * given exception that was thrown in the given method invocation.
38  	 *
39  	 * @param t
40  	 *      The exception to handle.
41  	 *
42  	 * @param invocation
43  	 *      The invocation in which the exception was thrown.
44  	 *
45  	 * @return Returns <code>true</code> if this exception configuratin is able
46  	 *      to handle the exception, <code>false</code> otherwise.
47  	 */
48  	public boolean handlesExceptions(Throwable t, MethodInvocation invocation);
49  	
50  	/**
51  	 * @return Returns the exception handler.
52  	 */
53  	public ExceptionHandler getExceptionHandler();
54  }