org.infinispan.remoting.inboundhandler.action.Action Maven / Gradle / Ivy

Go to download
package org.infinispan.remoting.inboundhandler.action;

/**
 * An action represents a step in {@link org.infinispan.remoting.inboundhandler.PerCacheInboundInvocationHandler}.
 *
 * @author Pedro Ruivo
 * @since 8.0
 */
public interface Action {

   /**
    * It checks this action.
    * 
    * When {@link ActionStatus#READY} or {@link ActionStatus#CANCELED} are final states.
    * 
    * This method should be thread safe and idempotent since it can be invoked multiple times by multiples threads.
    *
    * @param state the current state.
    * @return the status of this action.
    */
   ActionStatus check(ActionState state);

   /**
    * Adds a listener to be invoked when this action is ready or canceled.
    *
    * @param listener the {@link ActionListener} to add.
    */
   void addListener(ActionListener listener);

   /**
    * Cleanups when it is no longer needed.
    * @param state
    */
   void cleanup(ActionState state);
}