org.springframework.retry.annotation

Class RecoverAnnotationRecoveryHandler<T>

java.lang.Object

org.springframework.retry.annotation.RecoverAnnotationRecoveryHandler<T>

Type Parameters:

T - the type of the return value from the recovery

All Implemented Interfaces:

MethodInvocationRecoverer<T>

public class RecoverAnnotationRecoveryHandler<T>
extends Object
implements MethodInvocationRecoverer<T>

A recoverer for method invocations based on the @Recover annotation. A suitable recovery method is one with a Throwable type as the first parameter and the same return type and arguments as the method that failed. The Throwable first argument is optional and if omitted the method is treated as a default (called when there are no other matches). Generally the best matching method is chosen based on the type of the first parameter and the type of the exception being handled. The closest match in the class hierarchy is chosen, so for instance if an IllegalArgumentException is being handled and there is a method whose first argument is RuntimeException, then it will be preferred over a method whose first argument is Throwable.

Author:

Dave Syer, Josh Long, Aldo Sinanaj, Randell Callahan, Nathanaël Roberts, Maksim Kita, Gary Russell

Constructor Summary

Constructors

Constructor and Description
RecoverAnnotationRecoveryHandler(Object target, Method method)

Method Summary

Modifier and Type	Method and Description
T	recover(Object[] args, Throwable cause) Recover gracefully from an error.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

RecoverAnnotationRecoveryHandler

public RecoverAnnotationRecoveryHandler(Object target,
                                        Method method)

Method Detail

recover

public T recover(Object[] args,
                 Throwable cause)

Description copied from interface: MethodInvocationRecoverer

Recover gracefully from an error. Clients can call this if processing of the item throws an unexpected exception. Caller can use the return value to decide whether to try more corrective action or perhaps throw an exception.

Specified by:

recover in interface MethodInvocationRecoverer<T>

Parameters:

args - the arguments for the method invocation that failed.

cause - the cause of the failure that led to this recovery.

Returns:

the value to be returned to the caller