org.springframework.retry.annotation

Class RecoverAnnotationRecoveryHandler<T>

java.lang.Object

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

All Implemented Interfaces:

MethodInvocationRecoverer<T>

public class RecoverAnnotationRecoveryHandler<T>
extends java.lang.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.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	RecoverAnnotationRecoveryHandler.SimpleMetadata

Field Summary

Fields

Modifier and Type	Field and Description
private SubclassClassifier<java.lang.Throwable,java.lang.reflect.Method>	classifier
private java.util.Map<java.lang.reflect.Method,RecoverAnnotationRecoveryHandler.SimpleMetadata>	methods
private java.lang.Object	target

Constructor Summary

Constructors

Constructor and Description
RecoverAnnotationRecoveryHandler(java.lang.Object target, java.lang.reflect.Method method)

Method Summary

Modifier and Type	Method and Description
private int	calculateDistance(java.lang.Class<? extends java.lang.Throwable> cause, java.lang.Class<? extends java.lang.Throwable> type)
private java.lang.reflect.Method	findClosestMatch(java.lang.Class<? extends java.lang.Throwable> cause)
private void	init(java.lang.Object target, java.lang.reflect.Method method)
T	recover(java.lang.Object[] args, java.lang.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

Field Detail

classifier

private SubclassClassifier<java.lang.Throwable,java.lang.reflect.Method> classifier

methods

private java.util.Map<java.lang.reflect.Method,RecoverAnnotationRecoveryHandler.SimpleMetadata> methods

target

private java.lang.Object target

Constructor Detail

RecoverAnnotationRecoveryHandler

public RecoverAnnotationRecoveryHandler(java.lang.Object target,
                                        java.lang.reflect.Method method)

Method Detail

recover

public T recover(java.lang.Object[] args,
                 java.lang.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

findClosestMatch

private java.lang.reflect.Method findClosestMatch(java.lang.Class<? extends java.lang.Throwable> cause)

calculateDistance

private int calculateDistance(java.lang.Class<? extends java.lang.Throwable> cause,
                              java.lang.Class<? extends java.lang.Throwable> type)

init

private void init(java.lang.Object target,
                  java.lang.reflect.Method method)