Interface Callback

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static Callback NOOP
      Instance of Adapter that can be used when the callback methods need an empty implementation without incurring in the cost of allocating a new Adapter object.
    • Method Summary

      All Methods Static Methods Instance Methods Default Methods 
      Modifier and Type Method Description
      static Callback combine​(Callback cb1, Callback cb2)  
      default void failed​(java.lang.Throwable x)
      Callback invoked when the operation fails.
      static Callback from​(java.lang.Runnable completed)
      Creaste a callback that runs completed when it succeeds or fails
      static Callback from​(java.lang.Runnable success, java.util.function.Consumer<java.lang.Throwable> failure)
      Creates a callback from the given success and failure lambdas.
      static Callback from​(java.lang.Runnable completed, Callback callback)
      Create a nested callback that runs completed before completing the nested callback.
      static Callback from​(java.util.concurrent.CompletableFuture<?> completable)
      Creates a non-blocking callback from the given incomplete CompletableFuture.
      static Callback from​(java.util.concurrent.CompletableFuture<?> completable, Invocable.InvocationType invocation)
      Creates a callback from the given incomplete CompletableFuture, with the given blocking characteristic.
      static Callback from​(Callback callback, java.lang.Runnable completed)
      Create a nested callback that runs completed after completing the nested callback.
      static Callback from​(Invocable.InvocationType invocationType, java.lang.Runnable success, java.util.function.Consumer<java.lang.Throwable> failure)
      Creates a callback with the given InvocationType from the given success and failure lambdas.
      default void succeeded()
      Callback invoked when the operation completes.
    • Field Detail

      • NOOP

        static final Callback NOOP
        Instance of Adapter that can be used when the callback methods need an empty implementation without incurring in the cost of allocating a new Adapter object.
    • Method Detail

      • succeeded

        default void succeeded()

        Callback invoked when the operation completes.

        See Also:
        failed(Throwable)
      • failed

        default void failed​(java.lang.Throwable x)

        Callback invoked when the operation fails.

        Parameters:
        x - the reason for the operation failure
      • from

        static Callback from​(java.util.concurrent.CompletableFuture<?> completable)

        Creates a non-blocking callback from the given incomplete CompletableFuture.

        When the callback completes, either succeeding or failing, the CompletableFuture is also completed, respectively via CompletableFuture.complete(Object) or CompletableFuture.completeExceptionally(Throwable).

        Parameters:
        completable - the CompletableFuture to convert into a callback
        Returns:
        a callback that when completed, completes the given CompletableFuture
      • from

        static Callback from​(java.util.concurrent.CompletableFuture<?> completable,
                             Invocable.InvocationType invocation)

        Creates a callback from the given incomplete CompletableFuture, with the given blocking characteristic.

        Parameters:
        completable - the CompletableFuture to convert into a callback
        invocation - whether the callback is blocking
        Returns:
        a callback that when completed, completes the given CompletableFuture
      • from

        static Callback from​(java.lang.Runnable success,
                             java.util.function.Consumer<java.lang.Throwable> failure)
        Creates a callback from the given success and failure lambdas.
        Parameters:
        success - Called when the callback succeeds
        failure - Called when the callback fails
        Returns:
        a new Callback
      • from

        static Callback from​(Invocable.InvocationType invocationType,
                             java.lang.Runnable success,
                             java.util.function.Consumer<java.lang.Throwable> failure)
        Creates a callback with the given InvocationType from the given success and failure lambdas.
        Parameters:
        invocationType - the Callback invocation type
        success - Called when the callback succeeds
        failure - Called when the callback fails
        Returns:
        a new Callback
      • from

        static Callback from​(java.lang.Runnable completed)
        Creaste a callback that runs completed when it succeeds or fails
        Parameters:
        completed - The completion to run on success or failure
        Returns:
        a new callback
      • from

        static Callback from​(Callback callback,
                             java.lang.Runnable completed)
        Create a nested callback that runs completed after completing the nested callback.
        Parameters:
        callback - The nested callback
        completed - The completion to run after the nested callback is completed
        Returns:
        a new callback.
      • from

        static Callback from​(java.lang.Runnable completed,
                             Callback callback)
        Create a nested callback that runs completed before completing the nested callback.
        Parameters:
        callback - The nested callback
        completed - The completion to run before the nested callback is completed. Any exceptions thrown from completed will result in a callback failure.
        Returns:
        a new callback.