compact1, compact2, compact3

java.util.concurrent

Interface Future<V>

参数类型

V -结果类型返回这个未来的 get方法

All Known Subinterfaces:

Response ， RunnableFuture ， RunnableScheduledFuture ， ScheduledFuture

所有已知实现类：

CompletableFuture， CountedCompleter， ForkJoinTask， FutureTask， RecursiveAction， RecursiveTask， SwingWorker

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实现 Runnable实现，所以可以通过一个 Executor执行。例如，与 submit以上建设可以改成：

 FutureTask<String> future =
   new FutureTask<String>(new Callable<String>() {
     public String call() {
       return searcher.search(target);
   }});
 executor.execute(future);

内存一致性效果：通过异步计算 happen-before行动后，在另一个线程对应的Future.get()采取行动。

从以下版本开始：

一点五

另请参见：

FutureTask， Executor

方法摘要

Modifier and Type	Method and Description
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。随后调用isCancelled()永远如果这个方法返回的返回true 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如果等待超时