Module io.helidon.nima.faulttolerance
Package io.helidon.nima.faulttolerance

Interface Async

public interface Async
Runs synchronous suppliers asynchronously using virtual threads. Includes convenient static method to avoid creating instances of this class.

  • Method Details

    • invoke

      <T> CompletableFuture<T> invoke(Supplier<T> supplier)
      Invoke a synchronous operation asynchronously. This method never throws an exception. Any exception is returned via the CompletableFuture result.
      Type Parameters:
      T - type of returned value
      Parameters:
      supplier - supplier of value (or a method reference)
      Returns:
      a Single that is a "promise" of the future result

    • create

      static Async create()
      Async with default executor service.
      Returns:
      a default async instance

    • invokeStatic

      static <T> CompletableFuture<T> invokeStatic(Supplier<T> supplier)
      Convenience method to avoid having to call create().
      Type Parameters:
      T - type of returned value
      Parameters:
      supplier - supplier of value (or a method reference)
      Returns:
      a Single that is a "promise" of the future result

    • invokeStatic

      static <T> CompletableFuture<T> invokeStatic(Supplier<T> supplier, CompletableFuture<Async> onStart)
      Convenience method to avoid having to call create(). Also accepts an onStart future to inform of async task startup.
      Type Parameters:
      T - type of returned value
      Parameters:
      supplier - supplier of value (or a method reference)
      onStart - future completed when async task starts
      Returns:
      a future that is a "promise" of the future result

    • builder

      static Async.Builder builder()
      A new builder to build a customized Async instance.
      Returns:
      a new builder