org.springframework.integration.handler.advice

Class AbstractRequestHandlerAdvice

java.lang.Object

org.springframework.integration.context.IntegrationObjectSupport

org.springframework.integration.handler.advice.AbstractRequestHandlerAdvice

All Implemented Interfaces:

Advice, Interceptor, MethodInterceptor, Aware, BeanFactoryAware, BeanNameAware, InitializingBean, ApplicationContextAware, ExpressionCapable, NamedComponent

Direct Known Subclasses:

ExpressionEvaluatingRequestHandlerAdvice, RequestHandlerCircuitBreakerAdvice, RequestHandlerRetryAdvice

public abstract class AbstractRequestHandlerAdvice
extends IntegrationObjectSupport
implements MethodInterceptor

Base class for MessageHandler advice classes. Subclasses should provide an implementation for doInvoke(ExecutionCallback, Object, Message). Used to advise the handleRequestMessage method for AbstractReplyProducingMessageHandler or MessageHandler.handleMessage(Message) for other message handlers.

Since:

2.2

Author:

Gary Russell, Artem Bilan

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static interface	AbstractRequestHandlerAdvice.ExecutionCallback Called by subclasses in doInvoke() to proceed() the invocation.

Field Summary

Fields

Modifier and Type	Field and Description
protected org.apache.commons.logging.Log	logger

Fields inherited from class org.springframework.integration.context.IntegrationObjectSupport

EXPRESSION_PARSER

Constructor Summary

Constructors

Constructor and Description
AbstractRequestHandlerAdvice()

Method Summary

Modifier and Type	Method and Description
protected abstract Object	doInvoke(AbstractRequestHandlerAdvice.ExecutionCallback callback, Object target, Message<?> message) Subclasses implement this method to apply behavior to the MessageHandler.
Object	invoke(MethodInvocation invocation)
protected Exception	unwrapExceptionIfNecessary(Exception e) Unwrap the cause of a AbstractRequestHandlerAdvice.ThrowableHolderException.
protected Throwable	unwrapThrowableIfNecessary(Exception e) Unwrap the cause of a AbstractRequestHandlerAdvice.ThrowableHolderException.

Methods inherited from class org.springframework.integration.context.IntegrationObjectSupport

afterPropertiesSet, extractTypeIfPossible, getApplicationContext, getApplicationContextId, getBeanFactory, getChannelResolver, getComponentName, getComponentType, getConversionService, getExpression, getIntegrationProperties, getIntegrationProperty, getMessageBuilderFactory, getTaskScheduler, onInit, setApplicationContext, setBeanFactory, setBeanName, setChannelResolver, setComponentName, setConversionService, setMessageBuilderFactory, setPrimaryExpression, setTaskScheduler, toString

Methods inherited from class java.lang.Object

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

Field Detail

logger

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

Constructor Detail

AbstractRequestHandlerAdvice

public AbstractRequestHandlerAdvice()

Method Detail

invoke

public final Object invoke(MethodInvocation invocation)
                    throws Throwable

Specified by:

invoke in interface MethodInterceptor

Throws:

Throwable

doInvoke

protected abstract Object doInvoke(AbstractRequestHandlerAdvice.ExecutionCallback callback,
                                   Object target,
                                   Message<?> message)
                            throws Exception

Subclasses implement this method to apply behavior to the MessageHandler.

callback.execute() invokes the handler method and returns its result, or null.

Parameters:

callback - Subclasses invoke the execute() method on this interface to invoke the handler method.

target - The target handler.

message - The message that will be sent to the handler.

Returns:

the result after invoking the MessageHandler.

Throws:

Exception - Any Exception.

unwrapExceptionIfNecessary

protected Exception unwrapExceptionIfNecessary(Exception e)

Unwrap the cause of a AbstractRequestHandlerAdvice.ThrowableHolderException.

Parameters:

e - The exception.

Returns:

The cause, or e, if not a AbstractRequestHandlerAdvice.ThrowableHolderException

unwrapThrowableIfNecessary

protected Throwable unwrapThrowableIfNecessary(Exception e)

Unwrap the cause of a AbstractRequestHandlerAdvice.ThrowableHolderException.

Parameters:

e - The exception.

Returns:

The cause, or e, if not a AbstractRequestHandlerAdvice.ThrowableHolderException