Future (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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。

方法摘要
`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 - 如果等待超时。