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.handler;
19  
20  import org.aopalliance.intercept.MethodInvocation;
21  import org.slf4j.Logger;
22  
23  import ch.elca.el4j.services.exceptionhandler.AbstractExceptionHandlerInterceptor;
24  import ch.elca.el4j.services.exceptionhandler.RetryException;
25  
26  /**
27   * This class simplifies the implementation of exception handlers that use
28   * another implementation with the same semantic to fulfil the callers
29   * invocation. This is achieved by reconfiguring the class that is advised by
30   * this exception handler's interceptor.
31   *
32   * @svnLink $Revision: 3873 $;$Date: 2009-08-04 13:59:45 +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/handler/AbstractReconfigureExceptionHandler.java $
33   *
34   * @author Andreas Bur (ABU)
35   * @see ch.elca.el4j.services.exceptionhandler.handler.AbstractSwappableTargetExceptionHandler
36   */
37  public abstract class AbstractReconfigureExceptionHandler extends
38  		AbstractRetryExceptionHandler {
39  
40  	/**
41  	 * {@inheritDoc}
42  	 */
43  	protected Object retry(Throwable t,
44  			AbstractExceptionHandlerInterceptor exceptionInvoker,
45  			MethodInvocation invocation, Logger logger) throws Throwable {
46  
47  		reconfigure(t, invocation, logger);
48  		throw new RetryException(getRetries());
49  	}
50  
51  	/**
52  	 * Subclasses have to reconfigure the advised target.
53  	 *
54  	 * @param t
55  	 *      The exception that caused this strategy. Subclasses may distinguish
56  	 *      between different exception types.
57  	 *
58  	 * @param invocation
59  	 *      The original invocation that failed.
60  	 *
61  	 * @param logger
62  	 *      The logger.
63  	 */
64  	protected abstract void reconfigure(Throwable t,
65  			MethodInvocation invocation, Logger logger);
66  }