Package org.infinispan.interceptors

Class InvocationStage

  • Direct Known Subclasses:
    SyncInvocationStage
    public abstract class InvocationStage
extends java.lang.Object
    A partial command invocation, either completed or in progress.

    It is similar to a CompletionStage, but it allows more callback functions to be stateless by passing the context and the invoked command as parameters.

    Unlike CompletionStage, adding a callback can delay the completion of the initial stage and change its result.

    Since:
    9.0
    Author:
    Dan Berindei

    • Constructor Detail

      • InvocationStage

        public InvocationStage()

    • Method Detail

      • get

        public abstract java.lang.Object get()
                              throws java.lang.Throwable
        Wait for the invocation to complete and return its value.
        Throws:
        java.lang.Throwable - Any exception raised during the invocation.

      • isDone

        public abstract boolean isDone()
        Returns:
        true if the invocation is complete.

      • toCompletableFuture

        public abstract java.util.concurrent.CompletableFuture<java.lang.Object> toCompletableFuture()
        CompletableFuture conversion.

      • thenApply

        public java.lang.Object thenApply​(InvocationContext ctx,
                                  org.infinispan.commands.VisitableCommand command,
                                  InvocationSuccessFunction function)
        After the current stage completes successfully, invoke function and return its result.

        The result may be either a plain value, this, or a new InvocationStage. If function throws an exception, the result InvocationStage will complete with the same exception.

      • thenAccept

        public java.lang.Object thenAccept​(InvocationContext ctx,
                                   org.infinispan.commands.VisitableCommand command,
                                   InvocationSuccessAction action)
        After the current stage completes successfully, invoke action.

        The result may be either a plain value, this, or a new InvocationStage. If action throws an exception, the result InvocationStage will complete with the same exception.

      • andExceptionally

        public java.lang.Object andExceptionally​(InvocationContext ctx,
                                         org.infinispan.commands.VisitableCommand command,
                                         InvocationExceptionFunction function)
        After the current stage completes exceptionally, invoke function and return its result.

        The result may be either a plain value, this, or a new InvocationStage. If function throws an exception, the result InvocationStage will complete with the same exception.

      • andFinally

        public java.lang.Object andFinally​(InvocationContext ctx,
                                   org.infinispan.commands.VisitableCommand command,
                                   InvocationFinallyAction action)
        After the current stage completes, invoke action.

        The result may be either a plain value, this, or a new InvocationStage. If action throws an exception, the result InvocationStage will complete with the same exception.

      • andHandle

        public java.lang.Object andHandle​(InvocationContext ctx,
                                  org.infinispan.commands.VisitableCommand command,
                                  InvocationFinallyFunction function)
        After the current stage completes, invoke function and return its result.

        The result may be either a plain value, this, or a new InvocationStage. If function throws an exception, the result InvocationStage will complete with the same exception.

      • addCallback

        public abstract java.lang.Object addCallback​(InvocationContext ctx,
                                             org.infinispan.commands.VisitableCommand command,
                                             InvocationCallback function)
        After the current stage completes, invoke function and return its result.

        The result may be either a plain value, or a new InvocationStage. If function throws an exception, the result InvocationStage will complete with the same exception.

      • makeStage

        public static InvocationStage makeStage​(java.lang.Object maybeStage)
        If maybeStage is not an InvocationStage, wrap it, otherwise cast it to an InvocationStage.

      • completedNullStage

        public static InvocationStage completedNullStage()
        Returns:
        an InvocationStage instance completed successfully with value null.