|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.util.concurrent
接口 Future<V>
- 类型参数:
-
V
- 此 Future 的 get 方法所返回的结果类型。
- 所有已知子接口:
- ScheduledFuture<V>
- 所有已知实现类:
- FutureTask
-
public interface Future<V>
Future 表示异步计算的结果。它提供了检查计算是否完成的方法,以等待计算的完成,并检索计算的结果。计算完成后只能使用 get 方法来检索结果,如有必要,计算完成前可以阻塞此方法。取消则由 cancel 方法来执行。还提供了其他方法,以确定任务是正常完成还是被取消了。一旦计算完成,就不能再取消计算。如果为了可取消性而使用 Future但又不提供可用的结果,则可以声明 Future<?> 形式类型、并返回 null 作为基础任务的结果。
用法示例(注意,下列各类都是构造好的。)
interface ArchiveSearcher { String search(String target); } class App { ExecutorService executor = ... ArchiveSearcher searcher = ... void showSearch(final String target) throws InterruptedException { Future<String> future = executor.submit(new Callable<String>() { public String call() { return searcher.search(target); } }); displayOtherThings(); // do other things while searching try { displayText(future.get()); // use future } catch (ExecutionException ex) { cleanup(); return; } } }
FutureTask
类是 Future 的一个实现,Future 可实现 Runnable,所以可通过 Executor 来执行。例如,可用下列内容替换上面带有 submit 的构造:
FutureTask<String> future = new FutureTask<String>(new Callable<String>() { public String call() { return searcher.search(target); }}); executor.execute(future);
- 从以下版本开始:
- 1.5
- 另请参见:
-
FutureTask
,Executor
方法摘要 | |
---|---|
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 参数确定是否应该以试图停止任务的方式来中断执行此任务的线程。
-
- 参数:
-
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
- 如果等待超时。
所有类
|
|||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |