Future 表示异步计算的结果。它提供了检查计算是否完成的方法,以等待计算的完成,并获取计算的结果。计算完成后只能使用get 方法来获取结果,如有必要,计算完成前可以阻塞此方法。取消则由 cancel 方法来执行。还提供了其他方法,以确定任务是正常完成还是被取消了。一旦计算完成,就不能再取消计算。如果为了可取消性而使用Future 但又不提供可用的结果,则可以声明Future<?> 形式类型、并返回null 作为底层任务的结果。
方法摘要 | |
---|---|
boolean | cancel(boolean mayInterruptIfRunning) 试图取消对此任务的执行。 |
V | get() 如有必要,等待计算完成,然后获取其结果。 |
V | get(long timeout, TimeUnit unit) 如有必要,最多等待为使计算完成所给定的时间之后,获取其结果(如果结果可用)。 |
boolean | isCancelled() 如果在任务正常完成前将其取消,则返回 true。 |
boolean | isDone() 如果任务已完成,则返回 true。 |
方法详细信息 |
---|
cancel
boolean cancel(boolean mayInterruptIfRunning)
-
试图取消对此任务的执行。如果任务已完成、或已取消,或者由于某些其他原因而无法取消,则此尝试将失败。当调用
cancel 时,如果调用成功,而此任务尚未启动,则此任务将永不运行。如果任务已经启动,则
mayInterruptIfRunning 参数确定是否应该以试图停止任务的方式来中断执行此任务的线程。
此方法返回后,对
isDone()
的后续调用将始终返回 true。如果此方法返回true,则对isCancelled()
的后续调用将始终返回 true。 -
-
参数:
-
mayInterruptIfRunning
- 如果应该中断执行此任务的线程,则为 true;否则允许正在运行的任务运行完成
返回:
- 如果无法取消任务,则返回 false,这通常是由于它已经正常完成;否则返回 true
-
isCancelled
boolean isCancelled()
- 如果在任务正常完成前将其取消,则返回 true。
-
-
返回:
- 如果任务完成前将其取消,则返回 true
isDone
boolean isDone()
- 如果任务已完成,则返回 true。 可能由于正常终止、异常或取消而完成,在所有这些情况中,此方法都将返回 true。
-
-
返回:
- 如果任务已完成,则返回 true
get
V get() throws InterruptedException, ExecutionException
- 如有必要,等待计算完成,然后获取其结果。
-
-
返回:
- 计算的结果 抛出:
-
CancellationException
- 如果计算被取消 -
ExecutionException
- 如果计算抛出异常 -
InterruptedException
- 如果当前的线程在等待时被中断
get
V get(long timeout, TimeUnit unit) throws InterruptedException, ExecutionException, TimeoutException
- 如有必要,最多等待为使计算完成所给定的时间之后,获取其结果(如果结果可用)。
-
-
参数:
-
timeout
- 等待的最大时间 -
unit
- timeout 参数的时间单位
返回:
- 计算的结果 抛出:
-
CancellationException
- 如果计算被取消 -
ExecutionException
- 如果计算抛出异常 -
InterruptedException
- 如果当前的线程在等待时被中断 -
TimeoutException
- 如果等待超时
-