Package de.quantummaid.eventmaid.messageBus.exception

Interface MessageBusExceptionHandler

All Known Implementing Classes:

ErrorListenerDelegatingMessageBusExceptionHandler, ErrorThrowingMessageBusExceptionHandler

public interface MessageBusExceptionHandler

Whenever an Exception occurs during the delivering of a message on a MessageBus, the MessageBusExceptionHandler is invoked with the message and the exception.

See Also:

EventMaid Documentation

Method Summary

Modifier and Type	Method	Description
default void	callTemporaryExceptionListener(ProcessingContext<Object> message, Exception e, List<MessageBusExceptionListener> listeners)	For each exception, this method is responsible to call the dynamically added MessageBusExceptionListener.
void	handleDeliveryChannelException(ProcessingContext<Object> message, Exception e, Channel<Object> channel)	For each Exception thrown inside a Subscriber, for which MessageBusExceptionHandler.shouldDeliveryChannelErrorBeHandledAndDeliveryAborted returned true, this method is invoked.
void	handleFilterException(ProcessingContext<Object> message, Exception e, Channel<Object> channel)	When a Exception inside a Filter is thrown, this method is invoked.
boolean	shouldDeliveryChannelErrorBeHandledAndDeliveryAborted(ProcessingContext<Object> message, Exception e, Channel<Object> channel)	In some cases, an Exception during the delivery to a Subscriber should be ignored, so that the delivery is not stopped.

Method Detail

shouldDeliveryChannelErrorBeHandledAndDeliveryAborted

boolean shouldDeliveryChannelErrorBeHandledAndDeliveryAborted(ProcessingContext<Object> message,
                                                              Exception e,
                                                              Channel<Object> channel)

In some cases, an Exception during the delivery to a Subscriber should be ignored, so that the delivery is not stopped. Therefore for each exception during the delivery this method is invoked. If true is returned, the delivery stopped, the MessageBusExceptionHandler.handleDeliveryChannelException method is invoked and the message is marked as failed in ChannelStatistics. If false is returned, the exception is ignored and the delivery continues.

Parameters:

message - the message for which the Exception was thrown

e - the raised Exception

channel - the EventType specific channel, in which the message was delivered

Returns:

true if the exception should be handled, false otherwise

handleDeliveryChannelException

void handleDeliveryChannelException(ProcessingContext<Object> message,
                                    Exception e,
                                    Channel<Object> channel)

For each Exception thrown inside a Subscriber, for which MessageBusExceptionHandler.shouldDeliveryChannelErrorBeHandledAndDeliveryAborted returned true, this method is invoked.

Parameters:

message - the message, which caused the Exception

e - the raised Exception

channel - the delivery Channel

handleFilterException

void handleFilterException(ProcessingContext<Object> message,
                           Exception e,
                           Channel<Object> channel)

When a Exception inside a Filter is thrown, this method is invoked.

Parameters:

message - the message that caused the Exception

e - the raised Exception

channel - the accepting Channel

callTemporaryExceptionListener

default void callTemporaryExceptionListener(ProcessingContext<Object> message,
                                            Exception e,
                                            List<MessageBusExceptionListener> listeners)

For each exception, this method is responsible to call the dynamically added MessageBusExceptionListener.

Parameters:

message - the message that caused the Exception

e - the raised Exception

listeners - all interested MessageBusExceptionListener