org.springframework.batch.repeat.exception
Class RethrowOnThresholdExceptionHandler

java.lang.Object
  org.springframework.batch.repeat.exception.RethrowOnThresholdExceptionHandler

All Implemented Interfaces:

ExceptionHandler

public class RethrowOnThresholdExceptionHandler
extends Object
implements ExceptionHandler

Implementation of ExceptionHandler that rethrows when exceptions of a given type reach a threshold. Requires an ExceptionClassifier that maps exception types to unique keys, and also a map from those keys to threshold values (Integer type).

Author:

Dave Syer

Field Summary

protected org.apache.commons.logging.Log

logger

Constructor Summary

RethrowOnThresholdExceptionHandler()
Set up the exception handler.

Method Summary

void	handleException(RepeatContext context, Throwable throwable) Classify the throwables and decide whether to re-throw based on the result.
void	setExceptionClassifier(ExceptionClassifier exceptionClassifier) Setter for the ExceptionClassifier used by this handler.
void	setThresholds(Map thresholds) A map from classifier keys to a threshold value of type Integer.
void	setUseParent(boolean useParent) Flag to indicate the the exception counters should be shared between sibling contexts in a nested batch.

Methods inherited from class java.lang.Object

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

Field Detail

logger

protected final org.apache.commons.logging.Log logger

Constructor Detail

RethrowOnThresholdExceptionHandler

public RethrowOnThresholdExceptionHandler()

Set up the exception handler. Creates a default exception handler and threshold that maps all exceptions to a threshold of 0 - all exceptions are rethrown by default.

Method Detail

setUseParent

public void setUseParent(boolean useParent)

Flag to indicate the the exception counters should be shared between sibling contexts in a nested batch. Default is false.

Parameters:

useParent - true if the parent context should be used to store the counters.

setThresholds

public void setThresholds(Map thresholds)

A map from classifier keys to a threshold value of type Integer. The keys are usually String literals, depending on the ExceptionClassifier implementation used.

Parameters:

thresholds - the threshold value map.

setExceptionClassifier

public void setExceptionClassifier(ExceptionClassifier exceptionClassifier)

Setter for the ExceptionClassifier used by this handler. The default is to map all throwable instances to ExceptionClassifierSupport.DEFAULT, which are then mapped to a threshold of 0 by the setThresholds(Map) map.

Parameters:

exceptionClassifier -

handleException

public void handleException(RepeatContext context,
                            Throwable throwable)
                     throws Throwable

Classify the throwables and decide whether to re-throw based on the result. The context is used to accumulate the number of exceptions of the same type according to the classifier.

Specified by:

handleException in interface ExceptionHandler

Parameters:

context - the current RepeatContext. Can be used to store state (via attributes), for example to count the number of occurrences of a particular exception type and implement a threshold policy.

throwable - an exception.

Throws:

Throwable

See Also:

ExceptionHandler.handleException(RepeatContext, Throwable)