程序包 cn.taketoday.core.task

接口 AsyncTaskExecutor

所有超级接口:
Executor, TaskExecutor
所有已知子接口:
AsyncListenableTaskExecutor
所有已知实现类:
SimpleAsyncTaskExecutor, TaskExecutorAdapter, VirtualThreadTaskExecutor
public interface AsyncTaskExecutor extends TaskExecutor
Extended interface for asynchronous TaskExecutor implementations, offering support for Callable.

Note: The Executors class includes a set of methods that can convert some other common closure-like objects, for example, PrivilegedAction to Callable before executing them.

Implementing this interface also indicates that the TaskExecutor.execute(Runnable) method will not execute its Runnable in the caller's thread but rather asynchronously in some other thread.

从以下版本开始:
4.0
作者:
Juergen Hoeller, Harry Yang
另请参阅:

  • 字段概要

    字段
    修饰符和类型
    字段
    说明
    static final long
    TIMEOUT_IMMEDIATE
    Constant that indicates immediate execution.
    static final long
    TIMEOUT_INDEFINITE
    Constant that indicates no time limit.

  • 方法概要

    修饰符和类型
    方法
    说明
    default void
    execute(Runnable task, long startTimeout)
    Execute the given task.
    default Future<?>
    submit(Runnable task)
    Submit a Runnable task for execution, receiving a Future representing that task.
    default <T> Future<T>
    submit(Callable<T> task)
    Submit a Callable task for execution, receiving a Future representing that task.
    default CompletableFuture<Void>
    submitCompletable(Runnable task)
    Submit a Runnable task for execution, receiving a CompletableFuture representing that task.
    default <T> CompletableFuture<T>
    submitCompletable(Callable<T> task)
    Submit a Callable task for execution, receiving a CompletableFuture representing that task.

    从接口继承的方法 cn.taketoday.core.task.TaskExecutor

    execute

  • 字段详细资料

    • TIMEOUT_IMMEDIATE

      static final long TIMEOUT_IMMEDIATE
      Constant that indicates immediate execution.
      另请参阅:

    • TIMEOUT_INDEFINITE

      static final long TIMEOUT_INDEFINITE
      Constant that indicates no time limit.
      另请参阅:

  • 方法详细资料

    • execute

      default void execute(Runnable task, long startTimeout)
      Execute the given task.
      参数:
      task - the Runnable to execute (never null)
      startTimeout - the time duration (milliseconds) within which the task is supposed to start. This is intended as a hint to the executor, allowing for preferred handling of immediate tasks. Typical values are TIMEOUT_IMMEDIATE or TIMEOUT_INDEFINITE (the default as used by TaskExecutor.execute(Runnable)).
      抛出:
      TaskTimeoutException - in case of the task being rejected because of the timeout (i.e. it cannot be started in time)
      TaskRejectedException - if the given task was not accepted

    • submit

      default Future<?> submit(Runnable task)
      Submit a Runnable task for execution, receiving a Future representing that task. The Future will return a null result upon completion.

      this method comes with a default implementation that delegates to TaskExecutor.execute(Runnable).

      参数:
      task - the Runnable to execute (never null)
      返回:
      a Future representing pending completion of the task
      抛出:
      TaskRejectedException - if the given task was not accepted

    • submit

      default <T> Future<T> submit(Callable<T> task)
      Submit a Callable task for execution, receiving a Future representing that task. The Future will return the Callable's result upon completion.

      this method comes with a default implementation that delegates to TaskExecutor.execute(Runnable).

      参数:
      task - the Callable to execute (never null)
      返回:
      a Future representing pending completion of the task
      抛出:
      TaskRejectedException - if the given task was not accepted

    • submitCompletable

      default CompletableFuture<Void> submitCompletable(Runnable task)
      Submit a Runnable task for execution, receiving a CompletableFuture representing that task. The Future will return a null result upon completion.
      参数:
      task - the Runnable to execute (never null)
      返回:
      a CompletableFuture representing pending completion of the task
      抛出:
      TaskRejectedException - if the given task was not accepted

    • submitCompletable

      default <T> CompletableFuture<T> submitCompletable(Callable<T> task)
      Submit a Callable task for execution, receiving a CompletableFuture representing that task. The Future will return the Callable's result upon completion.
      参数:
      task - the Callable to execute (never null)
      返回:
      a CompletableFuture representing pending completion of the task
      抛出:
      TaskRejectedException - if the given task was not accepted