org.axonframework.eventhandling

Interface EventHandlerInvoker

All Known Implementing Classes:

AbstractSagaManager, AnnotatedSagaManager, MultiEventHandlerInvoker, SimpleEventHandlerInvoker

public interface EventHandlerInvoker

Interface for an event message handler that defers handling to one or more other handlers.

Author:

Rene de Waele

Method Summary

Modifier and Type	Method and Description
boolean	canHandle(EventMessage<?> eventMessage, Segment segment) Check whether or not this invoker has handlers that can handle the given eventMessage for a given segment.
default void	handle(EventMessage<?> message) Deprecated. Callers should use handle(EventMessage, Segment) instead
void	handle(EventMessage<?> message, Segment segment) Handle the given message for the given segment.
default void	performReset() Performs any activities that are required to reset the state managed by handlers assigned to this invoker.
default boolean	supportsReset() Indicates whether the handlers managed by this invoker support a reset.

Method Detail

canHandle

boolean canHandle(EventMessage<?> eventMessage,
                  Segment segment)

Check whether or not this invoker has handlers that can handle the given eventMessage for a given segment.

Parameters:

eventMessage - The message to be processed

segment - The segment for which the event handler should be invoked

Returns:

true if the invoker has one or more handlers that can handle the given message, false otherwise

handle

@Deprecated
default void handle(EventMessage<?> message)
                          throws Exception

Deprecated. Callers should use handle(EventMessage, Segment) instead

Handle the given message, regardless of any Segmentation of processing.

Parameters:

message - The message to handle

Throws:

Exception - when an exception occurs while handling the message

handle

void handle(EventMessage<?> message,
            Segment segment)
     throws Exception

Handle the given message for the given segment.

Callers are recommended to invoke canHandle(EventMessage, Segment) prior to invocation, but aren't required to do so. Implementations must ensure to take the given segment into account when processing messages.

Parameters:

message - The message to handle

segment - The segment for which to handle the message

Throws:

Exception - when an exception occurs while handling the message

supportsReset

default boolean supportsReset()

Indicates whether the handlers managed by this invoker support a reset.

Returns:

true if a reset is supported, otherwise false

performReset

default void performReset()

Performs any activities that are required to reset the state managed by handlers assigned to this invoker.