com.neeve.aep.annotations

Annotation Type EventHandler

@Retention(value=RUNTIME)
public @interface EventHandler

Used to annotate a method that serves as an AEP event handler.

The user should annotate methods that serves as AEP event handlers with this annotation. Upon creation, the AEP engine searches the event handler container objects supplied to the engine constructor for methods that are annotated with this annotation. This annotation can be applied on a method with the following arguments:

• A concrete SMA MessageView as its (only) argument in which case it is treated as a message handler i.e. inbound messages are dispatched to the annotated method
• 2 Arguments: A concrete SMA MessageView as its first argument and an IStoreObject of the same type as returned by a State Replication application's IAepApplicationStateFactory.createState(MessageView) method, in which case it is treated as a message handler that is additionally passed the AEP managed state for the application.
• An IEvent object as its (only) argument in which case the method is treated as the handler for the same event type as the method argument.

All other methods annotated with this annotated are flagged as erroneous annotations and ignored.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
boolean	localOnly Indicates that only events originating locally to the aep should be considered.
String	source

Element Detail

source

public abstract String source

Default:

"*"

localOnly

public abstract boolean localOnly

Indicates that only events originating locally to the aep should be considered. Setting this value to true will ignore messages originating from a message bus, but would include messages injected into an application.

This is currently an experimental feature that is still in incubation. It may be changed or removed in future releases.

Returns:

The event handler is only for locally sourced events.

Default:

false