io.spine.server.log

Interface HandlerLifecycle

All Known Implementing Classes:

AbstractEntity, Aggregate, AggregatePart, CommandHandlingEntity, ProcessManager, Projection, TransactionalEntity

public interface HandlerLifecycle

Callbacks for a HandlerMethod invocation.

If the target of the method implements HandlerLifecycle, it is invoked alongside handler method. For example:

 class SignUpSubscriber extends AbstractEventSubscriber implements HandlerLifecycle {

     @Subscribe
     void on(UserSignedUp event) {
         // ...
     }

     @Override
     public void beforeInvoke(HandlerMethod method) {
         // ...
     }

     @Override
     public void afterInvoke(HandlerMethod method) {
         // ...
     }
 }
 

When a UserSignedUp event is dispatched to the SignUpSubscriber, the invocation order goes as follows:

1. beforeInvoke([instance representing on(UserSignedUp) method]).
2. on(UserSignedUp).
3. afterInvoke([instance representing on(UserSignedUp) method]).

Method Summary

Modifier and Type	Method and Description
void	afterInvoke(HandlerMethod<?,?,?,?> method) A callback for a handler method invocation end.
void	beforeInvoke(HandlerMethod<?,?,?,?> method) A callback for a handler method invocation start.

Method Detail

beforeInvoke

void beforeInvoke(HandlerMethod<?,?,?,?> method)

A callback for a handler method invocation start.

The handler method is invoked immediately after this method.

afterInvoke

void afterInvoke(HandlerMethod<?,?,?,?> method)

A callback for a handler method invocation end.

This method is invoked immediately after the handler method, even if it has thrown an exception.